Skip to main content
У цьому документі буде представлено опис інтеграції API для верифікації трьох елементів банківської картки, який може бути використаний для перевірки достовірності та узгодженості інформації про номер банківської картки, ім’я та номер документа, що підтверджує відкриття рахунку.

​
Процес подачі заявки

Щоб використовувати API для верифікації трьох елементів банківської картки, спочатку перейдіть до консолі Ace Data Cloud, щоб отримати ваш API Token, зберігши його для подальшого використання. Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти, після чого ви будете автоматично повернені на цю сторінку. Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт, щоб ви могли безкоштовно протестувати; при недостатньому ліміті ви можете поповнити загальний баланс в консолі.
📘 Повна документація: API верифікації трьох елементів банківської картки →

​
Основне використання

Спочатку ознайомтеся з основним способом використання, а саме, введіть інформацію про номер банківської картки, щоб отримати оброблене зображення результату, для цього потрібно просто передати поле bank_card. Далі ми можемо заповнити відповідні дані на інтерфейсі, як показано на малюнку:

Ми бачимо, що тут ми налаштували заголовки запиту, включаючи:
  • accept: формат відповіді, який ви хочете отримати, тут вказано application/json, тобто формат JSON.
  • authorization: ключ для виклику API, після подачі заявки ви можете вибрати його зі списку.
Також налаштовано тіло запиту, яке включає:
  • bank_card: інформація про номер банківської картки, є обов’язковим параметром.
  • id_card: номер документа, що підтверджує відкриття рахунку, є обов’язковим параметром.
  • name: ім’я користувача, є обов’язковим параметром.
  • cert_type: тип документа, що підтверджує відкриття рахунку, повинен відповідати документу, інакше верифікація не буде можлива.
  • encryption: необов’язковий параметр для шифрування чутливих полів (якщо потрібно передати зашифровані дані).
Після вибору ви також можете побачити згенерований код праворуч, як показано на малюнку:

Натисніть кнопку «Спробувати», щоб провести тестування, як показано на малюнку, тут ми отримали наступний результат:
Повернене значення містить кілька полів, описаних нижче:
  • result, код результату аутентифікації, умови оплати такі:
    • Код результату оплати:
      • 0: Аутентифікація пройшла
      • -1: Аутентифікація не пройшла
      • -4: Інформація про власника картки неправильна
      • -5: Не активовано безкарткову оплату
      • -6: Цю картку конфісковано
      • -7: Неправильний номер картки
      • -8: Ця картка не має відповідного емітента
      • -9: Ця картка не ініціалізована або спляча картка
      • -10: Картка шахрайства, затримка картки
      • -11: Цю картку було втрачено
      • -12: Ця картка прострочена
      • -13: Обмежена картка
      • -14: Перевищено кількість помилок пароля
      • -15: Емітент не підтримує цю транзакцію
    • Код результату без оплати:
      • -2: Перевірка імені не пройшла
      • -3: Номер банківської картки неправильний
      • -16: Служба верифікації зайнята
      • -17: Перевищено кількість верифікацій, спробуйте наступного дня
  • description, опис бізнес-результату.
Можна побачити, що достовірність та узгодженість інформації про номер банківської картки, ім’я та номер документа, що підтверджує відкриття рахунку, пройшли верифікацію. Крім того, якщо ви хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код CURL виглядає так:
Код інтеграції на Python виглядає так:

​
Обробка помилок

При виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:
  • 400 token_mismatched: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 400 api_not_implemented: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 401 invalid_token: Неавторизовано, недійсний або відсутній токен авторизації.
  • 429 too_many_requests: Занадто багато запитів, ви перевищили ліміт запитів.
  • 500 api_error: Внутрішня помилка сервера, щось пішло не так на сервері.

​
Приклад відповіді з помилкою

​
Висновок

Завдяки цьому документу ви дізналися, як використовувати API верифікації трьох елементів банківської картки для перевірки достовірності та узгодженості інформації про номер банківської картки, ім’я та номер документа, що підтверджує відкриття рахунку. Сподіваємося, що цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.