3.15. /api/v2/card-insurance-document

Введение

Для получения документа о страховании необходимо инициировать HTTPS POST запрос с использованием указанных ниже URLs и передать указанные parameters. Запрос подписывается с помощью OAuth HMAC-SHA1. См. Статусы.

Note

После успешного завершения транзакции, необходимо сформировать запрос для скачивания условий страхования с данными плательщика в формате PDF.

API URLs

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

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

https://sandbox.sbctech.ru/paynet/api/v2/card-insurance-document/ENDPOINTID

https://gate.sbctech.ru/paynet/api/v2/card-insurance-document/ENDPOINTID

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

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

Описание

client-order-id

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

order_id

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

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

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

Описание

request_serial_number

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

document_path

Ссылка для скачивания документа

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

POST /paynet/api/v2/card-insurance-document/3213 HTTP/1.1
User-Agent: curl/8.7.1
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="merchantlogin",oauth_signature_method="HMAC-SHA1",oauth_signature="IibClG%2FGfoxiGvKSyRovTH0P1Pg%3D"
Content-Length: 120
Content-Type: application/x-www-form-urlencoded
Connection: close

client-order-id=Value&oauth_consumer_key=merchantlogin&oauth_signature_method=HMAC-SHA1&oauth_version=1.0&order_id=Value

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

{
  "request_serial_number": "00000000-0000-0000-0000-000001fd4472",
  "document_path": "https://sandbox.sbctech.ru/paynet/api/v2/download/card-ins-12345678912345678912"
}

Note

Полученная ссылка должна быть отображена в браузере плательщика.

Warning

Файл доступен для одного скачивания.

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

HTTP/1.1 403
Server: server
Date: Fri, 14 Feb 2025 10:27:47 GMT
Content-Type: application/x-www-form-urlencoded;charset=UTF-8
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Length: 102

type=error
&serial-number=00000000-0000-0000-0000-000002f38fde
&error-message=Forbidden
&error-code=-1

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

HTTP method
URL
parameters
version
consumer key
consumer secret
timestamp

nonce

signature method

normalized parameters
signature base string
signature
authorization header