Обработать онлайн-запросы check-операций для пополнений

POST

https://secured-openapi.tbank.ru/api/refills/v1/check

Метод для обработки онлайн-запросов по операциям сheck. Позволяет проверить, можно ли провести пополнение с указанными данными.

Авторизация

Security

Bearer API Token

MTLS-сертификат

RPS

Ограничение — 5 запросов в секунду

Scopes

Онлайн пополнения клиентам Т-Банка → Операции пополнения через OPS (check и pay запросы)

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Request body schema application/json

crypto

Object

Информация о сертификатах ЭП.

Required

algorithm

String<string>

Наименования поддерживаемых СКЗИ.

Required

sign

String<string>

Подпись перевода/ответа.

Required

serial

String<string>

Серийный номер сертификата.

data

Object

Required

sourceCode

String<string>

Код источника пополнения.

Required

sourceId

String<string>

Уникальный номер пополнения отправителя.

operationTraceId

String<string>

Сквозной идентификатор операции во всех системах.

Required

amount

String<string>

Сумма пополнения в минорных единицах.

currency

String<string>

Валюта перевода. Допустимые значения:

643 — рубль,
840 — доллар,
978 — евро,
826 — фунт.

Если не передается — считается, что перевод осуществлен в рублях.

Required

paymentDate

String<date-time>

Время регистрации транзакции в формате ГГГГ-ММ-ДДTЧЧ:MM:CC.МССZ.

billingAmount

String<string>

Сумма платежа в валюте счета (в минорных единицах) после конвертации.

remarks

String<string>

Примечание — сообщение отображается получателю.

mfo

String<string>

БИК банка получателя.

destination

Object

Реквизиты пополнения.

agreementNumber

String<string>

Номер договора.

phoneNumber

String<string>

Номер телефона клиента.

accountNumber

String<string>

Номер счета.

cardNumber

String<string>

Номер карты.

clientId

String<string>

Идентификатор клиента.

senderInfo

Object

Информация об отправителе.

lastName

String<string>

Фамилия.

firstName

String<string>

Имя.

midName

String<string>

Отчество.

inn

String<string>

ИНН.

phone

Number<bigint>

Телефон в международном формате без ведущих нулей и «+».

placeOfBirth

String<string>

Место рождения.

dateOfBirth

String<date>

Дата рождения в формате yyyy-mm-dd.

docType

String<string>

Тип документа.

docSeries

String<string>

Серийный номер документа.

docNo

String<string>

Номер документа.

docDate

String<date>

Дата получения документа в формате yyyy-mm-dd.

docIssueWhere

String<string>

Кем выдан документ.

docIssueWhereCode

String<string>

Код подразделения, выдавшего документ.

address

String<string>

Адрес.

mfo

String<string>

БИК банка.

citizenshipCode

String<string>

Двухбуквенное обозначение страны гражданства плательщика.

billingAccount

String<string>

Счет плательщика в банке плательщика.

cardNumber

String<string>

Номер карты (PAN).

extraInfo

String<string>

Дополнительная информация.

pinblock

String<string>

Зашифрованный пинблок — 16 HEX-цифр.

pointInfo

Object

Информация об УС.

String<string>

Идентификатор пункта приема.

city

String<string>

Город расположения пункта приема.

addr

String<string>

Место расположения пункта приема.

agnt

String<string>

Название юридического лица пункта приема перевода.

country

String<string>

Страна расположения пункта приема в формате ISO 3166-1 alpha-3, трехбуквенная система. По умолчанию проставляется RUS (Россия).

type

String<string>

Тип устройства:

1 — касса (прием наличных);
2 — терминал самообслуживания (прием наличных);
3 — банкомат (прием по карте);
4 — банкомат (прием наличных);
5 — электронный кошелек;
6 — интернет-банк/мобильный банк;
7 — мобильная коммерция.

Ответ

200

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку