Документация/Другие операции/Карты
Карты: BIN и верификация
Две служебные операции вокруг карты: узнать её свойства до оплаты и подтвердить, что плательщик ею владеет, не списывая денег.
Информация по BIN
По первым цифрам карты возвращаются платёжная система, тип карты и банк-эмитент. Это нужно, например, чтобы показать логотип схемы или заранее собрать поля, обязательные для Visa — их состав зависит от схемы.
GET /api/v1/cards/information?bin=411111Это не проверка карты
Ответ описывает диапазон BIN, а не конкретную карту. Он ничего не говорит ни о существовании счёта, ни о доступном остатке.
Верификация карты
Верификация подтверждает владение картой без списания — это шаг перед выплатами и рекуррентными сценариями. Процесс состоит из двух вызовов: создать верификацию и передать код, полученный плательщиком.
Создать
POST /api/v1/card-verifications
Idempotency-Key: verify-cust-7f21d0-1Подтвердить
POST /api/v1/card-verifications/{verification_id}/verify
{ "value": "123456" }Состояния верификации
pending— запрос к провайдеру поставлен в очередь или выполняется;code_sent— провайдер отправил код и ждёт его обратно, передайте код на/verify;verified— плательщик подтвердил владение картой, состояние финальное;failed— отказ;manual_review— операция ушла на ручную проверку.
Число попыток ввода кода ограничено и возвращается в поле verify_attempts — показывайте плательщику остаток попыток, а не общий отказ после первой ошибки.
Card-on-file
Сохранение карты согласуется отдельно
Поля save_payment_method и customer_reference присутствуют в схеме, но в действующий клиентский контракт не входят: хранение карты включается отдельным согласованием возможностей. Без customer_reference карту не к чему привязать, и запрос будет отклонён с customer_reference_required.