API Reference
Сессии привязки карты
Создание сессии и чтение её состояния
Сессия — одноразовое разрешение привязать одну карту. Вы создаёте её секретным ключом на сервере, клиент вводит карту на нашей странице или в вашей форме, а идентификатор карты вы забираете из состояния сессии. Базовый адрес и авторизация — в общих правилах.
Создать сессию привязки карты
POST
/subscribe/v1/card_sessionsСоздаётся вашим секретным ключом на сервере. В ответе — url для нашей
страницы и clientToken для вашей формы. Срок жизни 15 минут.
Поле
Тип
curl -X POST https://api.assalam.uz/subscribe/v1/card_sessions \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"returnUrl": "https://your.app/cards/return",
"customerRef": "user_1024"
}'{
"id": "cmsr9f2c",
"url": "https://checkout.assalam.uz/s/6a3f…",
"clientToken": "6a3f…",
"expiresAt": "2026-08-14T10:15:00.000Z",
"livemode": false
}Состояние сессии
GET
/subscribe/v1/card_sessions/{id}Статус сессии и paymentMethodId после успешной привязки. Запрашивайте
со своего сервера, когда клиент вернулся на returnUrl.
curl https://api.assalam.uz/subscribe/v1/card_sessions/cmsr9f2c \
-H "Authorization: Bearer sk_test_..."{
"id": "cmsr9f2c",
"status": "COMPLETED",
"paymentMethodId": "cmsr7d1e",
"customerRef": "user_1024",
"livemode": false,
"expiresAt": "2026-08-14T10:15:00.000Z",
"completedAt": "2026-08-14T10:03:41.000Z"
}{
"id": "cmsr9f2c",
"status": "AWAITING_CODE",
"paymentMethodId": null,
"customerRef": "user_1024"
}