Документація · Шлюзи · UA
WayForPay Україна
Картки, Apple/Google Pay, hold, розстрочка банків. Офіційна документація: https://wiki.wayforpay.com/. Комісія шлюзу: за договором WayForPay.
Доступи
merchantAccount, merchantSecretKey, merchantDomainName з кабінету. Тестовий мерчант — у документації.
- Змінні середовища
WAYFORPAY_MERCHANT_ACCOUNTWAYFORPAY_SECRET_KEYWAYFORPAY_MERCHANT_DOMAIN- Вебхук
POST /webhooks/wayforpayJSON; merchantSignature = HMAC-MD5(merchantAccount;orderReference;amount;currency;authCode;cardPan;transactionStatus;reasonCode). Місток відповідає підписаним{orderReference, status: accept, time, signature}.
Що викликає Місток
| Запит | Поля / сенс |
|---|---|
POST https://api.wayforpay.com/api (CREATE_INVOICE) | merchantAccount;merchantDomainName;orderReference;orderDate;amount;currency;productName[];productCount[];productPrice[] → HMAC-MD5 → invoiceUrl |
CHECK_STATUS | transactionStatus, reasonCode (1127 = not found → created) |
REFUND | merchantAccount;orderReference;amount;currency |
SETTLE | списання холду |
Статуси
Approved → success · WaitingAuthComplete → hold · InProcessing/Pending → processing · Declined → failure · Expired → expired · Refunded/Voided → reversed.
Модель Містка: created → processing → (hold →) success | failure | expired | reversed. Замовлення в Shopify отримує оплату лише на success і лише після звірки суми й валюти з нашим записом.
Пісочниця
Тестовий merchantAccount з wiki; картки для тестів там само.
Обмеження
- USD/EUR офіційно як alternativeCurrency — уточніть у менеджера
Живий прогін на тестовому мерчанті 31.10.2026: CREATE_INVOICE, CHECK_STATUS (у т.ч. код 1151 «Invoice Is Awaiting For Payment» на неоплачений інвойс → created).
Перевірено проти офіційної документації, відкритих питань немає.