Чекер банковских карт

Отправка данных банковской карты и биллинга для анализа рисков мошенничества.

Отправить данные карты

POST /checkers/ccard/

Тело запроса

Данные пользователя

Поле	Тип	Описание
user_language	string	Язык браузера
user_agent	string	User Agent браузера
user_ip	string	IP-адрес пользователя
username	string	Имя пользователя
password_hash	string	SHA256-хэш пароля

Адрес биллинга

Поле	Тип	Описание
billing_first_name	string	Имя
billing_last_name	string	Фамилия
billing_company	string	Компания
billing_country	string	Страна (название или ISO Alpha-2, например US)
billing_address_1	string	Адрес, строка 1
billing_address_2	string	Адрес, строка 2
billing_city	string	Город
billing_state	string	Регион или штат
billing_zipcode	string	Почтовый индекс
billing_phone	string	Телефон
billing_email	string	Email

Адрес доставки

Поле	Тип	Описание
shipping_first_name	string	Имя
shipping_last_name	string	Фамилия
shipping_company	string	Компания
shipping_country	string	Страна
shipping_address_1	string	Адрес, строка 1
shipping_address_2	string	Адрес, строка 2
shipping_city	string	Город
shipping_state	string	Регион или штат
shipping_zipcode	string	Почтовый индекс
shipping_phone	string	Телефон
shipping_email	string	Email

Данные карты

Поле	Тип	Описание
credit_card_bin	string	Первые 6 цифр карты (BIN)
credit_card_number	string	Полный номер карты
credit_card_expiration_month	string	Месяц истечения срока
credit_card_expiration_year	string	Год истечения срока
avs_code	string	Код ответа AVS
cvv_code	string	Код ответа CVV

Данные заказа

Поле	Тип	Описание
order_amount	string	Сумма заказа
order_quantity	string	Количество товаров
recurring	boolean	Является ли заказ повторяющимся (с автосписанием)
recurring_times	integer	Количество циклов повторного списания
is_expert_check	boolean	Включить расширенный экспертный анализ

{
  "user_ip": "1.2.3.4",
  "user_agent": "Mozilla/5.0 ...",
  "billing_first_name": "Иван",
  "billing_last_name": "Иванов",
  "billing_country": "RU",
  "billing_email": "ivan@example.com",
  "credit_card_bin": "411111",
  "credit_card_number": "4111111111111111",
  "credit_card_expiration_month": "12",
  "credit_card_expiration_year": "2026",
  "order_amount": "99.99",
  "order_quantity": "1",
  "recurring": false,
  "is_expert_check": false
}

Получить результат проверки

GET /checkers/ccard/{id}/

Получить результат анализа по конкретной задаче.

Параметры пути

Параметр	Тип	Описание
id	string (uuid)	Идентификатор задачи

Ответ

{
  "id": "743e5273-70c6-47fa-96cf-9a8f8a9de6de",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "report": "..."
}

Значения статуса

Статус	Описание
new	Только создана. Ещё не обработана.
ready_to_perform_audit	Готова к запуску проверки
processing	Ожидание отчёта
completed	Завершена (успешно или с ошибкой, детали в report)

Список всех результатов

GET /checkers/ccard/

Получить все результаты проверки карт для вашего аккаунта.

Параметры запроса

Параметр	Тип	Описание
page	integer	Номер страницы

Пример

import time
import requests

API_KEY = "ВАШ_API_КЛЮЧ"
BASE_URL = "https://detect.expert/api/v1"
headers = {"X-Api-Key": API_KEY}

# Отправка данных карты
payload = {
    "user_ip": "1.2.3.4",
    "billing_country": "RU",
    "billing_email": "ivan@example.com",
    "credit_card_bin": "411111",
    "credit_card_number": "4111111111111111",
    "credit_card_expiration_month": "12",
    "credit_card_expiration_year": "2026",
    "order_amount": "99.99",
    "is_expert_check": False,
}
response = requests.post(f"{BASE_URL}/checkers/ccard/", json=payload, headers=headers)
print(response.json())

# Ожидание результата
task_id = "743e5273-70c6-47fa-96cf-9a8f8a9de6de"
while True:
    result = requests.get(f"{BASE_URL}/checkers/ccard/{task_id}/", headers=headers)
    data = result.json()
    if data["status"] == "completed":
        print(data["report"])
        break
    time.sleep(5)