|
|
35дд. Руководство оператора Документ предназначен для внутреннего использования Введение 4 Вход в систему 5
Подтверждение заказа производится в фоновом режиме. Результат выполнения операции на адрес, заданный в АРМ или переданный в параметре BACKREF основной операции.
Получение статуса заказа через API |
Запрос для получения статуса заказа должен быть в отправлен в ecom методом POST на адрес https://host/ecom/api
Параметры запроса:
Наименование
|
Обязательность
|
Формат
|
Описание
|
ORDER
|
Да
|
N(6 - 22)
|
Номер заказа, должен быть тот-же что и в операции заказа
|
MERCHANT
|
Да
|
C(6 - 15)
|
Идентификатор коммерсанта
|
GETSTATUS
|
Да
|
С(1)
|
«1» – получить текущий статус заказа в результате запроса
|
P_SIGN
|
Да
|
C(80 - 250)
|
Подпись
|
LANGUAGE
|
Нет
|
С(2)
|
Язык результата, «ru» (по умолчанию) или «en»
|
Алгоритм формирования подписи в поле P_SIGN следующий: нужно собрать в одну строку значения полей (ORDER;MERCHANT) через разделитель «;», затем добавить эту строку к значению секретного ключа SHARED_SECRET (этот ключ индивидуальный для каждого коммерсанта), и вычислить из полученной строки значение хэш SHA512. Например, на PHP это будет выглядеть примерно так:
vSign=hash("sha512",C_SHARED_KEY.$_POST["ORDER"].";".$_POST["MERCHANT);
Пример вычисления подписи есть в странице примера https://host/eCom/static/e/test_getStatus.html.
Обратите внимание! В продуктовой системе хэш должен вычисляться не в браузере на стороне клиента, а в процедуре на стороне веб-сервера коммерсанта! Пример на странице test_getStatus.html – только для тестирования, секретный ключ SHARED_SECRET ни в коем случае не должен быть доступен кому-либо вне Вашего сервера!
В ответe запроса при GETSTATUS=1 вернется текущий статус заказа в формате XML:
0
Платеж успешный
S
Обработано успешно
60
KZT
Операция
client@gmail.com
ru
13123123
1234143
444444***4444
04.11.2020 11:47:31
0
Ошибка доступа
00
123123322
b7ba742fc647b62c
1
F
Ошибка возврата
59
602222
S
Обработано успешно
00
59
описание
0
04.11.2020 13:40:55
|
Код результата запроса
Описание кода результата запроса
Текущий статус операции
Описание статуса операции
Сумма операции
Валюта операции
Краткое описание операции
Полное описание операции
Email клиента
Язык клиента
Уникальный номер заказа MPI
Терминал
Телефон клиента (в сч. на оплату)
Карта клиента
Имя клиента на карте
Дата устаревания карты
Токен карты
Дата создания операции
Код результата операции MPI
Описаине кода результата MPI
Код результата MPI
RRN операции
Auth code операции
Идентификатор счета на оплату
Дата устаревания счета на оплату
Остаток суммы возврата
Частота рекуррентных платежей
Референс (RRN) рекур. Платежа
Внутр. референс рекур платежа
Идентификатор клиента у коммерса
Карта получателя
Токен карты получателя
Список возвратов
Текущий статус возврата
Описание статуса возврата
RC возврата
Сумма возврата
Описание возврата
Ошибка возврата
Дата возврата
Текущий статус возврата
Описание статуса возврата
RC возврата
Сумма возврата
Описание возврата
Ошибка возврата
Дата возврата
|
Возможные статусы:
Код
|
Описание (ru)
|
Описание (en)
|
N
|
В очереди на обработку
|
New
|
S
|
Обработано успешно
|
Success
|
E
|
Ошибка при оплате
|
Error
|
R
|
Возврат отработал успешно
|
Reversal is OK
|
J
|
Возврат отказан
|
Reversal rejected
|
F
|
Ошибка при обработке возврата
|
Reversal error
|
r
|
Ожидание возврата
|
Wait to reversal
|
W
|
Ожидание
|
Wait
|
w
|
Ожидание подтверждения возврата в течение 1 часа
|
Wait to approve reversal 1 hour
|
n
|
Платеж в ожидании обработки более 1 часа или требуется ручная обработка
|
Payment pending more than 1 hour or manual processing required
|
I
|
Счет на оплату в очереди на обработку
|
Invoice new
|
C
|
Счет на оплату отменен
|
Canceled invoice
|
c
|
Счет на оплату устарел
|
Expired invoice
|
Получение списка заказов через API |
Запрос для получения списка заказов должен быть в отправлен в ecom методом POST на адрес https://host/ecom/api
Параметры запроса:
Наименование
|
Обязательность
|
Формат
|
Описание
|
MERCHANT
|
Да
|
C(6 - 15)
|
Идентификатор коммерсанта
|
TERMINAL
|
Нет
|
C(6 - 8)
|
Идентификатор терминала
|
DATE_FROM
|
Да
|
С(18)
|
Дата, с которой запрашивается список операций, в формате DD.MM.YYYY HH:MI:SS
|
DATE_TO
|
Нет
|
С(18)
|
Дата, по которую запрашивается список операций, в формате DD.MM.YYYY HH:MI:SS
|
P_SIGN
|
Да
|
C(80 - 250)
|
Подпись
|
LANGUAGE
|
Нет
|
С(2)
|
Язык результата, «ru» (по умолчанию) или «en»
|
Алгоритм формирования подписи в поле P_SIGN следующий: нужно собрать в одну строку значения полей (DATE_FROM;DATE_TO;TERMINAL;MERCHANT) через разделитель «;», затем добавить эту строку к значению секретного ключа SHARED_SECRET (этот ключ индивидуальный для каждого коммерсанта), и вычислить из полученной строки значение хэш SHA512. Например, на PHP это будет выглядеть примерно так:
vSign=hash("sha512",C_SHARED_KEY.$_POST["DATE_FROM "].";".$_POST["DATE_TO "].";".$_POST["TERMINAL"].";".$_POST["MERCHANT"];
Пример вычисления подписи есть в странице примера https://host/eCom/static/e/test_getStmt.html.
Обратите внимание! В продуктовой системе хэш должен вычисляться не в браузере на стороне клиента, а в процедуре на стороне веб-сервера коммерсанта! Пример на странице test_getStmt.html – только для тестирования, секретный ключ SHARED_SECRET ни в коем случае не должен быть доступен кому-либо вне Вашего сервера!
В ответe запроса вернется список заказов в формате XML:
0
Платеж успешный
S
13123123
S
Обработано успешно
60
KZT
123456
444444***4444
Операция
client@gmail.com
ru
04.11.2020 11:47:31
0
Ошибка доступа
00
123123322
123123
b7ba742fc647b62c
1.23
10
20251231
|
Код результата запроса
Описание кода результата запроса
Номер заказа
Уникальный номер заказа MPI
Текущий статус операции
Описание статуса операции
Сумма операции
Валюта операции
Терминал
Id клиента
Карта плательщика
Имя клиента на карте плательщика
Дата устаревания карты плательщика
Токен карты плательщика
Краткое описание операции
Полное описание операции
Email клиента
Язык клиента
Телефон клиента
Дата создания операции
Код результата операции MPI
Описаине кода результата MPI
Код результата MPI
RRN операции
Internal ref операции
Auth code операции
Идентификатор счета на оплату
Дата устаревания счета на оплату
Остаток суммы возврата
Частота рекуррентного платежа
Дата завершения рекур. платежа
RRN первой опер. рекур. платежа
INT_REF перв. опер.рекур. платежа
Карта получателя перевода
Токен карты получателя
|
|
|
|
Скачать 2.53 Mb.