# Успешный платеж Когда пользователь успешно совершает оплату, 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. Внимание Набор полей, отправляемых в вебхуке, зависит:от расширенных настроек, которые вы установили в Личном кабинете;кастомных настроек, которые были заданы на стороне 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.percent` (number) Процент налога, удерживаемого у источника выплаты. - `payment_details.payment` (object) Объект с данными о сумме, которую оплатил пользователь. - `payment_details.payment_method_fee` (object) Размер комиссии платежной системы. - `payment_details.payment_method_sum` (object) Объект с данными о сумме, которая была оплачена из платежной системы. - `payment_details.payout` (object) Объект с данными о сумме выплаты. - `payment_details.payout_currency_rate` (string) Курс валюты платежа к валюте выплаты. - `payment_details.repatriation_commission` (object) Объект с информацией о затратах на репатриацию, возлагаемых на Xsolla третьими сторонами. - `payment_details.sales_tax` (object) Размер налога (только для США и Канады). - `payment_details.sales_tax.percent` (number) Процент налога. - `payment_details.user_acquisition_fee` (object) Объект с данными о сумме вознаграждения каналов привлечения трафика (аффилированные сети и инфлюенсеры). - `payment_details.user_acquisition_fee.percent` (number) Ставка вознаграждения за привлечение пользователей, %. - `payment_details.vat` (object) Размер VAT (только для Евросоюза). - `payment_details.vat.percent` (number) Процент VAT. - `payment_details.xsolla_balance_sum` (object) Объект с данными о сумме, которая была оплачена с Xsolla-баланса. - `payment_details.xsolla_fee` (object) Размер комиссии Xsolla. - `purchase` (object) Объект с информацией о заказе. - `purchase.checkout` (object) Объект с информацией о заказе. - `purchase.checkout.amount` (number) Сумма заказа. - `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) Объект с информацией о заказе. Чтобы получать эту информацию, в [Личном кабинете](https://publisher.xsolla.com/) в разделе Настройки проекта > Вебхуки > Расширенные настройки установите переключатель Добавить объект 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.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) Общая сумма покупки. - `settings` (object) Объект, содержащий настройки проекта. - `settings.merchant_id` (integer) ID продавца. - `settings.project_id` (integer) ID проекта. Вы можете найти этот параметр в [Личном кабинете](https://publisher.xsolla.com/) рядом с названием проекта. - `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