API Reference
Заказы
Создание заказа, чтение, отмена
Заказ — это сумма к оплате и ссылка, по которой покупатель платит на нашей
странице. Базовый адрес, авторизация, заголовок Idempotency-Key и формат
ошибки описаны в общих правилах.
Создать заказ
POST
/merchant/v1/ordersСоздаёт заказ и ссылку на оплату. Требует заголовок Idempotency-Key
и ключ с областью «продажа товаров» — см. «Ключи и режимы».
Поле
Тип
curl -X POST https://api.assalam.uz/merchant/v1/orders \
-H "Authorization: Bearer sk_test_..." \
-H "Idempotency-Key: order-1024" \
-H "Content-Type: application/json" \
-d '{
"amount": 112000,
"returnUrl": "https://shop.uz/order/1024/done",
"description": "Заказ A-1024",
"customerRef": "user_42"
}'{
"id": "cmsr…",
"object": "order",
"amount": 112000,
"currency": "UZS",
"status": "PENDING",
"description": "Заказ A-1024",
"customerRef": "user_42",
"paymentUrl": "https://checkout.assalam.uz/pay/44705b…",
"returnUrl": "https://shop.uz/order/1024/done",
"saveCard": false,
"paymentIntent": null,
"expiresAt": "2026-08-21T21:42:43.813Z",
"livemode": false,
"created": "2026-08-21T21:12:43.815Z"
}Заказ и его состояние
GET
/merchant/v1/orders/{id}Опрашивать нас не нужно — об исходе приходит событие; метод на случай, если ваш сервис лежал.
curl https://api.assalam.uz/merchant/v1/orders/cmsr… \
-H "Authorization: Bearer sk_test_..."{
"id": "cmsr…",
"object": "order",
"amount": 112000,
"status": "PAID",
"paidAt": "2026-08-21T21:25:10.000Z",
"paymentIntent": "cmsr…",
"savedCard": null
}Отменить заказ
POST
/merchant/v1/orders/{id}/cancelОтменяет неоплаченный заказ. Заказ, по которому уже идёт списание, отменить
нельзя — вернётся 409.
curl -X POST https://api.assalam.uz/merchant/v1/orders/cmsr…/cancel \
-H "Authorization: Bearer sk_test_..."{
"id": "cmsr…",
"object": "order",
"status": "CANCELED"
}Список заказов
GET
/merchant/v1/ordersПоследние заказы продукта, свежие сверху. Постраничный обход по курсору:
starting_after с идентификатором последнего полученного заказа.
Поле
Тип
curl "https://api.assalam.uz/merchant/v1/orders?limit=20" \
-H "Authorization: Bearer sk_test_..."{
"object": "list",
"data": [ { "id": "cmsr…", "object": "order", "status": "PAID" } ],
"has_more": false
}