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. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.