3.11. /api/v2/get-card-info

Введение

Для интеграции используйте запрос интеграционной среды HTTPS POST к указанным ниже URL и параметрам. Для аутентификации используйте SHA-1. См. статусы.

API URL

Примечание

Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.

Интеграционная среда

Производственная среда

https://sandbox.sbctech.ru/paynet/api/v2/get-card-info/ENDPOINTID

https://gate.sbctech.ru/paynet/api/v2/get-card-info/ENDPOINTID

https://sandbox.sbctech.ru/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID

https://gate.sbctech.ru/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID

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

Примечание

Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.

Название параметра

Описание

Значение

login

Логин Присоединяющейся стороны в Системе.
Необходимость: Обязательно
Тип: String
Длина: 20

cardrefid

ИД ссылки на карту, полученный на шаге Регистрации Карты.
Необходимость: Обязательно
Тип: String
Длина: 20

control
Контрольная сумма, сгенерированная SHA-1. Строка для подписи представляет собой объединение следующих параметров:
1. Параметр запроса: login
2. Параметр запроса: cardrefid
3. merchant_control (Контрольный ключ, присвоенный аккаунту Присоединяющейся стороны в системе шлюза SBC).
Необходимость: Обязательно
Тип: String
Длина: 128

Параметры ответа

Примечание

Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.

Information Параметры ответа

Описание

type
Тип ответа. Может быть get-card-info-response, validation-error, error.
Если type равен error, параметры error-message и error-code содержат детали ошибки.

serial-number

Уникальный номер, присваиваемый сервером SBC конкретному запросу от Присоединяющейся стороны.

card-printed-name

Карта holder’s название.

bin

Bank Identification Number.

last-four-digits

Последние четыре цифры PAN.

expire-year

Год срока действия карты.

expire-month

Месяц срока действия карты.

result-3d

Описание: 3DS completion result.

error-message

Если статус validation-error или error, этот параметр содержит причину отклонения или детали ошибки.

error-code

Код ошибки в случае статуса validation-error или error.

Пример запроса

POST /paynet/api/v2/get-card-info/46750 HTTP/1.1
Host: https://sandbox.sbctech.ru
User-Agent: curl/7.85.0
Accept: */
Content-Length: 77
Content-Type: application/x-www-form-urlencoded
Connection: close

&login=Test
&cardrefid=1461665
&control=f8ffd7dac9e334799862da0e9190387510d43ff7

Пример успешного ответа

HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 11:21:39 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 193

type=get-card-info-response
&serial-number=00000000-0000-0000-0000-000002e0d218
&card-printed-name=CARD+HOLDER
&bin=453897
&last-four-digits=6732
&expire-year=2099
&expire-month=12
&result-3d=F

Пример неуспешного ответа

HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 11:26:22 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 136

type=validation-error
&serial-number=00000000-0000-0000-0000-000002e0d21f
&error-message=End+point+with+id+99999+not+found
&error-code=3

Open API Collection

Open this method in the OpenAPI Reference

View in OpenAPI

Коллекция Postman

Конструктор запросов

endpointid or groupid

input ENDPOINTID or ENDPOINTGROUPID

login
card-ref-id
merchant_control

input Control Key

String to sign
Signature