В главное меню

Передача иконок банков и платёжных систем


Описание

Для получения доступа к методу необходимо запросить и согласовать получение Client-Id и Api-Key у техподдержки.

Входные параметры

Заголовок запроса

POST
Endpoint: https://sandbox.pay.mts.ru/public/v1.1/merchant/card/info HTTP/1.1
Content-Type: application/json
<Основные параметры>

Основные параметры:

ПолеТипОбяз.Описание
Request-IdguidдаИдентификатор конкретного запроса
Client-IdstringдаИдентификатор клиента
Api-KeystringдаКлюч клиента
Requestor-Namestringнет

Наименование сервиса.

  • Для API - имя вызывающей системы.
Requestor-Typestringнет

Тип витрины

  • API
Requestor-VersionstringнетВерсия виджета/sdk

Тело запроса

ПолеТипОбяз.Описание
binintegerда

bin-карты

Валидация: 6 цифр

Выходные параметры

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

ПолеТипОбяз.Описание
bankNamestringдаНаименование банка
paymentSystemstringда

Наименование платёжной системы

• VISA
• MASTERCARD
• MIR
• CUP
• UNKNOWN

bankImgstringдаСсылка на каталог с изображениями банка
paymentSystemImgstringдаСсылка на каталог с изображениями платёжной системы

Примеры

Запрос

Заголовок

POST
Endpoint: /public/v1.1/merchant/card/info HTTP/1.1
Content-Type: application/json
<Основные параметры> (пример в описании)

Тело

{
   "bin": "123456"
}

Ответ

Заголовок

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело

{
  "bankName": "МТС Банк",
  "paymentSystem": "VISA",
  "bankImg": "https://pay.mts.ru/assets/images/bank/MTSBANK/",
  "paymentSystemImg": "https://pay.mts.ru/assets/icons/paymentTools/cardVisa/"
}

Возможные коды ошибок

Коды и описание представлено в таблице:

codemessageuserMessageisFatal
00199998Validation errorНе пройдена валидация данныхнет
00199999An unexpected error has occurredНепредвиденная ошибкада
00100005Missing required header {0}Отсутствует обязательный заголовокда
00100060UnauthorizedАвторизация не пройденанет