Skip to main content
В этой статье будет представлена инструкция по интеграции API проверки двух факторов банковской карты, который можно использовать для проверки подлинности и согласованности имени и номера банковской карты.

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

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

​
Основное использование

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

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

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