recurrent-payment

/recurrent-payment — Автоплатежи и карты

Алгоритм — первичная привязка карты

1. add_customer (customer_key — ваш уникальный ID покупателя, email, phone) — зарегистрируй покупателя.
2. init_payment (amount в рублях, order_id, description, customer_key, recurrent: "Y", success_url, fail_url, notification_url) — первый платёж обязан идти с признаком recurrent, иначе карта не привяжется и автосписаний не будет.
3. Отдай покупателю PaymentURL из ответа, дождись оплаты, проверь get_payment_state (payment_id).
4. RebillId приходит в уведомлении на notification_url. Это ключ карты для последующих списаний — сохрани его на своей стороне.

Алгоритм — списание по подписке

1. get_card_list (customer_key) — привязанные карты покупателя, маскированные номера и CardId.
2. charge_payment (payment_id — исходный платёж с recurrent, rebill_id — карта, amount) — автосписание. Форма оплаты покупателю не показывается.
3. get_payment_state (payment_id) — подтверди успех, не считай платёж прошедшим по факту вызова.
4. Чек по факту оказания услуги — send_closing_receipt (payment_id, email, phone, taxation, items).

Отвязка и удаление

• remove_card (customer_key, card_id) — снять одну карту, CardId берётся из get_card_list.
• remove_customer (customer_key) — удалить покупателя вместе со всеми его картами. Действие необратимое, подтверждай отдельно.
• Проверить, заведён ли покупатель, — get_customer (customer_key).

Важно

• Списание без согласия держателя карты — прямой путь к чарджбэку. Автосписание запускать только по правилу, которое пользователь подтвердил (сумма, периодичность, за что).
• Забыли recurrent: "Y" в первом платеже — RebillId не появится; лечится только новым первичным платежом, задним числом карту не привязать.
• customer_key — ваш идентификатор, а не выданный банком; он же связывает карты с покупателем.

Формат ответа

## Автоплатёж T-Kassa

**Покупатель**: cust-1042 ([email protected])
**Карты**: 430000******0777 (CardId 55120)
**Списание**: 1 490 ₽ по RebillId 9912834
**Статус**: CONFIRMED

Чек отправлен на [email protected].