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

Запрос на поиск клиента

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

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

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

Из двух параметров - phone и email - нужно указывать только один.

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

merchantLogin

string

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

our_best_merchant

phone

string

Номер телефона клиента без лидирующей «7». Параметр phone, передаваемый напрямую, не валидируется.

9171131231

email

string

Адрес электронной почты покупателя.

test@test.ru

Формат запроса: 

POST /api/clients/find HTTP/1.1
Host: 3dsec.sberbank.ru/sbersafe
Content-Type: application/json
Accept: application/json; version=1.0
Content-Length: <content-lenght>

{
  "phone": "<phone>",
  "email": "<email>"
}

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

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

client

object

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

uuid

string

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

C2BC84C12AD6438DAA0D87517C7AE187

createdDate

date

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

07.09.2017 17:43:57.768

requestId

string

{section>integration:api:params:requestId#General&noheader}} gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew

status

string

Указание на статус результата обработки запроса

SUCCESS

В случае если клиент не найден - объект client в объекте отсутствует.

Формат ответа: 

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <content-lenght>
Cache-Control: no-store
 
{
  "client": {
    "uuid": "<uuid>",
    "createdDate": "<createdDate>"
  },
  "requestId":"<requestId>",
  "status": "<status>"
}