3.44. /api/scoring/v1/status

Введение

Запрос статуса скоринга карты инициируется через HTTPS GET запрос по URL с указанными ниже параметрами. Для аутентификации используется OAuth HMAC-SHA1.

API URL

Примечание

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

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

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

https://sandbox.sbctech.ru/paynet/api/scoring/v1/status/{endpoint_id}

https://gate.sbctech.ru/paynet/api/scoring/v1/status/{endpoint_id}

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

Примечание

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

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

Описание

client_orderid

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

orderid

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

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

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

Описание

type

Тип ответа. Может быть status-response.

serial-number

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

status

Код статуса первоначальной транзакции. Может быть approved, declined, processing, error или filtered. Если тип равен filtered, это означает, что транзакция была сочтена мошеннической сервером SBC.

client-order-id

Идентификатор заказа клиента

paynet-order-id

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

card-ref-id

Идентификатор, сгенерированный card-ref.

bin

Первые 6 цифр карты.

last-four-digits

Последние 4 цифры карты.

bank-name

Название банка-эмитента карты.

scoring-service-request-id

Идентификатор запроса сервиса скоринга.

scoring-service-response-id

Идентификатор ответа сервиса скоринга.

score1

Скоринг-балл 1.

score2

Скоринг-балл 2.

score3

Скоринг-балл 3.

scoring-service-response

Текстовый ответ сервиса скоринга.

error-message

Если статус:ex:declined,:ex:error или:ex:filtered, этот параметр содержит причину отклонения.

error-code

Код ошибки для транзакций в статусе:ex:declined,:ex:error,:ex:filtered.

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

GET /paynet/api/scoring/v1/status/2404?client-order-id=score123&orderid=9550
Parameters:
   client-order-id: score123
   orderid: 9550
Headers:
   accept-encoding: gzip,deflate
   authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="connectingparty",oauth_timestamp="1702073235",oauth_nonce="PSWvnfwMDH",oauth_signature_method="HMAC-SHA1",oauth_signature="lYpN%2BRi4u3tcCXJknQGVxlIGKQk%3D"

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

HTTP/2 200 OK
Date: Mon, 01 Dec 2020 11:47:18 GMT

type=scoring-status-response
&serial-number=00000000-0000-0000-0000-00010b87dbc2
&status=approved
&client-order-id=score123
&paynet-order-id=9550
&bin=555555
&last-four-digits=4444
&bank-name=WORLDBANK
&scoring-service-request-id=9550
&scoring-service-response=<?xml version="1.0" encoding="UTF-8" standalone="yes"?><response><id>9550</id><cd>0</cd><results><result><name>score</name><value>0.5820386168936834</value></result></results></response>

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

HTTP/2 403 Forbidden
Date: Mon, 01 Dec 2020 11:47:18 GMT

type=error
&serial-number=00000000-0000-0000-0000-000003da9cb1
&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