Инструменты страницы

Запрос на создание профиля клиента

В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:

  • string – строка;
  • array - массив данных;
  • object - объект данных;
  • data - дата;
  • boolean - булевый (логический) тип данных;
  • int. (integer) - целочисленный тип данных;
  • amount - числовой тип данных (сумма).

Список параметров запроса:

Параметр Тип Обязательность Описание Пример заполнения

transactionNumber

string

Да

Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций.

7654321DS

merchantLogin

string Да

Идентификатор партнёра, полученный при регистрации в платёжном шлюзе.

petrovich

contacts

array

Да

Массив клиентских данных

type

string

Да

Тип передаваемого контактного средства. Возможны следующие значения:

  • MPHONE - мобильный телефон;
  • EMAIL - электронная почта.
EMAIL

value

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>"
      }
    ]
}

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

Параметр Тип Обязательность Описание Пример заполнения

client

object

Да

Массив клиентской информации

uuid

string Да

Идентификатор клиента, длина 32.

C2BC84C12AD6438DAA0D87517C7AE187

createdDate

date

Да

Дата создания клиента.

07.09.2017 17:43:57.768

accessCode

string

Да

Код доступа, генерируемый платёжным шлюзом.

i1WsRn1uB1ehfbb37

requestId

string

Да

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

gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew

status

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>"
}