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


Метод позволяет выставить счет, при успешном выполнении запроса в ответе вернется параметр pay_url - ссылка для редиректа пользователя на платежную форму.

URL: https://core.oson.uz:8443/api/invoice/create
Method: POST
Content-type: application/json

Пример запроса: -->
curl -X POST https://core.oson.uz:8443/api/invoice/create \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'token:ogN0Q9ROGN6WdrIeGtQmwUdSL**********' \
-d '{
  "merchant_id": 1500,
  "transaction_id": "123456789",
  "phone": "998991234567",
  "user_account": "user@mail.com",
  "amount": 5000.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 знаков после запятой в меньшую сторону 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

Статусы счетов:

Статус Описание
REGISTRED Счет выставлен, ожидает оплаты
PAID Счет оплачен
DECLINED Счет отклонен
ON_PROGRESS Счёт в процессе оплаты
PAY_ERROR Ошибка при оплате счёта
EXPIRED Время жизни счета истекло. Счет не оплачен
RETURNED Полный возврат суммы пользователю