URL: https://api.oson.uz/api/invoice/create
Method: POST
Content-type: application/json
curl -X POST https://api.oson.uz/api/invoice/create \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'token:ogN0Q9ROGN6WdrIeGtQmwUdSL**********' \
-d '{
"merchant_id": 1474,
"transaction_id": "123456789",
"phone": "998987654321",
"user_account": "user@mail.com",
"amount": 1000.00,
"currency": "UZS",
"comment": "Оплата заказа №51",
"return_url": "http://merchant.site.uz/return_URL",
"lifetime": 30,
"lang": "ru"
}'
Повторный запрос на создание счета с таким же "merchant_id" и "transaction_id" возвратит статус ранее созданного счета вместо его создания.
Описание полей запроса:
Параметр | Описание | Тип | Обязательное |
---|---|---|---|
merchant_id | Уникальный ID мерчанта | int | + |
transaction_id | Уникальный идентификатор счета в системе мерчанта | string(36) | + |
phone | Номер телефона пользователя, на который выставляется счет | string | - |
user_account | Идентификатор пользователя в системе мерчанта | string(36) | + |
amount | Сумма счета, округленная до 2 знаков после запятой в меньшую сторону. Тестовая сумма 1000 сум | number(6.2) | + |
currency | Валюта счета "UZS" | string(3) | + |
comment | Комментарий к счету | string(255) | - |
return_url | URL на который следует перенаправить покупателя после завершения оплаты | string | - |
lifetime | Время жизни платежа с момента создания (в минутах), по умолчанию 10 дней | int | - |
lang | Язык платежной формы, uz - узбекский, en - английский, ru - русский | string(2) | - |
{
"status": "REGISTRED",
"transaction_id": "123456789",
"bill_id": 70440,
"pay_url": "https://pay.oson.uz/checkout/6155107066810930",
"error_code": 0,
"message": "Success"
}
Описание полей ответа:
Параметр | Описание | Тип |
---|---|---|
error_code | Код ошибки | int |
message | Детальное описание ошибки | string |
status | Статус данного платежа | string |
transaction_id | Уникальный идентификатор счета в системе мерчанта | string |
bill_id | Уникальный идентификатор счета OSON | int64 |
pay_url | Ссылка для переадресации пользователя на созданную платежную форму | string |