Метод для обработки онлайн запросов 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 (фунт). Если в запросе отсутствует, то считается, что перевод осуществлен в рублях.

paymentDate

String<date-time>

Время регистрации транзакции в формате ГГГГ-ММ-ДДTЧЧ:MM.МСС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

Successful operation

400

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

401

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

403

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

422

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

429

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

500

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

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

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