При переносе payment method tokens нельзя считать, что «это просто обмен идентификаторов». У токена меняется не только провайдер, но и контракт вокруг него: формат хранения, scope, правила повторной авторизации, 3DS-состояние, доступность MIT/CIT, поведение при рекуррентных списаниях. Если не зафиксировать эти различия в модели данных, вы получите скрытые отказы и revenue leakage.
Рабочая схема выглядит так: • заводите token_map со связкой old_token -> new_token и статусом миграции; • делайте миграцию идемпотентной, чтобы повторный job не создавал дубликаты; • держите старый токен активным, пока новый не пройдет test charge или первую успешную подписку; • все списания отправляйте через routing layer, который умеет выбирать шлюз по состоянию токена, а не по историческому источнику. Идемпотентность в биллинге — это не рекомендация, а базовый вопрос выживания системы.
Отдельно проверьте очереди повторов и dunning: если у вас фоновый ретрай уже летит в старый шлюз, миграция превращается в двойную попытку списания. Нужны блокировки на уровне payment intent, versioning для токена и атомарная смена маршрута: либо old, либо new, но не оба одновременно. Давайте разберем, что происходит с транзакцией в момент сетевого сплита шлюза: именно там чаще всего рождаются фантомные успешные платежи.
Самый безопасный подход — phased cutover с параллельным наблюдением: сначала переводите новые подписки, затем активные renewal-когорты, и только после стабилизации отключаете старую связку. Грамотно спроектированная dunning-стратегия способна спасти до 15% уходящей регулярной выручки, но только если она видит актуальный токен и не воюет с миграцией.
Подписки: биллинг-лаб
@subscriptions_billing_lab_arb
Миграция токенов между шлюзами без даунтайма: где чаще всего ломается биллинг
Этот пост опубликован в Telegram-канале Подписки: биллинг-лаб (@subscriptions_billing_lab_arb). Все его публикации — на странице канала.
Открыть в Telegram