# Успешная оплата заказа (с деталями платежа и транзакции) Xsolla отправляет вебхук order_paid на указанный URL-адрес, когда пользователь успешно оплатил заказ. В вебхуке order_paid содержится информация о купленных товарах, данные платежа и детали транзакции. Вебхук order_paid не отправляется, если оплата неуспешна, например: * форма оплаты была открыта, но пользователь не оплатил заказ; * форма оплаты была открыта, но при оплате возникли ошибки. Рекомендуется обеспечить время обработки вебхука order_paid менее 3 секунд. Внимание Набор полей, отправляемых в вебхуке, зависит от настроек, которые:вы установили в Личном кабинете в разделе Настройки проекта > Вебхуки > Расширенные настройки;были заданы на стороне Xsolla.При возникновении вопросов обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com. Ожидаемые коды ответов описаны в разделе Responses. Вы можете использовать другие коды ответов. В зависимости от кода ответа и подключения функциональности автоматического возврата платежа логика обработки вебхука на стороне Xsolla следующая: Код ответа Автоматический возврат платежа не включен (по умолчанию) Автоматический возврат платежа включен 400, 401, 402, 403, 404, 409, 422, 415 Нет действий Автоматический возврат средств пользователю. 200, 201, 204 Нет действий Нет действий Другой код или отсутствие ответа на вебхук Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут. Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут. Если все вебхуки отправлены, а успешный ответ не получен, осуществляется автоматический возврат средств пользователю. Для подключения функциональности автоматических возвратов обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com Endpoint: POST successful-order-payment Version: 1.0 ## Request fields (application/json): - `billing` (object) Детали платежа и транзакции. - `billing.notification_type` (string, required) Тип оповещения. - `billing.payment_details` (object, required) Объект с финансовыми данными платежа. - `billing.payment_details.country_wht` (object) Объект с данными о налоге с дохода, который удерживается с международных транзакций в некоторых странах. - `billing.payment_details.country_wht.amount` (number) Сумма. - `billing.payment_details.country_wht.currency` (string) Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `billing.payment_details.country_wht.percent` (number) Ставка налога, %. - `billing.payment_details.direct_wht` (object) Налог, удерживаемый у источника выплаты. - `billing.payment_details.direct_wht.percent` (number) Процент налога, удерживаемого у источника выплаты. - `billing.payment_details.payment` (object) Объект с данными о сумме, которую оплатил пользователь. - `billing.payment_details.payment_method_fee` (object) Размер комиссии платежной системы. - `billing.payment_details.payment_method_sum` (object) Объект с данными о сумме, которая была оплачена из платежной системы. - `billing.payment_details.payout` (object) Объект с данными о сумме выплаты. - `billing.payment_details.payout_currency_rate` (string) Курс валюты платежа к валюте выплаты. - `billing.payment_details.repatriation_commission` (object) Объект с информацией о затратах на репатриацию, возлагаемых на Xsolla третьими сторонами. - `billing.payment_details.sales_tax` (object) Размер налога (только для США и Канады). - `billing.payment_details.sales_tax.percent` (number) Процент налога. - `billing.payment_details.user_acquisition_fee` (object) Объект с данными о сумме вознаграждения каналов привлечения трафика (аффилированные сети и инфлюенсеры). - `billing.payment_details.user_acquisition_fee.percent` (number) Ставка вознаграждения за привлечение пользователей, %. - `billing.payment_details.vat` (object) Размер VAT (только для Евросоюза). - `billing.payment_details.vat.percent` (number) Процент VAT. - `billing.payment_details.xsolla_balance_sum` (object) Объект с данными о сумме, которая была оплачена с Xsolla-баланса. - `billing.payment_details.xsolla_fee` (object) Размер комиссии Xsolla. - `billing.purchase` (object) Объект с информацией о заказе. - `billing.purchase.coupon` (object) Объект с информацией о купоне (если при создании подписки был использован купон). - `billing.purchase.coupon.campaign_code` (string) Код кампании купонов. - `billing.purchase.coupon.coupon_code` (string) Код купона. - `billing.purchase.gift` (object) Объект с информацией о подарке. - `billing.purchase.gift.giver_id` (string) ID дарителя. - `billing.purchase.gift.hide_giver_from_receiver` (string) Флаг, показывать ли дарителя получателю подарка. - `billing.purchase.gift.message` (string) Сообщение от дарителя. - `billing.purchase.gift.receiver_email` (string) Email получателя подарка. - `billing.purchase.gift.receiver_id` (string) ID получателя подарка. - `billing.purchase.promotions` (array) Массив с данными акций, которые действуют на данную покупку. - `billing.purchase.promotions.id` (integer) ID акции. - `billing.purchase.promotions.technical_name` (string) Техническое название акции. - `billing.purchase.subscription` (object) Объект с данными о подписке. - `billing.purchase.subscription.amount` (number) Сумма покупки. - `billing.purchase.subscription.date_create` (string) Дата создания подписки. Дата и время согласно стандарту [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `billing.purchase.subscription.date_next_charge` (string) Дата следующего списания. Дата и время согласно стандарту [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `billing.purchase.subscription.plan_id` (string) ID плана (внешний id, если план был создан через API). - `billing.purchase.subscription.product_id` (string) ID продукта (если был отправлен в токене). - `billing.purchase.subscription.subscription_id` (integer) ID подписки в базе данных Xsolla. - `billing.purchase.subscription.tags` (array) Теги плана. - `billing.purchase.total` (object, required) Объект с данными об общей стоимости покупки. - `billing.purchase.total.amount` (number) Общая сумма покупки. - `billing.settings` (object) Объект, содержащий настройки проекта. - `billing.settings.merchant_id` (integer) ID продавца. - `billing.settings.project_id` (integer) ID проекта. Вы можете найти этот параметр в [Личном кабинете](https://publisher.xsolla.com/) рядом с названием проекта. - `billing.transaction` (object, required) Объект с информацией о транзакции, связанной с этой операцией. - `billing.transaction.agreement` (integer) ID соглашения. - `billing.transaction.dry_run` (integer) Признак тестовой транзакции. Значение параметра равно 1 для тестового платежа, для реального платежа параметр не передается. - `billing.transaction.external_id` (string) Внешний ID транзакции. Изучите подробную информацию в [Частых вопросах](/ru/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id). - `billing.transaction.id` (integer) ID транзакции. - `billing.transaction.payment_date` (string) Дата платежа. - `billing.transaction.payment_method` (integer) ID способа оплаты. - `billing.transaction.payment_method_name` (string) Название способа оплаты. - `billing.transaction.payment_method_order_id` (string) ID платежа в платежной системе. - `custom_parameters` (object) Дополнительная информация. - `items` (array, required) Список предметов, которые купил пользователь. Набор передаваемых параметров в массиве зависит от версии вебхука. В версии 2 дополнительно передаются параметры is_free, is_bonus и is_bundle_content.  Для переключения версии передайте ее номер в параметре version в методе [Обновление информации о настройках вебхуков](/ru/api/igs/operation/update-webhook/). - `order` (object, required) Информация о заказе. - `order.amount` (string, required) Стоимость корзины с учетом выбранной валюты. - `order.comment` (string,null, required) Комментарий пользователя к заказу. - `order.coupons` (array) Примененные купоны. Если купон не был применен, массив не возвращается. - `order.coupons.code` (string) Код примененного купона. - `order.coupons.external_id` (string) Внешний ID. - `order.currency` (string, required) Валюта заказа. Для виртуальной валюты используется артикул, для реальной валюты используется трехбуквенное обозначение согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `order.currency_type` (string, required) Тип валюты платежа. Для бесплатного заказа указывается значение unknown. Enum: "real", "virtual", "unknown", "loyalty_point" - `order.id` (integer, required) Уникальный идентификатор заказа пользователя на стороне Xsolla. - `order.invoice_id` (string,null, required) ID счета для платежей за реальную валюту. Для платежей за виртуальную валюту или для бесплатных товаров передается значение null. - `order.mode` (string, required) Тип платежа. Значение default (по умолчанию) используется для реальных платежей. Значение sandbox используется для тестовых платежей. Enum: "default", "sandbox" - `order.platform` (string,null, required) Платформа платежа. Для платежей через Xsolla используется значение xsolla. Для других платежей используется значение, соответствующее названию платформы публикации игры. Enum: "xsolla", "playstation_network", "xbox_live", "pc_standalone", "nintendo_shop", "google_play", "app_store_ios", "android_standalone", "ios_standalone", "android_other", "ios_other", "pc_other" - `order.promocodes` (array) Примененные промокоды. Если промокод не был применен, массив не возвращается. - `order.promocodes.code` (string) Код примененного промокода. - `order.promotions` (array, required) Примененные акции для всего заказа. Массив возвращается, если: - Акция влияет на общую сумму покупки при использовании промокода с настройкой Скидка на покупку. - Скидки на покупку нет, но к заказу добавляются бонусные товары. В этом случае значения стоимости со скидкой ([amount_with_discount](/ru/webhooks/#operation/order-cancellation!path=order/promotions/amount_with_discount&t=request)) и без нее ([amount_without_discount](/ru/webhooks/#operation/order-cancellation!path=order/promotions/amount_without_discount&t=request)) передаются и совпадают, поскольку скидка не применяется. Если акции на уровне заказа не применялись, передается пустой массив. - `order.promotions.amount_with_discount` (string) Стоимость товаров со скидкой. - `order.promotions.amount_without_discount` (string) Стоимость товаров без скидки. - `order.promotions.sequence` (integer) Порядок применения акций. - `order.status` (string, required) Статус заказа. - `user` (object, required) Информация о пользователе. - `user.country` (string) Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `user.email` (string, required) Email-адрес пользователя. - `user.external_id` (string, required) ID пользователя. ## Response 200 fields ## Response 400 fields