УКР | [ENG](https://hackmd.io/16yLv895Qo-FWTvrWWQwbg)

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

## Коди типів операцій "OperationType"

| "OperationType" | Тип операції |
|:-------------:| ------------ |
|`10001/10002`| [Підтвердження/скасування передавторизації, здійсненої через запити [10102/101023/101025]](https://hackmd.io/KRcEsWMkRtiV0T1_ISoUMA) |
|`10005`| [Отримання посилання на платіжну сторінку](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg) |
|`10015/10025/10035/10045`|[Отримання посилання віджета для проходження ідентифікації "BankID/Дія"](https://hackmd.io/EimWFyvOSxSEqZiABDIUtg) |
|`10101`| [Карта-карта](https://hackmd.io/ZpBbYAb4RsaTc8NU_0zwfA) |
|`10102/101023/101025`| [Карта-гаманець](https://hackmd.io/jxzgAy4nSt-Q-6chgRCZdQ) |
|`10103`| [Карта-IBAN фізична особа](https://hackmd.io/mQFXiO1USRuVX2-ah4h1FQ)|
|`101031`| [Карта-IBAN юридична особа](https://hackmd.io/-jgdOWRiRwaabSv5_YjAKQ)|
|`10108` (v.1)| [Погашення заборгованості (v.1)](https://hackmd.io/f8cr3qN-QU27s2pAyU39bQ)|
|`10108` (v.2)| [Погашення заборгованості (v.2)](https://hackmd.io/7lBhiykHQ6K4gTJLatww-Q)|
|`10150/10051`| [Карта-телефон-карта](https://hackmd.io/rXZuYXYwQp2W-QffXO99yA) |
|`10202`| [Гаманець-гаманець](https://hackmd.io/dDT3KzIgQjW8-v8rYo-pPg)|
|`10205`| [Гаманець-мобільний](https://hackmd.io/Ed0nf9UaRUuhBux_4NPeVg) |
|`102070221/102070222/ 102070251/102070252`| [Підтвердження/скасування відкладеної оплати](https://hackmd.io/aTXOGiPaSkewvXdXUbpstg)|
|`10301/10311/10313`| [Гаманець-карта](https://hackmd.io/v5DKCslVSiGacRGLePCrOw)|
|`10204/10214`| [Гаманець-карта (по токену)](https://hackmd.io/-dYr0t8eREOOjLvWsBucRg)|
|`10303`| [Гаманець-IBAN](https://hackmd.io/QF_yny3cRpCuQdUZq7dpyA)|
|`10304`| [Гаманець-UUID](https://hackmd.io/YFxvxD7nQJqD5lRJokBejw)|
|`10305`| [Карта-мобільний](https://hackmd.io/XGJE11L3T_KwUtIR1Qlf_Q) |
|`10400`| [Пакетна оплата гаманець-карта (по токену)](https://hackmd.io/e-zkU8N5T9CT3uNerArq8w)|
|`10401`| [Пакетна оплата гаманець-карта (за номером карти)](https://hackmd.io/wvbMmdloQsiPSg-mp8e6Eg)|
|`104021`| [Оплата картою по токену](https://hackmd.io/CCEZ0su4T3OBtY-_QBSzew)|
|`1040217`| [Пакетна оплата карткою по токену](https://hackmd.io/UvXgiPdmRGOs0hwDtc_CEQ)|
|`10405`| [Токен-мобільний](https://hackmd.io/gsTvGhrDTjqlNE_ZZa22vA) |
|`104121`| [Автосписання з карти по токену. MO/TO-операції](https://hackmd.io/-_Rj-iqZTMy22FxFgUc08w)|
|`20000`| [Отримання доступних методів оплати (SDK)](https://hackmd.io/E5abYpORTuCezUaxjRM1iA)|
|`20001`| [Отримання балансу гаманця](https://hackmd.io/c-2sDICDRGeplJ-QL8bETw) |
|`20002`| [Отримання виписки по гаманцю](https://hackmd.io/L9EeXtQYRDCQD_IhAPKhMw) |
|`20003`| [Отримання статусу операції](https://hackmd.io/fvd8btZLQXywluia6w5uxg) |
|`20004`| [Отримання квитанції по операції](https://hackmd.io/mOA9rZ_xSxWrNZxKzvZ5HQ) |
|`20006`| [Видалення даних картки через ClientToken](https://hackmd.io/bi52J8M6Q2-s3tqyCDjV5Q) |
|`20007`| [Отримання даних по клієнту для проходження ідентифікації BankID/Дія"](https://hackmd.io/2XGUxnOxQyW1wqxMndI_0g) |
|`20008`| [Отримання курсу валют](https://hackmd.io/inushlCxQa2f0MRgvVD7eg) |
|`20009`| [Отримання ліміту по операції [10101]](https://hackmd.io/a_-XSuzvRvG9t9cU2yoUvg) |
|`20110`| [Отримання даних карти](https://hackmd.io/zFCegCSASKKjGCmoJkTYmw) |
|`20400/20410`| [Отримання даних карти за номером телефону](https://hackmd.io/EjF35e_sSfKad2ojsEoYWQ) |
|`20404`| [Отримання даних карти за токеном](https://hackmd.io/Fo0-oeZ4Sz-Gju6Qg01hiA) |
|`20801` (v.1)|[Отримання даних довідника (v.1)](https://hackmd.io/Xndoh9TxRPSMk1V1pPhXUQ) |
|`20801` (v.2)|[Отримання даних довідника (v.2)](https://hackmd.io/tWx9osErTZSOWRh2lksgEA) |
|`208011` (v.1)|[Отримання даних міст з довідника (v.1)](https://hackmd.io/qckJ3sUqT5C00IvWxsJ4dw) |
|`20802` (v.1)|[Отримання даних заборгованості (v.1)](https://hackmd.io/fkcB0yBhTuKW7SEYbCV0zw)|
|`20802` (v.2)|[Отримання даних заборгованості (v.2)](https://hackmd.io/26l7UwT9TLKlmV9gNconZg)|
|`30201/302013/302015`| [Відміна/повернення платежу, здійсненого через запити [10102/101023/101025]](https://hackmd.io/W25MdduPQFidcqLdTWIbpg) |
|`30202`| [Відміна/повернення платежу поставторизації](https://hackmd.io/YQp1wWGTTCmw0EG_zFGIwg) |
|`30203`| [Відміна/повернення платежу, здійсненого через Checkout](https://hackmd.io/3BzRqynvSF-J7fhcZCZDXA) |
|`80001`| [Оплата штрафу картою через мобільний додаток](https://hackmd.io/0gQHPa8HTtiltQgi8h9d3A) |
|`80200`| [Отримання інформації по штрафам](https://hackmd.io/q3baQG6gSpe9igShE8JHag) |
|`90001/90002/90003/90004/90005`|[Підготовка операції](https://hackmd.io/xYFV6Y0YQnaY2sau_jTPXg) |
|`90000`|[Виконання операції](https://hackmd.io/FtHIJD2mSU-zmMZsFm5axQ) |

## Типи платіжного методу "PayType"

| "PayType" | Платіжний метод |
|:-------------:| ------------ |
| `0` / `відсутність параметра` | *Пряме списання* - списання коштів з картки клієнта через с2а (card-to-account) або p2p (person-to-person) переказ. |
| `1` | *Оплата через шлюз інтернет-еквайрингу.* |
| `2` | *Відкладений платіж* - блокування коштів на картці клієнта для подальшого списання та зарахування на заздалегідь прописані гаманці. |
| `3` | *Оплата через сторонній віджет.* |
| `4` | *Оплата за реквізитами* - списання коштів з картки клієнта та зарахування на вказані реквізити.|
| `5` | *Відкладений платіж за реквізитами* - блокування коштів на картці клієнта для подальшого списання та зарахування на вказані реквізити. |
| `7` | *Пакетна оплата послуг* - розщеплення платежу клієнта на декількох одержувачів та зарахування коштів на заздалегідь прописані гаманці. |
| `12` | *Пакетна оплата послуг за реквізитами* - розщеплення платежу клієнта на декількох одержувачів та зарахування коштів на вказані реквізити. |
| `13` | *Оплата на рахунки мерчантів (MIDs)* - розщеплення платежу клієнта на декількох одержувачів та зарахування коштів на користь вказаних мерчантів. |
| `20` | *Оплата через "Google/Apple Pay"* - зручний спосіб оплати від Google та за допомогою пристроїв компанії Apple. |

## Коди відповідей Оператора "Code"

| Код відповіді | Повідом-лення | Статус "OperationStatus" | Причина "Reason" | Опис коду | Фаталь-ність |
|:-:|:-:|:-:|:-:|-|:-:|
| `102` | `Processing` | `1`, `2`, `3`, `4`, `5`, `7` (див. опис нижче) | будь-яка | Платіж в обробці. | Ні |
| `200` | `OK` | `10`, `20`, `21`, `22` | відсутня | Обробка операції завершена. | Так |
| `400` | `Bad Request` | `21` | будь-яка | Помилка парсингу запиту. Помилка структури. | Так |
| `401` | `Unauthorized` | `21` / відсутній | будь-яка | Токен не відповідає ключу. | Так |
| `403` | `Forbidden` | `21` / відсутній | будь-яка | Виконання операції заборонено. | Так |
| `404` | `Not Found` | `21` / відсутній | будь-яка | Метод не знайдено. | Так |
| `500` | `Internal Server Error` | `21` / відсутній | будь-яка | Відбулася непередбачена помилка виконання протоколу. | Так |
| `503` | `Service Unavailable` | `21` / відсутній | будь-яка | Сервіс недоступний. Сервер не готовий обробляти запит. | Так |

## Статус обробки операції "OperationStatus"

| "OperationStatus" | Статус | Фатальність |
|:----:|----|:----:|
| `1` | Прийнятий для обробки. | Ні |
| `2` | Перевірка картки на [3DS](https://uk.wikipedia.org/wiki/3-D_Secure). | Ні |
| `3` | Очікування верифікації [OTP](https://uk.wikipedia.org/wiki/%D0%9E%D0%B4%D0%BD%D0%BE%D1%80%D0%B0%D0%B7%D0%BE%D0%B2%D0%B8%D0%B9_%D0%BF%D0%B0%D1%80%D0%BE%D0%BB%D1%8C). | Ні |
| `4` | Операція у черзі. | Ні |
| `5` | Операція в обробці. | Ні |
| `7` | Очікування підтвердження (наприклад, комісія розрахована, але оплата не була виконана, або при відкладеному платежі очікується підтвердження/скасування списання). | Ні |
| `10` | Операція проведена успішно. | Так |
| `20` | Помилка верифікації OTP. | Так |
| `21` | Помилка проведення операції. | Так |
| `22` | Операцію скасовано. | Так |

## Коди причин відхилення операцій "Reason"

| "Reason" | Причина відхилення |
|:----:|----|
| `1` | Платіж відхилено з тимчасових технічних причин. Будь ласка, повторіть оплату пізніше. Технічна проблема. |
| `2` | Абонент не знайдено. |
| `3` | Платіж відхилено. На карті недостатньо коштів для транзакції. |
| `6` | Платіж відхилено. Перевірте правильність введених реквізитів картки або вкажіть номер іншої картки. Відмова банку емітента. |
| `9` | Платіж відхилено. Перевірте правильність введених реквізитів картки. Неправильно введено код CVV. |
| `11` | Платіж відхилено. Спробуйте оплатити іншою карткою, або повторіть оплату пізніше. Антифрод банку еквайєра. |
| `12` | Платіж відхилено. Термін дії картки минув. Зверніться до банку. |
| `13` | Платіж відхилено. Перевищено добовий ліміт кількості операцій на карті. Зверніться до банку. |
| `14` | Платіж відхилено. Карта не підтримує додатковий рівень безпеки 3DSecure. Прохання звернутися до банку для підключення функції. |
| `18` | Платіж відхилено. Перевірте правильність введених реквізитів картки, вкажіть номер іншої картки або зверніться до банку, який видав картку. Карта заблокована емітентом. |
| `19` | Платіж відхилено. Відмова від оплати платежу. |
| `22` | Перевищено ліміт оплат в інтернеті за карткою. Зверніться до банку. |
| `27` | Платіж відхилено. Країна карти відрізняється від адреси комп’ютерної мережі (IP). |
| `42` | Сплив час очікування платежу. |
| `53` | Ця карта не приймається. Платіж скасований. |
| `58` | Спроба змінити дані операції, яка вже існує. |
| `61` | Операцію в Інтернеті відхилено через недостатній ліміт за сумою операцій по карті. Збільшіть інтернет-ліміт у Приват24 (меню «Мої рахунки» > «Керування карткою/рахунком» > «Оплата в Інтернеті») та повторіть операцію пізніше. |
| `62` | Картка з обмеженнями (картка недійсна в цьому регіоні чи країні). |
| `63` | Перевірка 3D-Secure не виконана. Зверніться до банку для уточнення інформації. |
| `64` | Неправильний код перевірки. |
| `88` | Інша помилка. |
| `99` | Перевищено ліміт операції. |
| `601` | Користувач з таким email вже існує. |
| `602` | Користувач з таким мобільним номером вже існує. |
| `606` | Компанія з такою назвою вже існує. |
|`735` | Сума списань з карт контрагента перевищує допустимий обсяг за місяць.|
|`739` | Ця картка одержувача не приймається. Платіж скасовано.|
|`818` | Сума операції перевищує допустимий ліміт.|
|`819` | Сума списань з карти перевищує допустимий обсяг за місяць.|
|`820` | Сума поповнення карти перевищує допустимий обсяг за місяць.|
|`825` | Кількість зарахувань на картку перевищує допустимий ліміт на добу.|
|`834` | Кількість списань з картки перевищує допустимий ліміт на добу.|
|`853`| Сума операцій перевищує допустимий ліміт на місяць. |
| `100051` | Користувач не почав оплату (лише для запиту [[10005]](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg)). |
| `100053` | Час очікування платежу сплинув (лише для запиту [[10005]](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg)). |
| `3000` | Зверніться до емітента картки. |
| `3001` | Зверніться до емітента картки, особливі умови. |
| `3002` | Недійсний продавець. |
| `3003` | Не обслуговувати. |
| `3004` | Помилка.|
| `3005` | Недійсна транзакція.|
| `3006` | Недійсна сума або переповнення поля конвертації валюти.|
| `3007` | Жодних заходів не вжито.|
| `3008` | Не вдалося знайти запис у файлі.|
| `3009` | Файл тимчасово недоступний для оновлення чи запиту.|
| `3010` | Немає кредитного рахунку.|
| `3011` | Транзакція не відповідає вимогам AML.|
| `3012` | На карті досягнуто ліміт за кількістю знять готівки.|
| `3013` | Незатребуване скасування.|
| `3014` | Заблоковано, використано вперше - трансакція від нового власника картки, картку не розблоковано належним чином.|
| `3015` | Уже скасовано (за допомогою Switch).|
| `3016` | Жодного фінансового впливу.|
| `3017` | Немає причин відхиляти запит на підтвердження адреси, підтвердження CVV2, кредитний ваучер або повернення товару.|
| `3018` | Немає дозволу отримувати інформацію про фінансове становище (GIV).|
| `3019` | Емітент або комутатор не працюють, а STIP не застосовується або недоступний для цієї транзакції; Час для заміни вичерпано; Служба перевірки POS: пункт призначення недоступний; Кредитний ваучер та дозвіл на повернення товару: V.I.P. надіслав транзакцію емітенту, але емітент був недоступний.|
| `3020` | Не вдалося знайти фінансову установу або проміжну мережу для маршрутизації (ідентифікатор установи-одержувача недійсний).|
| `3021` | Транзакцію неможливо здійснити - порушення закону.|
| `3022` | Сума додаткової комісії не дозволена на картках Visa або харчових талонах EBT (лише для еквайрів у США).
| `3023` | Сума додаткової комісії не підтримується емітентом дебетової мережі.|
| `3024` | примусовий STIP.|
| `3025` | Обслуговування готівкою не доступне.|
| `3026` | Запит на готівку перевищує емітентний або затверджений ліміт.|
| `3027` | Непридатний для повторного подання.|
| `3028` | Введено неправильний CVV2 код під час проведення платежу.|
| `3029` | Сума трансакції перевищує попередньо авторизовану суму схвалення.|
| `3030` | Зупинити платіжне доручення.|
| `3031` | Транзакція не дозволена для власника картки. |
|`UNF`| Користувач не зареєстрований як Партнер. Користувач не знайдений.|
|`UBL`| Користувач заблокований.|
|`UUN`| Користувач не ідентифікований.|

:arrow_left: [XPAY API Зміст](/Mj2ZqCVpSq6A6Jzm6ladlw)
:arrow_left: [XPASS API Зміст](https://hackmd.io/eSq3juGWQLS1wVvJZiTUAQ)

<details>
<summary>Служба підтримки XPAY</summary>
</br>

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