Документация/Подписки/Создать подписку
Создать подписку
POST/api/v1/subscriptions
Рекуррентные списания по расписанию.
HMACIdempotency-Key requiredcreateSubscription
Параметры тела
| Поле | Тип | Описание |
|---|---|---|
| mandate_idreq | uuid | |
| amount_minorreq | int64 | |
| currencyreq | string | |
| interval_unitreq | "day" | "week" | "month" | "year" | |
| interval_countreq | integer | |
| first_run_at | date-time |
Пример
Запрос
POST /api/v1/subscriptions
Idempotency-Key: order-20260817-001
{
"mandate_id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02",
"amount_minor": 1001,
"currency": "EUR",
"interval_unit": "day",
"interval_count": 1
}Ответ 201
{
"id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02",
"mandate_id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02",
"amount_minor": 1001,
"currency": "EUR",
"interval_unit": "day",
"interval_count": 1,
"status": "incomplete"
}Собрать запрос
Собрать запрос
curl -X POST \
https://api.calibripay.com/api/v1/subscriptions \
-H "X-Access-Key: $CALIBRIPAY_ACCESS_KEY" \
-H "X-Timestamp: $TS" \
-H "X-Nonce: $NONCE" \
-H "X-Signature: $SIGNATURE" \
-H "Idempotency-Key: order-20260817-001" \
-d '{ "mandate_id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02", "amount_minor": 1001, "currency": "EUR", "interval_unit": "day", "interval_count": 1 }'$TS, $NONCE и $SIGNATURE вычисляются на вашем backend по канонической строке. secret_key никогда не должен попадать в браузер, в командную строку из истории и в тикеты.
Связанные операции
GET/api/v1/subscriptions/{id}Статус подпискиPOST/api/v1/subscriptions/{id}/pauseПриостановить подпискуPOST/api/v1/subscriptions/{id}/resumeВозобновить подпискуPOST/api/v1/subscriptions/{id}/cancelОтменить подписку
Была ли страница полезной?