WooCommerce Exchange Quote Gateway

Репозиторий: https://github.com/propafinder/woo-exchange-quote-gateway

Обновления приходят с GitHub (WordPress 5.8+ Update URI). Чтобы выложить новую версию: увеличьте Version в главном файле плагина, закоммитьте, создайте тег v1.0.1 (или v*), запушьте тег — workflow соберёт zip и создаст релиз.

Плагин для WooCommerce: способ оплаты «картой», при котором клиент по факту платит криптой (LTC) на кошелёк магазина. Курс обмена берётся из вашего API котировок (или любого по URL). Всё в рамках плагина: HD-генератор LTC из Ltub (чистый PHP, без main.py), проверка оплаты по Chain.so/BlockCypher, обновление статуса WooCommerce после поступления средств. main.py — только образец; интеграция с ним опциональна (котировки и/или HD через API).

Возможности

• В корзине и на checkout отображается настраиваемое название способа оплаты (например «Оплата картой (курс Revolut)»).
• При выборе способа оплаты запрашивается котировка из API (GBP → LTC, карта, провайдер Revolut) и показывается сумма в GBP и эквивалент в LTC.
• После нажатия «Оформить заказ» заказ создаётся со статусом pending; клиент перенаправляется на страницу оплаты с уже подставленными суммой в GBP и адресом LTC.
• Статус заказа остаётся pending до подтверждения крипто-оплаты (вручную или через Woo crypto / webhook).
• В админке: переименование способа оплаты, LTC-адрес, логи.

Установка

1. Скопируйте папку woo-exchange-quote-gateway в wp-content/plugins/.
2. В админке WordPress: Плагины → Включить «WooCommerce Exchange Quote — оплата картой (крипта LTC)».
3. WooCommerce → Настройки → Платежи → включите способ «Exchange Quote» и заполните настройки.

Настройки (админка)

Интеграция с CryptoWoo (CryptoWoo HD Wallet Add-on)

Адрес LTC для оплаты берётся в таком порядке:

1. CryptoWoo — плагин автоматически пытается прочитать LTC-адрес из меты заказа (ключи вроде _cryptowoo_ltc_address, _payment_address, _payment_address_ltc и др.). Если CryptoWoo или CryptoWoo HD Wallet Add-on (Cryptocurrency Payment Gateway) сохраняют адрес в заказ, он будет использован для запроса котировки в API (main.py → wallet_address) и для редиректа на страницу оплаты.
2. Настройка плагина — поле «LTC адрес кошелька магазина».
3. Фильтр woo_exchange_quote_ltc_address — для кастомной логики.

Перед получением адреса вызывается хук woo_exchange_quote_before_get_ltc_address, чтобы другой плагин успел записать адрес в мету заказа (например, сгенерировать его через CryptoWoo HD Wallet).

Пример: если CryptoWoo сохраняет адрес в свой ключ, можно подставить его через фильтр:

add_filter('woo_exchange_quote_ltc_address', function ($address, $order_id, $order) {
    $from_cw = $order->get_meta('_cryptowoo_ltc_address'); // или ваш meta key от CryptoWoo
    return is_string($from_cw) && $from_cw !== '' ? $from_cw : $address;
}, 10, 3);

Полученный адрес передаётся в API котировок (endpoint в main.py) в поле wallet_address и в URL страницы оплаты, чтобы у клиента был уже подставлен нужный адрес.

Подробно о том, как CryptoWoo проверяет, получил ли данный адрес LTC (блок-эксплореры, cron, что делать для заказов нашего шлюза), см. docs/PAYMENT_VERIFICATION.md.

Страница оплаты (pay.html)

В проекте Exchange Quote API в static/pay.html лежит готовая страница. Параметры URL:

• amount или amount_gbp — сумма в GBP.
• address или ltc_address — адрес LTC.
• order_id — номер заказа (опционально).

Пример URL для настройки «URL страницы оплаты» (если API отдаёт static по /static/):

https://your-api.com/static/pay.html?amount_gbp={amount_gbp}&address={ltc_address}&order_id={order_id}

На странице отображаются сумма и адрес, кнопка ведёт на fluidmoney.xyz с теми же параметрами.

Требования

• WordPress 5.8+
• WooCommerce 5.0+
• PHP 7.4+
• Для HD-вывода LTC в плагине: расширение bcmath или gmp
• Котировки: задайте токен Meld (рекомендуется) — запросы идут из плагина в Meld API на PHP; либо URL своего API (без Python).