3.52. /api/3ds/v1/upload-cres-result

После получения значения cRes по адресу notificationURL загрузите результаты запросом HTTP POST на указанные ниже URL и параметры.

API URL

Примечание

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

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

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

https://sandbox.sbctech.ru/paynet/api/3ds/v1/upload-cres-result/ENDPOINTID

https://gate.sbctech.ru/paynet/api/3ds/v1/upload-cres-result/ENDPOINTID

https://sandbox.sbctech.ru/paynet/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID

https://gate.sbctech.ru/paynet/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID

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

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

Max Length

Описание

cRes

4096

Сообщение CRes — это ответ ACS на сообщение CReq. Оно указывает результат аутентификации держателя карты.

orderid

128

Идентификатор заказа, присвоенный SBC.

login

20

Логин Присоединяющейся Стороны в Платёжном Шлюзе.

client-order-id

128

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

control

40

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

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

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

Описание

type

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

paynet-order-id

Идентификатор заказа, присвоенный SBC.

merchant-order-id

Торговец order id.

serial-number

Уникальный номер, присвоенный сервером SBC конкретному запросу от торговца.

error-message

Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке.

error-code

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

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

POST /paynet/api/3ds/v1/upload-cres-result/39529 HTTP/1.1
User-Agent: curl/7.83.0
Accept: */*
Content-Length: 495
Content-Type: application/x-www-form-urlencoded
Connection: close

cres=ewogICJtZXNzYWdlVHlwZSIgICAgOiAiQ1JlcyIsCiAgIm1lc3NhZ2VWZXJzaW9uIiA6ICIyLjEuMCIsCgogICJ0aHJlZURTU2VydmVyVHJhbnNJRCIgOiAiZDAwYTdhZmUtMmE0ZC00NmI0LThmN2YtZjRlZmFkZjE0MmIzIiwKICAiYWNzVHJhbnNJRCIgICAgICAgICAgIDogImFjYWMwMzAxLTVlMWItNDk3Yy04NzA0LTZkNTU5NTc1YTRmZSIsCgogICJjaGFsbGVuZ2VDb21wbGV0aW9uSW5kIiA6ICJZIiwKICAidHJhbnNTdGF0dXMiICAgICAgICAgICAgOiAiWSIKfQ==
&orderid=6684126
&control=d0539beedb9a7266547530c8d2027f2b14503a61
&login=test1
&client-order-id=1e21f041-871d-4642-a6d9-968457df47a0

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

HTTP/1.1 200
Server: server
Date: Wed, 17 Nov 2021 11:03:17 GMT
Content-Type: text/html;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Keep-Alive: timeout=60
Vary: Accept-Encoding
X-XSS-Protection: 1
Strict-Transport-Security: max-age=31536000
Content-Language: ru-RU
P3P: CP="NOI ADM DEV COM NAV OUR STP"
Content-Encoding: gzip

type=async-response
&serial-number=00000000-0000-0000-0000-000002d6202d
&merchant-order-id=1e21f041-871d-4642-a6d9-968457df47a0
&paynet-order-id=6684126

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

HTTP/1.1 200
Server: server
Date: Wed, 17 Nov 2021 11:03:17 GMT
Content-Type: text/html;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Keep-Alive: timeout=60
Vary: Accept-Encoding
X-XSS-Protection: 1
Strict-Transport-Security: max-age=31536000
Content-Language: ru-RU
P3P: CP="NOI ADM DEV COM NAV OUR STP"
Content-Encoding: gzip

type=validation-error
&serial-number=00000000-0000-0000-0000-000002b36f64
&merchant-order-id=inv4097763
&error-message=End+point+with+id+22903+not+found
&error-code=3

Open API Collection

Open this method in the OpenAPI Reference

View in OpenAPI

Коллекция Postman

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

URL
cres

Input CRes message

login

input Login

client_orderid

input Invoice Number

orderid

input sandbox.sbctech.ru Transaction Number

merchant_control

input Control Key

String to sign
Signature