В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:
Список параметров запроса:
| Параметр | Тип | Обязательность | Описание | Пример заполнения |
|---|---|---|---|---|
|
|
string | Да |
Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций. | 7654321DS |
|
| string | Да |
Идентификатор партнёра, полученный при регистрации в платёжном шлюзе. | petrovich |
|
|
array | Да |
Массив клиентских данных | |
|
|
string | Да |
Тип передаваемого контактного средства. Возможны следующие значения:
| EMAIL |
|
| string | Да |
Значение контактного средства. | test@test.ru |
Формат запроса:
POST /api/clients/create HTTP/1.1
Host: 3dsec.sberbank.ru/sbersafe
Content-Type: application/json
Accept: application/json; version=1.0
Content-Length: <content-lenght>
{
"transactionNumber":"<transactionNumber>",
"merchantLogin":"<merchantLogin>",
"contacts": [
{
"type": "<type>",
"value": "<value>"
},
{
"type": "<type>",
"value": "<value>"
}
]
}
Параметры ответа:
| Параметр | Тип | Обязательность | Описание | Пример заполнения |
|---|---|---|---|---|
|
|
object | Да |
Массив клиентской информации |
|
|
| string | Да |
Идентификатор клиента, длина 32. | C2BC84C12AD6438DAA0D87517C7AE187 |
|
|
date | Да |
Дата создания клиента. | 07.09.2017 17:43:57.768 |
|
|
string | Да |
Код доступа, генерируемый платёжным шлюзом. | i1WsRn1uB1ehfbb37 |
|
|
string | Да |
Идентификатор запроса | gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew |
|
|
string | Да |
Указание на статус результата обработки запроса | SUCCESS |
Формат ответа:
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <content-lenght>
Cache-Control: no-store
{
"client":
{
"uuid": "<clientUuid>",
"createdDate": "<createdDate>"
},
"accessCode":"<accessCode>",
"requestId": "<requestId>",
"status": "<status>"
}