Для того чтобы получить детальную информацию по счёту, необходимо вызвать функцию веб-сервиса getInvoiceDetails.
|
Параметр |
Описание |
|---|---|
|
ucode |
Уникальный номер счёта в системе «Инвойсбокс» |
|
sign |
Подпись запроса |
Подпись запроса
При использовании базового варианта безопасности с MD5, магазину необходимо добавить в запросы параметр с именем sign (подпись запроса). Значение параметра — MD5-хэш от строки, собранной из значений параметров этого же запроса вместе с ключом безопасности.
При получении запроса от магазина, система «Инвойсбокс» будет проверять параметр подписи sign. Если значение sign не совпадает с результатом расчёта хэш-функции MD5 от переданных параметров, в обработке запроса будет отказано.
MD5-хэширование применяется к тексту, который формируется как последовательность значений ряда параметров запроса без разделителей. Результат хэширования приводится к нижнему регистру.
Порядок следования параметров:
|
Параметр |
Описание |
|---|---|
|
resultCode |
Код результата выполнения функции |
|
resultMessage |
Описание кода результата выполнения функции |
|
ucode |
Уникальный номер счёта в системе «Инвойсбокс» |
|
participantOrderId |
Номер заказа магазина, присвоенный заказу в системе учёта магазина |
|
description |
Описание заказа или назначение платежа |
|
amount |
Стоимость заказа |
|
personName |
Фамилия, имя и отчество плательщика или наименование организации |
|
personPhone |
Номер мобильного телефона плательщика. |
|
personEmail |
Адрес электронной почты плательщика |
|
agentPayment |
Статус оплаты счёта, 1 – средства по счёту поступили, 0 – счёт не оплачен |
|
agentPaymentTime |
Время оплаты счёта в формате ATOM |
|
agentPaymentName |
Место оплаты |
|
timecreate |
Время создания счёта в формате ATOM |
|
timelimit |
Срок оплаты счёта в формате ATOM |
|
enabled |
Статус отмены счёта, 1 – счёт активен, 0 – счёт удалён. Обратите внимание, что средства по удалённым счетам не отправляются, при этом, счёт может быть оплаченным, но удалённым. В данном случае, решение о необходимости перевода средств в магазин принимается службой поддержки системы «Инвойсбокс». В случае, если заказ на стороне магазина восстановить невозможно, средства возвращаются плательщику. |
В случае успешного выполнения функции, веб-сервис вернёт значение resultCode=0. В случае возникновения ошибки, веб-сервис вернёт детальное описание такой ошибки в параметре resultMessage, при этом значение параметра resultCode не будет равняться нулю.
Читать далее: отмена счёта и возврат средств →
