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

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

Когда пользователь успешно совершает оплату, мы отправляем детали о платеже на webhook URL.

Request

Request Body schema: application/json

notification_type

required

string

Тип оповещения.

required

object

Объект с информацией о транзакции, связанной с этой операцией.

agreement	integer ID соглашения.
dry_run	integer Признак тестовой транзакции. Значение параметра равно 1 для тестового платежа, для реального платежа параметр не передается.
external_id	string Внешний ID транзакции.
id	integer ID транзакции.
payment_date	string Дата платежа.
payment_method	integer ID способа оплаты.
payment_method_name	string Название способа оплаты.
payment_method_order_id	string ID платежа в платежной системе.

required

object

Объект с финансовыми данными платежа.

object

Налог, удерживаемый у источника выплаты.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.
percent	integer <float> Процент налога, удерживаемого у источника выплаты.

object

Объект с данными о сумме, которую оплатил пользователь.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

Размер комиссии платежной системы.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

Объект с данными о сумме, которая была оплачена из платежной системы.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

Объект с данными о сумме выплаты.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

payout_currency_rate

integer <float>

Курс валюты платежа к валюте выплаты.

object

Объект с информацией о затратах на репатриацию, возлагаемых на Иксоллу третьими сторонами.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

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

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.
percent	integer <float> Процент налога.

object

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

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.
percent	integer <float> Процент VAT.

object

Объект с данными о сумме, которая была оплачена с Иксолла-баланса.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

Размер комиссии Иксоллы.

amount	integer <float> Сумма.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

custom_parameters

object

Ваши дополнительные параметры.

object

Объект с информацией о заказе.

required

object

Объект с данными об общей стоимости покупки.

amount	integer <float> Общая сумма покупки.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

Объект с информацией о заказе.

amount	integer <float> Сумма заказа.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

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

campaign_code	string Код кампании купонов.
coupon_code	string Код купона.

object

Объект с информацией о подарке.

giver_id	string ID дарителя.
hide_giver_from_receiver	string Флаг, показывать ли дарителя получателю подарка.
message	string Сообщение от дарителя.
receiver_email	string Email получателя подарка.
receiver_id	string ID получателя подарка.

object

Deprecated

Массив с данными о ключах.

amount

integer <float>

Deprecated

Стоимость ключа

currency

string

Deprecated

Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

digital_content

string

Deprecated

Артикул игры, настраивается в Личном кабинете.

drm

string

Deprecated

DRM-платформа, на которой игра будет доступна. Убедитесь, что нужная DRM-платформа настроена в Личном кабинете.

Enum: "steam" "playstation" "xbox" "uplay" "origin" "drmfree" "gog" "epicgames" "nintendo_eshop" "discord_game_store" "oculus"

object

Deprecated

Объект с информацией об апгрейде.

amount

integer <float>

Deprecated

Сумма покупки.

currency

string

Deprecated

Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object

Deprecated

Объект с информацией о пакете пользователя, с которого был произведен апгрейд.

DRM	string Deprecated DRM-платформа игры.
digital_content	string Deprecated Артикул игры, настраивается в Личном кабинете.

object

Deprecated

Объект с информацией о пакете, на который пользователь перешел в рамках апгрейда.

DRM	string Deprecated DRM-платформа игры.
digital_content	string Deprecated Артикул игры, настраивается в Личном кабинете.

Array of objects

Массив с данными акций, которые действуют на данную покупку.

Array

id	integer ID акции.
technical_name	string Техническое название акции.

object

Объект с данными о подписке.

amount	integer <float> Сумма покупки.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.
date_create	string Дата создания подписки. Дата и время согласно стандарту ISO 8601.
date_next_charge	string Дата следующего списания. Дата и время согласно стандарту ISO 8601.
plan_id	string ID плана (внешний id, если план был создан через API).
product_id	string ID продукта (если был отправлен в токене).
subscription_id	integer ID подписки в базе данных Иксоллы.
tags	Array of strings Теги плана.

object

Deprecated

Объект с данными о приобретенной виртуальной валюте.

amount	integer <float> Deprecated Сумма покупки.
currency	string Deprecated Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.
name	string Deprecated Название виртуальной валюты.
quantity	integer <float> Deprecated Количество бонусного товара.
sku	string Deprecated Артикул пакета виртуальной валюты (если задан для пакета виртуальной валюты).

object

Deprecated

Объект с данными о предметах в покупке.

amount

integer <float>

Deprecated

Сумма заказа.

currency

string

Deprecated

Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

Array of objects

Deprecated

Array

amount	integer <float> Deprecated Количество этого предмета в заказе.
sku	string Deprecated ID предмета (артикул).

object

Объект, содержащий настройки проекта.

merchant_id	integer ID продавца.
project_id	integer ID игры в Иксолле. Вы можете найти этот параметр в Личном кабинете.

object

Объект с информацией о пользователе.

id required	string ID пользователя.
country	string Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту ISO 3166-1 alpha-2.
email	string Email пользователя.
ip	string IP адрес пользователя.
name	string Имя пользователя
phone	string Номер телефона пользователя (в международном формате).
zip	string Почтовый индекс.

Responses

204

Верните, чтобы сообщить об успешной обработке вехбука.

400

Верните в случае ошибки в предоставленной информации (например, обязательный параметр не передан, или авторизация не прошла).

500

Верните, чтобы сообщить о временных ошибках на ваших серверах.

Request samples

Payload
CURL
PHP
HTTP

application/json

{"custom_parameters": { },
"notification_type": "string",
"payment_details": {"direct_wht": {"amount": 0,
"currency": "string",
"percent": 0
},
"payment": {"amount": 0,
"currency": "string"
},
"payment_method_fee": {"amount": 0,
"currency": "string"
},
"payment_method_sum": {"amount": 0,
"currency": "string"
},
"payout": {"amount": 0,
"currency": "string"
},
"payout_currency_rate": 0,
"repatriation_commission": {"amount": 0,
"currency": "string"
},
"sales_tax": {"amount": 0,
"currency": "string",
"percent": 0
},
"vat": {"amount": 0,
"currency": "string",
"percent": 0
},
"xsolla_balance_sum": {"amount": 0,
"currency": "string"
},
"xsolla_fee": {"amount": 0,
"currency": "string"
}
},
"purchase": {"checkout": {"amount": 0,
"currency": "string"
},
"coupon": {"campaign_code": "string",
"coupon_code": "string"
},
"gift": {"giver_id": "string",
"hide_giver_from_receiver": "string",
"message": "string",
"receiver_email": "string",
"receiver_id": "string"
},
"pin_codes": {"amount": 0,
"currency": "string",
"digital_content": "string",
"drm": "steam",
"upgrade": {"amount": 0,
"currency": "string",
"digital_content_from": {"DRM": "string",
"digital_content": "string"
},
"digital_content_to": {"DRM": "string",
"digital_content": "string"
}
}
},
"promotions": [{"id": 0,
"technical_name": "string"
}
],
"subscription": {"amount": 0,
"currency": "string",
"date_create": "string",
"date_next_charge": "string",
"plan_id": "string",
"product_id": "string",
"subscription_id": 0,
"tags": ["string"
]
},
"total": {"amount": 0,
"currency": "string"
},
"virtual_currency": {"amount": 0,
"currency": "string",
"name": "string",
"quantity": 0,
"sku": "string"
},
"virtual_items": {"amount": 0,
"currency": "string",
"items": [{"amount": 0,
"sku": "string"
}
]
}
},
"settings": {"merchant_id": 0,
"project_id": 0
},
"transaction": {"agreement": 0,
"dry_run": 0,
"external_id": "string",
"id": 0,
"payment_date": "string",
"payment_method": 0,
"payment_method_name": "string",
"payment_method_order_id": "string"
},
"user": {"country": "string",
"email": "string",
"id": "string",
"ip": "string",
"name": "string",
"phone": "string",
"zip": "string"
}
}

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}