Payments

Платежи

Поддерживаемые Методы

• Telegram Stars;
• YooKassa;
• YooMoney;
• Cryptomus;
• Heleket.

Каждый gateway включается отдельной переменной SHOP_PAYMENT_*_ENABLED.

Callback Flow

1. Пользователь создает transaction в боте.
2. Gateway возвращает payment URL или invoice.
3. Пользователь оплачивает.
4. Gateway вызывает callback endpoint.
5. Бот проверяет transaction и idempotency.
6. Подписка создается или продлевается.

Idempotency

Payment callback может прийти повторно. Обработка должна быть безопасной:

• не создавать двойное продление;
• не пересоздавать клиента без причины;
• сохранять понятный transaction status;
• логировать конфликтные состояния.

Reconciliation

Фоновые задачи проверяют pending transactions, если gateway поддерживает запрос статуса. Это закрывает случаи, когда callback потерялся или пришел поздно.

Операционный Чек

После изменения billing-кода:

• прогнать payment tests;
• проверить один безопасный тестовый платеж;
• проверить логи callback endpoint;
• проверить, что пользователь получил подписку;
• проверить, что повторный callback не меняет срок второй раз.