УКР | [ENG](https://hackmd.io/O3Pv0pgKQEGC5O3CTB134g)

# Обробка операцій при оплаті картою (CallbackURL)

## Редирект клієнта на сторінку CallbackURL

Після проведення операції відбувається перенаправлення клієнта на сторінку результатів оплати **"CallbackURL"** (якщо параметр переданий у запиті), наприклад:

"CallbackURL": "https://partner.host/resul_page"

Завершальним етапом виконання операції є отримання статусу транзакції на відповідні URL адреси Партнера - **“SuccessCallback”** або **“FailedCallback”** (якщо параметри передані у запиті), наприклад:

“SuccessCallback”: “https://partner.host/cb_success”
або
“FailedCallback”: “https://partner.host/cb_fail”

При формуванні даних URL адрес додаються параметри `state` та `xrayOperationID`:

| Параметр | Обов’яз-ковість | Тип | Опис | Приклад |
|:-:|:-:|:-:|-|:-:|
|`state`|Ні|Ціле|Статус обробки операції, згідно таблиці “[Статус обробки операції](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w#%D0%A1%D1%82%D0%B0%D1%82%D1%83%D1%81-%D0%BE%D0%B1%D1%80%D0%BE%D0%B1%D0%BA%D0%B8-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D1%96%D1%97-%E2%80%9COperationStatus%E2%80%9D)”. |`10` - успішне списання, </br> `21` - помилка проведення операції.|
|`xrayOperationID`|Ні|Рядок|Унікальний ідентифікатор операції у системі Оператора.|`245786`|

:::success
<details>
<summary>Приклад URL адреси "Успішне списання коштів"</summary>
<br>

~~~md
https://partner.host/cb_success?state=10&xrayOperationID=245786
~~~
</details>
:::

:::success
<details>
<summary>Приклад URL адреси "Помилка проведення операції"</summary>
<br>

~~~md
https://partner.host/cb_fail?state=21&xrayOperationID=245786
~~~
</details>
:::

## Отримання статусу операції

Для отримання поточного статусу транзакції у будь-який момент може застосовуватись запит: [[20003] "Отримання статусу операції"](https://hackmd.io/fvd8btZLQXywluia6w5uxg).

## Довідкові матеріали

Опис загальних параметрів системи XPAY див. у розділі ["Довідкові матеріали"](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w?both): коди типів операцій, типи платіжних методів, коди статусів обробки операцій, відомості та помилки, що повертаються у відповіді та ін.

## Cлужба підтримки XPAY
<details>
<summary>Контакти</summary>
</br>

Телефон: [phone]
email: [e-mail]
Telegram: @xpaysupportbot.
</details>
</br>

:::info
**Навігація по API:**

:bookmark_tabs: [XPAY API Guide](/Mj2ZqCVpSq6A6Jzm6ladlw)

:arrow_left: [Загальна інформація по підключенню (API)](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA)
:::