EasyPay для WooCommerce — оплата карткою, Apple Pay і Google Pay

EasyPay для WooCommerce — платіжний плагін, який приймає оплату через EasyPay: карткою Visa/Mastercard, Apple Pay і Google Pay. Покупець переходить на захищену сторінку EasyPay, платить, а замовлення в магазині підтверджується само. EasyPay надсилає підписане сповіщення, плагін перевіряє підпис, окремо питає в EasyPay статус платежу і звіряє суму. Лише після цього замовлення стає оплаченим. Звіряти оплати в кабінеті EasyPay вручну не треба.

Як це виглядає для покупця

Покупець, який не завершив оплату, повертається на сторінку оплати замовлення й може спробувати ще раз. Нове замовлення створювати не треба: плагін сам видасть EasyPay новий номер спроби. Якщо увімкнути нагадування, EasyPay через 15–20 хвилин надішле покупцю SMS або Viber про неоплачене замовлення.

Що отримує адмін

• «Перевірити ключі» надсилає підписаний запит статусу. Помилку плагін називає конкретно: EasyPay не знає PartnerKey, не знає ServiceKey або відхиляє підпис, тобто неправильний SecretKey. Про проблему ви дізнаєтеся в адмінці, а не від покупця.
• Нотатки в замовленні: номер замовлення в EasyPay, транзакція, відхилення з причиною від банку, повернення, блокування і списання.
• Статус після оплати: «В обробці» або одразу «Виконано».
• Pro-журнал платежів: усі платежі EasyPay в одному списку. Там сума, повернення, статус в EasyPay і статус замовлення, номер транзакції, а статус можна перевірити одним кліком.

Як це працює — крок за кроком

1. Покупець на чекауті обирає EasyPay і підтверджує замовлення.
2. Плагін створює замовлення в EasyPay: номер, суму, опис, адресу для сповіщень і сторінки повернення. Кожен запит підписується вашим SecretKey.
3. Покупець платить на сторінці EasyPay карткою, Apple Pay або Google Pay.
4. EasyPay надсилає сповіщення на ваш сайт. Плагін перевіряє підпис. Непідписаний або підроблений запит отримує відмову, і замовлення лишається як було.
5. Плагін сам питає в EasyPay статус цього платежу. Тіло сповіщення використовується лише для того, щоб знайти замовлення, тому «оплатити» його фальшивим запитом не вийде.
6. Сума звіряється з сумою замовлення. Якщо сплачено менше, замовлення стає «На утриманні» з нотаткою для перевірки, а не «В обробці».
7. Якщо сповіщення затрималось, статус перевіряється ще й тоді, коли покупець повертається в магазин. Оплачене замовлення не залишиться «в очікуванні».
8. З Pro у режимі hold кошти лише блокуються на картці. Списуються вони, коли ви переводите замовлення у «Виконано», а скасування замовлення розблоковує їх. Так зручно, якщо товар треба спершу зібрати чи перевірити наявність.

Що під капотом

• Підпис у обидва боки: base64(SHA-256) від SecretKey і тіла запиту. Сповіщення з неправильним підписом плагін відхиляє.
• Статус береться з EasyPay (orderState), а не зі сповіщення. Опційно сповіщення можна приймати лише з IP-адрес EasyPay.
• Захист від подвійного списання: сповіщення і повернення покупця приходять одночасно, але обробляються по черзі під блокуванням. «Оплату отримано» записується один раз навіть при кількох паралельних сповіщеннях. Покупець, який натиснув «Назад» після оплати, не створить друге замовлення в EasyPay.
• Унікальні номери замовлень для EasyPay: префікс магазину, а для повторної спроби суфікс -2, -3. Якщо номер уже зайнятий, плагін бере наступний сам.
• Повернення без переплат (Pro): перед поверненням плагін питає в EasyPay, скільки ще можна повернути. Повернення, зроблені в кабінеті EasyPay, теж враховуються.
• SecretKey зберігається зашифрованим, а повторне збереження налаштувань його не псує, навіть зі спецсимволами.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, а приймання оплати не ламається.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть easypay-for-woocommerce-1.0.2.zip і активуйте.
2. Відкрийте WooCommerce → Налаштування → Платежі → EasyPay і увімкніть спосіб оплати.
3. Для перевірки залиште увімкненою «Пісочницю» і натисніть «Перевірити ключі».
4. Для реальних оплат вимкніть пісочницю, впишіть PartnerKey, ServiceKey і SecretKey від EasyPay, збережіть і ще раз натисніть «Перевірити ключі». Адресу для сповіщень плагін передає сам з кожним замовленням, у кабінеті EasyPay нічого налаштовувати не треба.
5. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал.