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

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

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

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

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

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

Натисніть кнопку «Спробувати», щоб провести тестування, як показано на малюнку, тут ми отримали наступний результат:
У відповіді є кілька полів, описаних нижче:
  • result, код результату перевірки, умови оплати такі:
    • Код результату оплати:
      • 0: Запит успішний
      • -1: Інформацію не знайдено
    • Код безкоштовного результату:
      • -2: Сервіс перевірки зайнятий
      • -3: Банківська картка не існує
  • description, опис результату бізнесу.
  • account_bank, банк, в якому відкрито рахунок.
  • account_type, тип картки: 1. Дебетова картка; 2. Кредитна картка; 3. Передплачена картка; 4. Картка з можливістю кредитування.
Можна побачити, що базова інформація про банківську картку вже запитана. Крім того, якщо ви хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код CURL виглядає так:
Код інтеграції на Python виглядає так:

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

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

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

​
Висновок

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