API Reference
Возвраты
Метод существует, но банк операцию не передал
Возврат на карту сейчас невозможен
Банк не передал нам операцию реверса. В боевом режиме POST /v1/refunds
создаёт возврат и тут же помечает его FAILED с кодом NOT_SUPPORTED —
деньги не двигаются. Возврат покупателю оформляется в банке вручную.
Метод описан целиком, потому что в тестовом режиме он работает полностью: сценарий возврата можно написать и проверить заранее, и переключение на боевой ключ не потребует правок в коде — изменится только исход. Что ещё недоступно — «Чего пока нельзя». Базовый адрес, заголовки и формат ошибки — общие правила.
Создать возврат
POST
/v1/refundsПолный или частичный возврат по успешному платежу. Требует заголовок
Idempotency-Key.
Поле
Тип
curl -X POST https://api.assalam.uz/v1/refunds \
-H "Authorization: Bearer sk_test_..." \
-H "Idempotency-Key: refund-1024" \
-H "Content-Type: application/json" \
-d '{
"paymentIntentId": "cmsr1a2b",
"amount": 1000000,
"reason": "частичный отказ"
}'{
"id": "cmsr5c4d",
"object": "refund",
"paymentIntentId": "cmsr1a2b",
"amount": 1000000,
"status": "SUCCEEDED",
"failureCode": null,
"created": "2026-08-14T11:00:00.000Z"
}{
"id": "cmsr5c4d",
"status": "FAILED",
"failureCode": "NOT_SUPPORTED"
}