Ukrcard
  1. Довідка
Ukrcard
  • Вступ
  • Початок роботи
  • Рецепти
  • Загальні концепції
  • Особистий кабінет торговця
  • Довідка
    • Потоки обробки транзакцій
    • Коди відповідей
    • Тестові дані
  • Наші методи
    • E-Commerce еквайринг
      • /Payment
      • /Preauthorization
      • /CancelPreauthorization
      • /Completion
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Грошові перекази
      • /р2рTransfer
      • /Confirm
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Платежі з цифрового гаманця
    • Картки та рахунки (UAPI)
      • 3. PUT changeCardLimit-baseparam/limits/
    • Перекази SEPA
    • Платіжні операції з використанням токенів
      • /Payment
      • /Preauthorization
      • /p2pTransfer
      • /Confirm
      • /ConfirmExt
      • /Panbytoken
    • Apple Pay
      • /PaymentAppleD
      • /PaymentAppleE
    • Google Pay
      • /PaymentGoogleD
      • /PaymentGoogleE
  1. Довідка

Коди відповідей

Switch to English

HTTP status codes

HTTP status code Опис Коментар
200 Запит прийнятий та опрацьований успішно Для отримання інформації щодо успішності самої транзакціїї необхідно перевірити корисне навантаження JSON із відповіді
400 Запит не прийнято Заголовок та/або дані запиту та/або налаштування сервісу для зовнішньої системи не коректні або відсутні. Деталізація помилки міститься у відповіді в errorInfo
404 Помилка під час виклику API - URL неправильний (не існує) Проаналізувати помилку у викликаному методі, виправити та надіслати новий запит
500 Внутрішня помилка обробки Внутрішня системна помилка обробки API запиту. Деталізація помилки міститься у відповіді в errorInfo

Фінальні статуси операцій

orderStatus Опис Коментар
0 замовлення зареєстровано, але не сплачено -
1 сума захолдована (для двостадійного сценарію) фінальний статус
2 проведено повну авторизацію суми замовлення фінальний статус
3 авторизація скасована фінальний статус
4 на замовлення було проведено операцію повернення фінальний статус
5 ініційовано автентифікацію через ACS Банку-емітента -
6 авторизація відхилена фінальний статус

Опис кодів відповіді

actionCodeactionCodeDescriptionРозшифровка коду відповідіРекомендація для Клієнта/Платника
0Request processed successfullyЗапит успішно оброблено
76Can not process transaction
100Card limits exceededОбмеження за картою
101Wrong expiry dateНеправильно введено термін дії карткиРекомендувати власнику перевірити коректність введеного терміну дії картки та повторити оплату або використовувати альтернативний інструмент оплати замовлення.
103Contact issuerВідсутність зв'язку з банком-емітентомТорговцю потрібно зв'язатися з банком-емітентом
106Excessive PIN failure
109Merchant/terminal ID is incorrectНевірно вказано ідентифікатор мерчанта/терміналу
110Invalid amountНевірна сума
111Card number is incorrectНевірний номер картки
116Not enough moneyСума транзакції перевищує доступний залишок коштів на вибраному рахункуРекомендувати власнику картки перевірити достатність коштів на рахунку картки, що використовується, повторити спробу
117Iccorrect PIN
119Security violationПорушення безпеки
120Transaction was refusedВідмова у проведенні операції - транзакція не дозволена емітентомОдна з можливих причин – встановлене на рівні продукту обмеження у процесингу банку-емітента. Оплату замовлення можна повторити за допомогою альтернативного інструменту платежу
121Limit exceededПеревищено доступний ліміт
125Invalid card numberНеправильний номер картки
140Invalid CVV2/CVC2
903Limit exceededПревышен доступный лимит
904Invalid message formatНеприпустимий формат повідомлення
910Cannot contact bankХост банку-емітента недоступнийПовторити пізніше або використовувати інший інструмент/метод оплати
8204Dublicate transmission
100100Incorrect parameters. Reenter requiredНеправильні параметриНеобхідно повторно ввести парамер
100827Do not honor transaction
100831Bad characters in PAN
100833Invalid CVV/CVC
100886The card is not active
100953Card is Restricted, denied
100997Service not allowed for client
151018Processing timeout. Sending the request has failedТайм-аут обробки. Не вдалося надіслати запит.Необхідно повторити спробу пізніше
151019Processing timeout. The sent request was not answeredЧас очікування обробки. Відправлений запит залишився без відповідіНеобхідно повторити спробу пізніше
341014General errorСистемна помилкаНеобхідно перевірити параметри запиту, і звернутися до служби підтримки
3410163DS2 authentication is declined by the Issuer’s ACS in the Authentication Response (ARes).Аутентифікацію 3DS2 відхилено ACS емітента у відповіді на автентифікацію (ARes).Клієнту необхідно перевірити дані, що вводяться ним при операції 3ДС аутентифікації. І якщо все коректно звернутись до банку-емітента
3410173DS2 authentication status in Authentication Response (ARes) is unknownСтатус аутентифікації 3DS2 у ARes невідомий
3410183DS2 CReq (Challenge Request) has been cancelled3DS2 CReq (Challenge Request) скасовано
3410193DS2 RReq failedЧас очікування транзакції на боці емітента минувПовідомлення про помилку «Час очікування транзакції на боці емітента минув» вказує на те, що платіжну транзакцію не завершено через те, що клієнт не завершив аутентифікацію за відведений для цього час (не ввів OTP, або не підтвердив платіж в застосунку під час платежу)
3410203DS2 unknown status in RReq (Result Request)Невідомий статус 3DS2 у RReq. Повідомлення RReq із результатом автентифікації надсилається ACS через DS на сервер 3DS.
3410223DS2 Result Request (RReq) not received3DS2 не получен RReq
3410233DS2 операция отклонена эмитентом
-100Спроб оплати не було
-20063DS авторизація не пройденаАутентифікація власника картки у банку-емітенті пройшла неуспішно. Необхідно повторити спробу або використати альтернативний інструмент оплати замовленняКлієнту необхідно перевірити дані, що вводяться ним при операції 3ДС аутентифікації. І якщо все коректно звернутись до банку-емітента
-2007Час сесії минувМинув термін, відведений на оплату замовлення з моменту реєстрації платежу (за замовчуванням таймаут - 10 хв, тривалість може бути вказана при створенні замовлення)
Previous
Потоки обробки транзакцій
Next
Тестові дані
Built with