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.