Интеграцию обычно планируют как задачу для разработчика, а получается проект с
тремя участниками. Разработчик подключает API, финансист сводит то, что упало на счёт. Кроме того, кто-то должен отвечать покупателям со странными платежами.
Команды, которые закладывают на это неделю, обнаруживают две другие роли на
третьей.
Сама работа несложная. Тянется она из-за порядка: несколько решений надо принять
до первой строчки кода, а переделывать их потом дорого.
Четыре решения до начала работы
Где вводятся данные карты. Страница на стороне провайдера
полностью убирает карточные данные из ваших систем и сводит требования к
безопасности к минимуму. Форма, встроенная в ваш чекаут, выглядит лучше и конвертит немного выше. Однако данные карты теперь касаются вашей страницы, и вопросы по безопасности меняются. Большинству магазинов стоит начать с внешней страницы и
перейти позже, если цифры конверсии это оправдают.
Что происходит после оплаты. Клиент возвращается на сайт, но
источник правды — уведомление сервер-серверу, а не редирект. Стройте состояние
заказа на нём. Магазины, которые отмечают заказ оплаченным по возврату браузера,
отгружают товар за платежи, которые не состоялись.
Списываете сразу или сначала резервируете. Физические товары
обычно означают авторизацию сейчас и списание при отгрузке. Цифровые списывают
сразу. Ошибка здесь даёт злых клиентов, у которых забрали деньги за отсутствующий товар. Либо наоборот: истёкшие авторизации и потерянные продажи.
Как делаются возвраты. На второй день кому-то придётся вернуть
деньги за заказ. Решите, происходит это в вашей админке или в кабинете провайдера
и у кого есть на это право.
Последовательность, которая работает
Заявку на счёт подавайте до начала разработки: она занимает от 5 дней и идёт
параллельно с кодом. Шаги описаны на странице
как это работает.
Пока документы в движении, посмотрите возможности, к которым подключаетесь, —
они собраны в разделе обработки платежей.
Что именно проверяет эквайер, описано на странице
мерчант-счетов. Если прочитать это до
стартовой встречи, одного круга вопросов не будет.
Пока заявка идёт, собирайте на тестовой среде. Песочница даёт номера карт с заранее известным исходом: одобрено, отклонено, таймаут. При этом под каждый сценарий нужен обработчик. Таймаут как раз и пропускают,
а именно он потом даёт двойные списания в бою.
Затем протестируйте на небольших реальных суммах до запуска. Песочница ведёт
себя вежливо, живые банки — нет. Одна настоящая операция на каждый способ оплаты
плюс один возврат ловят большую часть того, что песочница прячет.
Где интеграции ломаются
Двойные списания при повторе. Клиент нажал «оплатить» дважды
или сеть отвалилась и приложение повторило запрос. Без ключа идемпотентности обе
попытки становятся транзакциями, и узнаёте вы об этом от покупателя. Это самый
частый дефект из тех, что мы видим.
Состояние заказа разъезжается с состоянием платежа. Платёж
прошёл, уведомление потерялось, заказ висит неоплаченным. Сделайте ежедневную
сверку, которая сравнивает две стороны, вместо того чтобы верить в доставку
каждого сообщения.
Валюта выбирается не там. Если магазин показывает евро, а
запрос уходит в другой валюте, клиент видит сумму, на которую не соглашался.
Фиксируйте валюту в точке показа цены и передавайте её явно.
Аутентификацию считают ошибкой. Подтверждение от банка — это
нормальный шаг, а не сбой. Чекаут, который показывает «ошибка оплаты», когда банк
просит подтверждение, теряет продажу на последнем сантиметре.
О чём договориться с поддержкой до запуска
Тому, кто отвечает клиентам, в первый день нужны три вещи. Во-первых, возможность найти платёж по номеру заказа. Во-вторых, право сделать возврат без эскалации. В-третьих, понятное объяснение тех двух-трёх сбоев, которые реально случатся. Большинство обращений звучит как «списали дважды» или «я оплатил, а заказ висит неоплаченным». Поэтому готовые ответы на эти два закрывают основную часть первого месяца.
Что передать финансовой стороне
Интеграция закончена не тогда, когда прошёл тестовый платёж, а когда деньги
прослеживаются от начала до конца. Финансам нужно, чтобы отчёт о выплатах сходился с заказами. То есть каждая выплата должна разворачиваться в список операций. Спросите, что именно содержит отчёт, до того как писать импорт: переделывать
сверку потом дольше, чем сделать сразу.
Если выручка приходит в нескольких валютах, решите заранее, где она собирается.
Бизнес-IBAN на ваше имя упрощает цепочку, потому что
расчёты и исходящие платежи остаются в одном месте.
Коммерческие условия вокруг всего этого — на странице
тарифов, где ставки для middle-risk розницы начинаются от
1,8%.
Реалистичные сроки
Для обычного магазина на распространённой платформе техническая часть — это
несколько дней работы и неделя тестов. Проверка счёта идёт от 5 дней параллельно.
Сроки сдвигаются, когда документы приходят неполными или когда сайт противоречит заявке. Цены расходятся с чекаутом, нет условий, контакты ведут в пустоту.
Планируйте запуск на спокойную неделю, а не перед пиком продаж. Первые дни
после включения — это время, когда вылезают крайние случаи, и внимание должно быть
свободно. Сторону счёта мы описывали в материале про
мерчант-счета.
Подключение от 5 дней. Комиссия от 1,8% — прозрачные условия, без скрытых
платежей. Оставьте заявку или закажите консультацию — подберём оптимальное
решение под вашу нишу и риск-профиль.