Создание нового счета на оплату происходит путем GET запроса на адрес /api/merchant/v1/startpayment
Отличие этого метода от /createinvoice состоит в том, что данный запрос не нужно подписывать ключем secret_hash, в нем не передается способ/валюта платежа (значение checkout_currency) и не происходит формирование криптовалютного адреса для оплаты.
Успешный запрос создаст страницу для оплаты по адресу https://www.cryptonator.com/merchant/invoice/<invoice_id>, на которой пользователь должен будет выбрать способ/валюту оплаты. После этого произойдет калькуляция суммы к оплате, формирование уникального адреса и отправка HTTP-уведомления с параметрами счета и проверочным хэшем.
Красным выделены обязательные параметры
Параметры запроса |
Значения |
Описание |
merchant_id |
<UUID> |
ID вашего магазина |
item_name |
<string> |
Наименование товара/услуги |
order_id |
<string> |
Номер заказа в вашей системе |
item_description |
<string> |
Описание товара/услуги |
invoice_amount |
<decimal> |
Сумма к оплате в валюте счета |
invoice_currency |
<string> bitcoin |
Валюта счета |
success_url |
<string> |
URL для редиректа после успешной оплаты
Если не задано, используется значение из настроек |
failed_url |
<string> |
URL для редиректа после ошибки/отмены оплаты
Если не задано, используется значение из настроек |
language |
<string> |
Языковая версия формы оплаты счета |