# Успешный платеж

Когда пользователь успешно совершает оплату, Xsolla отправляет детали платежа в 
вебхуке с типом payment на URL-адрес вебхука.

Ожидаемые коды ответов описаны в разделе Responses, но вы можете 
использовать и другие коды:


    
    
        Код ответа
        Описание
    
    
    
    
        200, 201, 204
        Успешный ответ.
    
    
        4xx
        Возникновение ошибки. Например, если указанный пользователь не был найден или если передана недействительная подпись.
    
    
        5xx
        Временная ошибка на сервере. При получении этого ответа Xsolla отправляет вебхук повторно с увеличенным интервалом, пока ваш обработчик не подтвердит их получение. Максимальное количество попыток — 12 в течение 48 часов.
    
    


После сохранения URL-адреса вебхука в аккаунте вы можете настроить получение дополнительной информации в вебхуке.


Примечание
Если вы зарегистрировались в Личном кабинете до 22 января 2025 г. (включительно), переключатели располагаются в вашем проекте в разделе Настройки > Вебхуки > Тестирование > Payments > Расширенные настройки
 .




    
        Переключатель
        Описание
    


    
        Показывать информацию о сохраненном платежном аккаунте
        Информация о сохраненном способе оплаты передается в кастомном объекте payment_account.
    
    
        Показывать информацию о транзакциях сохраненными способами оплаты
        В вебхуке будет передаваться информация в кастомных параметрах:saved_payment_method:0 — сохраненный способ оплаты не используется;1 — способ оплаты был сохранен при совершении текущей транзакции;2 — используется ранее сохраненный способ оплаты.payment_type:1 — единоразовый платеж;2 — рекуррентный платеж.
    
    
        Добавить объект order в вебхук
        В вебхуке Успешный платеж будет передаваться информация о заказе в объекте order.
    
    
        Показывать только необходимую информацию о пользователе без чувствительных данных
        В вебхуке о пользователе будет передаваться только следующая информация:ID;страна.
    
    
        Показывать БИН карты и последние 4 цифры ее номера
        В вебхуке будет передаваться следующая информация о номере карты:первые 6 цифр в параметре card_bin;последние 4 цифры в параметре card_suffix.
    
    
        Показывать бренд карты
        Бренд карты, с которой была совершена оплата. Например, Mastercard или Visa.
    
    
        Показать региональный налог у источника и стоимость каналов привлечения трафика.
        В вебхуке будут передаваться объекты payment_details.​country_wht и payment_details.​user_acquisition_fee. По умолчанию этот переключатель активирован.
    
    
        Отправлять информацию о 3DS.
        В вебхуке будет передаваться объект cards с данными о прохождении пользователем проверки 3-D Secure.
    




Внимание
Набор полей, отправляемых в вебхуке, зависит:от расширенных настроек, которые вы установили в аккаунте;кастомных настроек, которые были заданы на стороне Xsolla.При возникновении вопросов обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

Endpoint: POST payment
Version: 1.0

## Request fields (application/json):

  - `custom_parameters` (object)
    Ваши дополнительные параметры.

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

  - `payment_details` (object, required)
    Объект с финансовыми данными платежа.

  - `payment_details.country_wht` (object)
    Объект с данными о дополнительных издержках при международных транзакциях в некоторых странах.

  - `payment_details.country_wht.amount` (number)
    Сумма.

  - `payment_details.country_wht.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.country_wht.percent` (number)
    Размер дополнительных издержек, в процентах.

  - `payment_details.direct_wht` (object)
    Налог, удерживаемый у источника выплаты.

  - `payment_details.direct_wht.amount` (number)
    Сумма.

  - `payment_details.direct_wht.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.direct_wht.percent` (number)
    Процент налога, удерживаемого у источника выплаты.

  - `payment_details.payment` (object)
    Объект с данными о сумме, которую оплатил пользователь.

  - `payment_details.payment.amount` (number)
    Сумма.

  - `payment_details.payment.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_fee` (object)
    Размер комиссии платежной системы.

  - `payment_details.payment_method_fee.amount` (number)
    Сумма.

  - `payment_details.payment_method_fee.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_sum` (object)
    Объект с данными о сумме, которая была оплачена из платежной системы.

  - `payment_details.payment_method_sum.amount` (number)
    Сумма.

  - `payment_details.payment_method_sum.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payout` (object)
    Объект с данными о сумме выплаты.

  - `payment_details.payout.amount` (number)
    Сумма.

  - `payment_details.payout.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payout_currency_rate` (string)
    Курс валюты платежа к валюте выплаты.

  - `payment_details.repatriation_commission` (object)
    Объект с информацией о затратах на репатриацию, возлагаемых на Xsolla третьими сторонами.

  - `payment_details.repatriation_commission.amount` (number)
    Сумма.

  - `payment_details.repatriation_commission.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax` (object)
    Размер налога (только для США и Канады).

  - `payment_details.sales_tax.amount` (number)
    Сумма.

  - `payment_details.sales_tax.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax.percent` (number)
    Процент налога.

  - `payment_details.user_acquisition_fee` (object)
    Объект с данными о сумме вознаграждения каналов привлечения трафика (аффилированные сети и инфлюенсеры).

  - `payment_details.user_acquisition_fee.amount` (number)
    Сумма.

  - `payment_details.user_acquisition_fee.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.user_acquisition_fee.percent` (number)
    Ставка вознаграждения за привлечение пользователей, %.

  - `payment_details.vat` (object)
    Размер VAT (только для Евросоюза).

  - `payment_details.vat.amount` (number)
    Сумма.

  - `payment_details.vat.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.vat.percent` (number)
    Процент VAT.

  - `payment_details.xsolla_balance_sum` (object)
    Объект с данными о сумме, которая была оплачена с Xsolla-баланса.

  - `payment_details.xsolla_balance_sum.amount` (number)
    Сумма.

  - `payment_details.xsolla_balance_sum.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.xsolla_fee` (object)
    Размер комиссии Xsolla.

  - `payment_details.xsolla_fee.amount` (number)
    Сумма.

  - `payment_details.xsolla_fee.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase` (object)
    Объект с информацией о заказе.

  - `purchase.checkout` (object)
    Объект с информацией о заказе.

  - `purchase.checkout.amount` (number)
    Сумма заказа.

  - `purchase.checkout.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

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

  - `purchase.coupon.campaign_code` (string)
    Код кампании купонов.

  - `purchase.coupon.coupon_code` (string)
    Код купона.

  - `purchase.gift` (object)
    Объект с информацией о подарке.

  - `purchase.gift.giver_id` (string)
    ID дарителя.

  - `purchase.gift.hide_giver_from_receiver` (string)
    Флаг, показывать ли дарителя получателю подарка.

  - `purchase.gift.message` (string)
    Сообщение от дарителя.

  - `purchase.gift.receiver_email` (string)
    Email получателя подарка.

  - `purchase.gift.receiver_id` (string)
    ID получателя подарка.

  - `purchase.order` (object)
    Объект с информацией о заказе. Чтобы получать эту информацию, в [аккаунте](/ru/webhooks/overview/#business-accounts) в разделе Настройки > Вебхуки > Расширенные настройки активируйте переключатель Добавить объект order в вебхук.

  - `purchase.order.id` (integer)
    Идентификатор заказа.

  - `purchase.order.lineitems` (array)
    Массив с параметрами, которые содержат информацию о товарах.

  - `purchase.order.lineitems.price` (object)
    Объект с информацией о цене товара.

  - `purchase.order.lineitems.price.amount` (number)
    Общая стоимость товара в валюте.

  - `purchase.order.lineitems.price.currency` (string)
    Валюта, в которой указана цена товара.

  - `purchase.order.lineitems.quantity` (integer)
    Количество этого предмета в заказе.

  - `purchase.order.lineitems.sku` (string)
    Артикул предмета.

  - `purchase.promotions` (array)
    Массив с данными акций, которые действуют на данную покупку.

  - `purchase.promotions.id` (integer)
    ID акции.

  - `purchase.promotions.technical_name` (string)
    Техническое название акции.

  - `purchase.subscription` (object)
    Объект с данными о подписке.

  - `purchase.subscription.amount` (number)
    Сумма покупки.

  - `purchase.subscription.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.subscription.date_create` (string)
    Дата создания подписки. Дата и время согласно стандарту [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `purchase.subscription.date_next_charge` (string)
    Дата следующего списания. Дата и время согласно стандарту [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `purchase.subscription.plan_id` (string)
    ID плана (внешний id, если план был создан через API).

  - `purchase.subscription.product_id` (string)
    ID продукта (если был отправлен в токене).

  - `purchase.subscription.subscription_id` (integer)
    ID подписки в базе данных Xsolla.

  - `purchase.subscription.tags` (array)
    Теги плана.

  - `purchase.total` (object, required)
    Объект с данными об общей стоимости покупки.

  - `purchase.total.amount` (number)
    Общая сумма покупки.

  - `purchase.total.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

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

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

  - `settings.project_id` (integer)
    ID проекта. Вы можете найти этот параметр в вашем [аккаунте](/ru/webhooks/overview/#business-accounts) рядом с названием проекта.

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

  - `transaction.agreement` (integer)
    ID соглашения.

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

  - `transaction.external_id` (string)
    Внешний ID транзакции. Изучите подробную информацию в [Частых вопросах](/ru/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id).

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

  - `transaction.payment_date` (string)
    Дата платежа.

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

  - `transaction.payment_method_name` (string)
    Название способа оплаты.

  - `transaction.payment_method_order_id` (string)
    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)
    Имя пользователя.

  - `user.phone` (string)
    Номер телефона пользователя (в международном формате).

  - `user.zip` (string)
    Почтовый индекс.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields