WeChat Pay — не кнопка «добавить метод», а минное поле локальной интеграции

WeChat Pay — не кнопка «добавить метод», а минное поле локальной интеграции

Если вам продают «подключим китайские методы оплаты за вечер», готовьте валидол. Локальные методы — это не единый API, а зоопарк правил: QR, in-app, redirect, tokenized wallet, отдельные требования к мерчанту и свои любимые способы ломать checkout.

Главный ад начинается не в коде, а в договоре и потоке денег:
— один метод живёт только под локальный юрлицeм и местным банком;
— другой требует отдельного onboardinga, KYC и ручной модерации;
— третий умеет списать, но не умеет нормально вернуть деньги. Идемпотентность или смерть.
Документация к этому цирку обычно отстаёт от реальности, а support отвечает так, будто вы попросили секретный ключ к Луне.

Технически всё тоже «красиво»: вебхук может приходить раньше, чем вы увидели статус в панели; callback иногда дублируется; холд не всегда равен авторизации; refund может зависнуть в промежуточном состоянии без внятного reason code. Дальше начинается любимая игра финтеха — искать, кто виноват: ваша CRM, провайдер, банк-эквайер или “merchant config”.

Чтобы не утонуть, проверяйте до интеграции:
• есть ли у метода нормальный sandbox и тестовые статусы;
• как он ведёт себя при повторной отправке webhook;
• что происходит с partial refund, cancel и timeout;
• можно ли сверять операции по transaction_id, а не по магии из админки.

Локальные методы оплаты внедряются не разработкой, а дисциплиной сверки: если у вас нет логов, маппинга статусов и retry-стратегии, ваш WeChat Pay быстро превратится в костыль на костыле и финтехом погоняет.