# Отмена платежа

Если транзакция была отклонена платежной системой, Xsolla присылает детали 
транзакции в вебхуке с типом ps_declined на URL-адрес вебхука. Вебхук 
отправляется на этапе авторизации или обработки платежа. Вебхук 
payment\ order_paid при этом отправлен не будет.

Типичные причины отклонения транзакции платежной системой:

* Авторизация карты не удалась (пример: платежная система не смогла завершить 
  процесс авторизации из-за технического сбоя или отсутствия ответа от банка) или 
  была отклонена (пример: банк ответил, но отказал в операции из-за недостатка 
  средств или неверных данных карты).
* Проверка 3-D Secure не удалась, не была завершена или истекло время ожидания 
  подтверждения пользователем.
* Процессор или банк-эквайер временно недоступен или возвращает жесткий отказ 
  (hard decline) из-за необратимой ошибки: например, закрытого счета или 
  недействительного номера карты. Повторная попытка без устранения причины ошибки 
  не приведет к успешному результату.

Следует отличать:

* От отклонений транзакции со стороны антифрод-системы, информация о которых 
  передается в вебхуке 
  afs_reject.
* Возврата и частичного возврата платежа после успешной оплаты, информация о 
  котором передается в вебхуках 
  refund и 
  partial_refund.


Примечание
Чтобы получать вебхук ps_declined, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

Endpoint: POST payment-declined
Version: 1.0

## Request fields (application/json):

  - `notification_type` (string, required)
    Тип оповещения.

  - `refund_details` (object)
    Объект с финансовыми данными рефанда.

  - `refund_details.author` (string)
    Инициатор возврата платежа. Значение поля передается согласно таблице:


    
    
        Инициатор возврата
        Значение поля
    
    
    
    
        Игра (через API).
        API
    
    
        Пользователь Личного кабинета (автоматический возврат).
        Email-адрес пользователя
    
    
        Пользователь Личного кабинета (при участии службы поддержки Xsolla).
        support@xsolla.com
    
    
        Xsolla (при участии службы поддержки Xsolla).
        support@xsolla.com

  - `refund_details.code` (integer)
    ID кода.

  - `refund_details.reason` (string)
    Причина отмены.

  - `settings` (object)
    Объект, содержащий настройки проекта.

  - `settings.merchant_id` (integer)
    ID продавца.

  - `settings.project_id` (integer)
    ID проекта. Вы можете найти этот параметр в [Личном кабинете](https://publisher.xsolla.com/) рядом с названием проекта.

  - `transaction` (object, required)
    Объект с информацией о транзакции, связанной с этой операцией.

  - `transaction.dry_run` (integer)
    Признак тестовой транзакции. Значение параметра равно 1 для тестового платежа, для реального платежа параметр не передается.

  - `transaction.external_id` (string)
    Внешний ID транзакции.

  - `transaction.id` (integer)
    ID транзакции.

  - `transaction.payment_method` (integer)
    ID способа оплаты.

  - `user` (object)
    Объект с информацией о пользователе.

  - `user.country` (string)
    Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.email` (string)
    Email пользователя.

  - `user.id` (string, required)
    ID пользователя.

  - `user.ip` (string)
    IP адрес пользователя.

  - `user.name` (string)
    Имя пользователя.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields