Billink для WooCommerce — оплата позже (achteraf betalen) для покупателей из Нидерландов и Бельгии

Pay Later with Billink for WooCommerce добавляет на кассу WooCommerce способ оплаты Billink («achteraf betalen»): покупатель получает заказ, а счёт оплачивает позже. На кассе он выбирает «Pay later with Billink», попадает на страницу Billink, подтверждает заказ там, и магазин получает подтверждение от Billink. Модуль работает с актуальным API Billink (сессии и подписанные вебхуки v3), классической и блочной кассой, HPOS. Нужен собственный мерчант-аккаунт Billink. Это независимая интеграция CatCode; Billink является торговой маркой Billink B.V.

Что делает бесплатная версия

Всё настраивается на одной странице: WooCommerce → Billink pay later. Выберите среду (тестовую или боевую), введите имя пользователя Billink и API-идентификатор (UID; хранится зашифрованным) и нажмите «Check connection»: Billink проверяет данные, ничего не создавая. Подписанные вебхуки настраиваются оттуда же: вставьте секрет подписи или дайте модулю создать его и одним кликом зарегистрируйте адрес вебхука в Billink. Для каждого заказа модуль создаёт сессию оплаты Billink с данными покупателя, адресами доставки и выставления счёта и всеми строками заказа (товары, доставка, сборы) с их ставкой НДС; улица, номер дома и добавление передаются отдельно: их берут из полей номера дома нидерландских плагинов кассы или из строки адреса. Покупателя перенаправляют на страницу Billink. Заказ становится оплаченным, когда Billink сообщает, что сессия завершена: подписанным вебхуком (HMAC-SHA256, доставки старше 5 минут отклоняются, каждая обрабатывается один раз) и проверкой в Billink, когда покупатель возвращается на страницу благодарности. Отменённая или просроченная страница Billink отменяет ожидающий заказ; если Billink не может создать заказ, он становится «Не удался», а покупатель видит нейтральное сообщение (причина — в заметках заказа), корзина остаётся целой. Кнопка «Check status at Billink» в заказе спрашивает Billink о сессии и об оплате счёта. Метод предлагается в евро для адресов выставления счёта в Нидерландах, Бельгии и Германии. Есть префикс номера заказа для нескольких магазинов на одном аккаунте, ваш логотип на странице Billink и официальный бейдж Billink. Опционально над описанием метода можно показать официальное изображение предупреждения AFM «Let op! Geld lenen kost geld» (по умолчанию выключено).

Что добавляет Pro

Бизнес-клиенты (B2B): заказы с названием компании уходят в Billink как бизнес-заказы, на кассе появляется необязательное поле номера Торговой палаты (KvK) в классической и блочной кассе. Старт счёта: вручную с экрана заказа или автоматически, когда заказ получает выбранный вами статус; перед стартом в Billink регистрируется код отслеживания (из поля заказа или из WooCommerce Shipment Tracking). Возвраты из WooCommerce: полный или частичный возврат становится кредит-нотой на счёте Billink. Удержание и диспуты: приостановка напоминаний до 14 дней, возобновление, открытие диспута с категориями Billink прямо из заказа. Вебхук заказа: события счёта (старт, оплата, кредит, удержание, диспуты) появляются заметками заказа. Расчётные счета Billink: список с фильтром по датам и ZIP со всеми документами для сверки. Журнал последних вызовов Billink и вебхуков. Лимиты по странам и сумме заказа отдельно для частных и бизнес-клиентов. Ежечасная фоновая проверка касс, для которых вебхук не дошёл.

Что стоит знать заранее

• Нужен собственный мерчант-аккаунт Billink: имя пользователя и API-идентификатор (UID). У тестовой и боевой сред они разные; тестовый аккаунт настраивает поддержка Billink.
• Billink принимает адреса выставления счёта в Нидерландах, Бельгии и Германии и заказы в евро. Вне них метод не предлагается.
• Покупатель подтверждает заказ на странице Billink. Встроенной формы в магазине нет, данных оплаты магазин не получает.
• Адрес вебхука должен быть HTTPS и отвечать без перенаправления: если он перенаправляет, Billink превращает запрос в пустой GET и считает его доставленным. Модуль проверяет это перед регистрацией.
• Без вебхука покупатель, не вернувшийся из Billink, оставляет заказ в ожидании, пока вы не нажмёте «Check status at Billink»; Pro проверяет такие заказы каждый час.
• Старт счёта: без него Billink обычно стартует его сам через несколько дней после заказа (настройка вашего аккаунта). Pro стартует счёт по вашему статусу с кодом отслеживания.
• Максимальные суммы на заказ, требования к отслеживанию и автоматический старт задаёт аккаунт Billink. Модуль показывает коды Billink простыми словами; те же максимумы введите в настройках Pro, чтобы метод не показывался выше них.
• B2B входит в договор Billink не всегда: проверьте, что бизнес-заказы включены у вашего аккаунта.
• Предупреждение AFM: опция показывает официальное изображение «Let op! Geld lenen kost geld» без изменений над описанием метода. По умолчанию она выключена. Какие предупреждения нужны вашему магазину, уточните у Billink или AFM.

Как это работает, шаг за шагом

1. Возьмите в Billink имя пользователя и API-идентификатор для выбранной среды.
2. В WooCommerce → Billink pay later введите их и нажмите «Check connection».
3. Вставьте секрет подписи или сгенерируйте его и нажмите «Register the webhook address».
4. Включите Billink в WooCommerce → Настройки → Платежи и сделайте заказ в тестовой среде.

Под капотом

• Billink API: сессии оплаты, статус сессии и счёта, подписанные вебхуки v3 (HMAC-SHA256 над меткой времени и телом), старт счёта, кредит, удержание, отслеживание, диспуты, расчётные счета.
• Обработка возврата покупателя идёт под блокировкой заказа: вебхук и проверка на странице благодарности вместе проводят оплату один раз; повторная доставка ничего не меняет.
• Каждая следующая попытка оплаты того же заказа уходит в Billink с новой ссылкой (номер-2, -3…), старые вебхуки игнорируются.
• API-идентификатор и секрет подписи хранятся зашифрованными; совместимо с HPOS и блочной кассой; языки: English, Nederlands.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → Billink pay later: имя пользователя, API-идентификатор, «Check connection».
3. Секрет подписи и регистрация вебхука.
4. Включите способ оплаты Billink.

Модуля пока нет на wordpress.org: бесплатная версия и Pro — один архив с этой страницы. Без ключа он работает как бесплатная версия.