3.43. /api/scoring/v1/score

Введение

Запрос Card scoring инициируется посредством запроса HTTPS POST (с кодировкой UTF-8) к указанным ниже URL и параметрам. Для аутентификации используйте OAuth HMAC-SHA1.

API URL

Примечание

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

Интеграционная среда	Производственная среда
https://sandbox.sbctech.ru/paynet/api/scoring/v1/score/{endpoint_id}	https://gate.sbctech.ru/paynet/api/scoring/v1/score/{endpoint_id}

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

Примечание

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

Название параметра	Описание	Формат
card-ref-id	Ранее созданный вызовом create-card-ref card-ref-id позволяет найти нужную карту. О создании create-card-ref см. /api/v2/create-card-ref/. Отправляйте либо card-ref-id, либо card-number, но не оба.	N{1-*}
card-number	Полный номер карты. Отправьте card-number или card-ref-id, но не оба.	N{13-19}
client-order-id	Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной.	N{1-*}
first-name	First Name.	N{64}
last-name	Last Name.	N{64}
middle-name	Middle Name.	N{64}
birth-date	Клиент’s birth дата.	1982-07-31
rating	Описание: For example 0000.	N{4}
phone	Клиент’s full international phone номер, including страна code.	N{11}

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

Название параметра	Описание
type	Тип ответа. Может принимать такие значения как: async-response, validation-error, error и т.д. Если тип ответа validation-error или error, параметры error-message и error-code будут содержать детали ошибки.
paynet-order-id	Идентификатор заказа, присвоенный SBC.
merchant-order-id	Идентификатор заказа Присоединяющейся Стороны
serial-number	Уникальный номер, присваиваемый сервером SBC конкретному запросу от Присоединяющейся стороны.
error-message	Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке.
error-code	Код ошибки для транзакций в статусе error.

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

POST /paynet/api/scoring/v1/score/2404
Parameters:
   birth-date: 2000-01-01
   card-ref-id: 12345
   client-order-id: score123
   create-card-ref: false
   first-name: John
   last-name: Smith
   middle-name: M
   phone: 19019019191
   rating: 5
Headers:
   accept: */*
   accept-encoding: gzip,deflate
   authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="connectingparty",oauth_timestamp="1702073235",oauth_nonce="OPASWJfawifJHG",oauth_signature_method="HMAC-SHA1", oauth_signature="8FpDccqJGDwppPUnLwokfJl53Mc%3D"
   content-length: 419
   content-type: application/x-www-form-urlencoded

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

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

type=async-response
&serial-number=00000000-0000-0000-0000-00010b87db96
&merchant-order-id=score123
&paynet-order-id=9550
&end-point-id=2404

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

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
token
token secret
timestamp
nonce
signature method

normalized parameters

signature base string

Signature

authorization header

CURL