Рекуррентные платежи

Списания по подписке

Постраничная история плановых и внеочередных списаний по конкретной подписке

GET/integration/subscriptions/{uuid}/charges
ПолеТипОписание
uuidобязательноеuuidUUID подписки Cashera
pageintegerНомер страницы от 1. По умолчанию 1
per_pageintegerРазмер страницы от 1 до 100. По умолчанию 20
200 OK
curl "https://api.cashera.cash/api/v1/integration/subscriptions/31dc7faa-c380-4ec7-a258-3202a2211e76/charges?page=1&per_page=20" \
-H "X-Api-Key: $CASHERA_API_KEY"

В примере показаны основные поля транзакции. Полный набор, включая поля распределения комиссии, расчётов и остальные даты, описан в объекте транзакции. Не считайте отсутствие поля в сокращённом примере его отсутствием в API.

Подтверждение конкретного периода

Считайте период оплаченным только при status = paid. Сверьте amount,currency и связь с подпиской из вебхука. Статус active самой подписки не подтверждает отдельное списание.

История условий и отдельные попытки

После изменения цены старые транзакции сохраняют свои суммы и комиссии. Например, первая оплата триала остаётся на 1900 копеек, хотя текущая сумма подписки уже равна 29000. Для проверки старого платежа не используйте текущую цену из объекта подписки. Внеочередная попытка также появляется в этой истории и имеет собственный UUID.

В истории могут быть неуспешные и ожидающие попытки. Не считайте количество строк количеством оплаченных периодов. amount означает базовую цену,gross_amount сумму клиента с комиссией, net_amountсумму за вычетом комиссии; все три поля в копейках.

Вебхук списания

Списание отправляется стандартным событием transaction.status_updated. Для рекуррентной транзакции в корне payload дополнительно присутствует объект subscriptionс полями uuid и external_id.