Assalam Docs
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"
}

На этой странице