3.3. /api/v2/create-card-ref

Введение

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

API URL

Интеграционная среда	Производственная среда
https://sandbox.sbctech.ru/paynet/api/v2/create-card-ref/ENDPOINTID	https://gate.sbctech.ru/paynet/api/v2/create-card-ref/ENDPOINTID
https://sandbox.sbctech.ru/paynet/api/v2/create-card-ref/group/ENDPOINTGROUPID	https://gate.sbctech.ru/paynet/api/v2/create-card-ref/group/ENDPOINTGROUPID

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

Note

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

Параметры запроса	Описание
login	Логин Присоединяющейся стороны в Системе.
client_orderid	Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной.
orderid	Идентификатор заказа, присвоенный Платёжным Шлюзом.
control	Контрольная сумма, сгенерированная SHA-1. Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса: login 2. Параметр запроса: client_orderid 3. Параметр запроса: orderid 4. merchant_control (Контрольный ключ, назначенный для учетной записи Присоединяющейся Cтороны в SBC).

Присоединяющаяся сторона должна предоставить orderid и client_orderid первого платежа. Это подчеркивает необходимость проведения первого платежа для последующей регистрации платёжного метода и повторных оплат. Для списания средств информация о платёжном методе должна быть полной и первый платёж должен быть в финальном статусе.

The returned Recurring Payment ID and/or Card Reference ID is a token that refers to cardholder data stored on Payment Gateway side. See the required API command to find which type of token is supported in request parameters. This ID has the following usage: 1. In direct API commands it can be passed instead of cardholder data to initiate new transaction. 2. In form API commands it can be passed to prefill the payment form with previously saved cardholder data.

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

Note

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

Параметры ответа	Описание
type	Тип ответа. Может принимать такие значения как - async-response, validation-error, error и т.д. Если тип равен validation-error или error, параметры error-message и error-code будут содержать сведения об ошибке.
serial-number	Уникальный номер, присвоенный сервером SBC конкретному запросу от Присоединяющейся Стороны.
card-ref-id	Ссылочный идентификатор, для использования в повторных оплатах.
unq-card-ref-id	Уникальный ссылочный идентификатор для каждого уникального средства платежа (PAN, номер аккаунта). Может использоваться Присоединяющейся стороной для программ лояльности или защиты от мошенничества.
status	См. список статусов.
error-message	Для транзакций в статусе declined или error этот параметр будет содержать причину отклонения или сведения об ошибке.
error-code	Код ошибки для транзакций в статусе declined или error.

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

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

login=login
&client_orderid=902B4FF5
&orderid=6937242
&control=717349cab3fcab2c13c93ff5770ae07a7b8e0727

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

HTTP/1.1 200
Server: server
Date: Tue, 07 Feb 2023 08:46:24 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: 144

type=create-card-ref-response
&serial-number=00000000-0000-0000-0000-000002e110a2
&card-ref-id=1461670
&unq-card-ref-id=2463777
&status=approved

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

HTTP/1.1 200
Server: server
Date: Tue, 07 Feb 2023 08:55:26 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: 123

type=validation-error
&serial-number=00000000-0000-0000-0000-000002e110ad
&error-message=INVALID_CONTROL_CODE
&error-code=2

Коллекция Postman

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

endpointid or groupid	input ENDPOINTID or ENDPOINTGROUPID
login
client_orderid	input Invoice Number
orderid
merchant_control	input Control Key

String to sign

Signature