WeChat Pay ломает интеграцию не кнопкой оплаты, а зоопарком локальных правил

WeChat Pay ломает интеграцию не кнопкой оплаты, а зоопарком локальных правил

Локальные методы оплаты продают как «добавьте ещё один метод и конверсия попрёт». На практике вы получаете отдельный мир с QR-сценарием, кошельками, локальными лимитами, странными статусами и поддержкой, которая отвечает так, будто читала только заголовок API-спеки.

Самая частая ошибка — пытаться влепить WeChat Pay как обычный карточный метод. Там другие ожидания по UX, другой флоу подтверждения, свои требования к валюте, региону и типу мерчанта. Идемпотентность или смерть: если у вас нет нормальной защиты от дублей, один ретрай превратит оплату в двойное списание, а потом начнётся цирк с холдами и возвратами.

Вебхуки тоже любят добивать команду. Провайдер может прислать success, потом pending, потом ещё раз success — и всё это выглядит «нормально», если вы не построили жёсткую state machine. Документация — это ложь, логи — истина: сверяйте серверные статусы, а не верьте фронтовой галочке «paid».

Перед подключением проверьте три вещи: как именно подтверждается платёж; какие статусы считаются финальными; как устроен refund/void для локального метода. Если провайдер не отдаёт нормальные тест-кейсы и не объясняет edge cases, это не интеграция, а костыль на костыле и финтехом погоняет.

Сначала проектируйте обработку статусов и только потом рисуйте кнопку оплаты. Иначе WeChat Pay станет не каналом выручки, а очередным инцидентом в ночной смене.