Проверка четырех элементов банковской карты API

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

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

Чтобы использовать API проверки четырех элементов банковской карты, сначала перейдите в консоль Ace Data Cloud, чтобы получить ваш API Token и сохранить его для использования.

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

📘 Полная документация: API проверки четырех элементов банковской карты →

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

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

Как видно, мы настроили заголовки запроса, включая:

accept: в каком формате вы хотите получить ответ, здесь указано application/json, то есть в формате JSON.
authorization: ключ для вызова API, после запроса вы можете выбрать его из выпадающего списка.

Также настроено тело запроса, включая:

bank_card: информация о номере банковской карты, обязательный параметр.
id_card: номер удостоверения личности, обязательный параметр.
name: имя пользователя, обязательный параметр.
phone: резервный номер телефона.
cert_type: тип удостоверения личности, должен соответствовать удостоверению.
encryption: необязательный параметр для шифрования чувствительных данных (если необходимо отправить зашифрованный текст).

После выбора вы также можете увидеть сгенерированный код справа, как показано на изображении:

Нажмите кнопку «Попробовать», чтобы провести тестирование, как показано на изображении, и мы получили следующий результат:

{
  "result": "0",
  "description": "Аутентификация пройдена"
}

Возвращаемый результат содержит несколько полей, описание которых приведено ниже:

result, код результата аутентификации, условия оплаты следующие.
- Код результата с оплатой:
  - 0: Аутентификация пройдена
  - -1: Аутентификация не пройдена
  - -4: Ошибка информации о держателе карты
  - -5: Неактивированная безкарточная оплата
  - -6: Эта карта была изъята
  - -7: Неверный номер карты
  - -8: У этой карты нет соответствующего эмитента
  - -9: Эта карта не инициализирована или спящая карта
  - -10: Карта мошенничества, захваченная карта
  - -11: Эта карта была утеряна
  - -12: Эта карта истекла
  - -13: Ограниченная карта
  - -14: Превышено количество неверных попыток пароля
  - -15: Эмитент не поддерживает эту транзакцию
- Код результата без оплаты:
  - -2: Проверка имени не пройдена
  - -3: Неверный номер банковской карты
  - -16: Служба проверки занята
  - -17: Превышено количество проверок, попробуйте снова на следующий день
description, описание бизнес-результата.

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

curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-4e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "phone": "***",
  "id_card": "***",
  "bank_card": "***"
}'

Код интеграции на Python выглядит следующим образом:

import requests

url = "https://api.acedata.cloud/identity/bankcard/check-4e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "name": "Ху Иньфу",
    "phone": "***",
    "id_card": "***",
    "bank_card": "***"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Обработка ошибок

При вызове API, если возникнет ошибка, API вернет соответствующий код ошибки и информацию. Например:

400 token_mismatched: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
400 api_not_implemented: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
401 invalid_token: Неавторизовано, недействительный или отсутствующий токен авторизации.
429 too_many_requests: Слишком много запросов, вы превысили лимит.
500 api_error: Внутренняя ошибка сервера, что-то пошло не так на сервере.

Пример ответа об ошибке

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "не удалось получить данные"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Заключение

С помощью этого документа вы узнали, как использовать API проверки четырех элементов банковской карты для ввода номера банковской карты, имени, номера удостоверения личности и номера телефона, чтобы проверить подлинность и согласованность информации. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Прокси

Продвинутый

Coding

Проверка четырех элементов банковской карты API

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

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

Обработка ошибок

Пример ответа об ошибке

Заключение

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

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

​Обработка ошибок

​Пример ответа об ошибке

​Заключение

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

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

Обработка ошибок

Пример ответа об ошибке

Заключение