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 — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.