Assalam Docs
API Reference

Карты

Список привязанных карт, чтение и отвязка

Карты, которые ваши клиенты уже привязали и подтвердили кодом из СМС. Номер карты не возвращается ни одним методом — только маска: полного номера у нас нет. Базовый адрес, заголовки и формат ошибки — общие правила.

Список карт

GET/subscribe/v1/cards

Параметр customerRef фильтрует карты одного вашего клиента.

Поле

Тип

Запрос
curl "https://api.assalam.uz/subscribe/v1/cards?customerRef=user_1024" \
  -H "Authorization: Bearer sk_test_..."
Ответ
{
  "object": "list",
  "data": [
    {
      "id": "cmsr7d1e",
      "object": "payment_method",
      "maskedPan": "860031******3131",
      "status": "ACTIVE",
      "holderName": "TEST CARDHOLDER",
      "bankName": "Asia alliance bank",
      "processingSystem": "UZCARD",
      "customerRef": "user_1024",
      "failureCode": null,
      "livemode": false,
      "created": "2026-08-14T09:12:00.000Z"
    }
  ],
  "has_more": false
}

Одна карта

GET/subscribe/v1/cards/{id}

Карта другого продукта или другого режима вернёт 404.

Запрос
curl https://api.assalam.uz/subscribe/v1/cards/cmsr7d1e \
  -H "Authorization: Bearer sk_test_..."
Ответ
{
  "id": "cmsr7d1e",
  "object": "payment_method",
  "maskedPan": "860031******3131",
  "status": "ACTIVE",
  "processingSystem": "UZCARD",
  "customerRef": "user_1024",
  "livemode": false
}

Отвязать карту

DELETE/subscribe/v1/cards/{id}

После отключения списания по карте невозможны. Действие необратимо: чтобы списывать снова, клиент привязывает карту заново.

Запрос
curl -X DELETE \
  https://api.assalam.uz/subscribe/v1/cards/cmsr7d1e \
  -H "Authorization: Bearer sk_test_..."
Ответ
{
  "id": "cmsr7d1e",
  "object": "payment_method",
  "status": "DISABLED",
  "maskedPan": "860031******3131"
}

Прежний адрес POST /subscribe/v1/cards/{id}/disable продолжает работать и делает то же самое. В новом коде используйте DELETE.

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