Выставление счета Merchant| PayBox Россия

Вы инициируете выставление счёта, отправив запрос на v5/merchant/invoice/init
Оплата выставления счета происходит в два этапа:

Инициализация счёта
Проведение оплаты счёта

Инициализация счёта

URL запроса:
POST https://api.freedompay.money/v5/merchant/invoice/init
Поля запроса:

Выставить счёт

Авторизация запроса происходит путем формирования и передачи JWS токена запроса в заголовке X-JWS-Signature.
Формат передаваемых данных application/json.

Авторизация

Выставление счёта - это тип платежа, который использует запрос для создания веб-ссылки, по которой клиенты могут просто перейти, чтобы совершить покупки.
Выставление счёта позволяет продавцу или поставщику товаров и услуг составлять и отправлять покупателю счет на оплату на email.
Также помимо выставления счета предоставляется возможность оплаты по QR-коду, платежи, при которых клиенту требуется отсканировать QR-код.

Выставление счета

order_id required;Идентификатор платежа в системе мерчанта. Рекомендуется поддерживать уникальность этого поля. Пример: 00102;string merchant_id required;Идентификатор мерчанта в FreedomPay Выдается при подключении. integer amount required. Сумма платежа в валюте currency. Пример: 10;number description required;Описание товара или услуги. Отображается покупателю в процессе платежа. Пример: Ticket;string invoice_method required;Способ выставления счета. Значения указываются через запятую Возможные значения: qr;string currency;Валюта, в которой указана сумма. KZT, USD, EUR. В случае выбора покупателем способа платежа в другой валюте, производится пересчет по курсу ЦБ на день платежа. Пример: KZT;string check_url;URL для проверки возможности платежа. Вызывается перед платежом, если платежная система предоставляет такую возможность. Если параметр не указан, то берется из настроек магазина. Если параметр установлен равным пустой строке, то проверка возможности платежа не производится.;string result_url;URL для сообщения о результате платежа. Вызывается после платежа в случае успеха или неудачи. Если параметр не указан, то берется из настроек магазина. Является обязательным, если не задан в настройках магазина. Если параметр установлен равным пустой строке, то FreedomPay не сообщает магазину о результате платежа.;string request_method;GET, POST или XML – метод вызова скриптов магазина Check URL, Result URL, для передачи информации от платежного гейта. Пример: POST;string lifetime;Время (в секундах) в течение которого платеж должен быть завершен, в противном случае заказ при проведении платежа FreedomPay откажет платежной системе в проведении. Этот параметр контролируется FreedomPay, а также, если платежная система поддерживает такую возможность, и платежной системой. Минимально допустимое значение: 300 секунд (5 минут). Максимально допустимое значение: 604800 секунд (7 суток). В случае выхода за пограничные значения будет присвоено минимальное или максимальное значение, соответственно. Default: 86400 Пример: 86400;integer

Поля ответа:

Оплата счёта с использованием токена привязанной карты

Вы осуществляете оплату счёта с помощью токена отправив запрос на /v5/merchant/invoice/pay

URL запроса:
POST https://api.freedompay.money/v5/merchant/invoice/pay

Поля запроса:

Поля ответа:

Получить статус по счёту

Получение статуса платежа - использовать наш стандартный
URL запроса:
POST https://api.freedompay.money/v5/invoice/status

Поля запроса:

Поля ответа: