Integrations

WooCommerce

Connect WooCommerce orders to your existing Yolfi payments and receive signed payment results.

Use your existing Yolfi account, organization, and API key to accept cryptocurrency payments in WooCommerce. The plugin sends the WooCommerce order total to Yolfi's existing checkout and receives the payment result through Yolfi's existing webhook system to update the order.

The plugin supports WooCommerce Classic Checkout and Checkout Blocks. WooCommerce continues to calculate taxes, shipping, and discounts. The buyer uses Yolfi's hosted payment page to choose a cryptocurrency and network and complete the payment.

Install Yolfi Payments for WooCommerce from the official WordPress.org plugin directory. This guide covers version 0.1.1.

Before you connect

You need a WordPress site with WooCommerce and HTTPS, plus a Yolfi organization with receiving wallets configured. Sign in to your existing Yolfi account, or register and complete the usual organization setup if you are new to Yolfi.

The plugin is free. The Yolfi payment service uses its existing terms and transaction fees. Buyers do not need a Yolfi merchant account.

Install and connect

  1. In WordPress, open Plugins → Add New Plugin and search for Yolfi Payments for WooCommerce. Select Install Now, then Activate. You can also open its official WordPress.org page.
  2. In Yolfi, open Settings → API Keys and copy your organization's existing API key. In WordPress, open WooCommerce → Settings → Payments → Yolfi and paste it into the plugin's API key field.
  3. Select Save in the WordPress plugin. It checks the API key against your organization and automatically registers its public HTTPS callback URL in Yolfi's existing webhooks. The returned signing secret is stored on your WordPress server, alongside the API key.
  4. Check the saved connection. On a staging store or checkout restricted to testers, select Enable Yolfi payments and save. Place a controlled test order and verify the resulting payment and WooCommerce order status before enabling Yolfi for customers. A test webhook checks delivery only and never pays a real order.

Payment notifications and connection errors

The plugin's callback is a receiver for payment results. It appears in your existing Settings → Webhooks in Yolfi with the Generic / Yolfi format. The plugin registers it when you save the connection, so you do not need to transfer a webhook URL or signing secret manually.

If saving the connection fails, check that the API key belongs to the intended organization and that your WordPress site is publicly reachable over HTTPS. In Settings → Webhooks, inspect the callback and its delivery results. Keep the API key and saved WordPress credentials private.

If the callback already exists but WordPress no longer has its signing secret, the plugin stops with a recovery error. Delete that old callback from Settings → Webhooks, then select Save again in WordPress to register it with a new secret. The plugin does not silently replace an existing callback's secret.

To stop accepting new Yolfi orders, clear Enable Yolfi payments in WooCommerce. Keep the plugin active while payments are pending or Yolfi recurring subscriptions need notifications. Deactivating or deleting the plugin stops its notification receiver and background checks; missed subscription updates require merchant review.

What happens after an order

WooCommerce sends the final order total and currency to Yolfi. The buyer is redirected to the usual Yolfi checkout, selects a cryptocurrency and network, and sees the exact amount, QR code, and payment address.

Yolfi sends the signed payment result to the callback registered by the plugin. After verifying the result against the order, the plugin completes the WooCommerce payment. Stock, downloads, and order emails follow your existing WooCommerce settings.

Returning to the store is not proof of payment. If a notification is delayed, the plugin can also retrieve the payment status from Yolfi. Keep WordPress scheduled tasks running so these background checks can complete.

Recurring payments

For a simple virtual product, enable Yolfi recurring in its product settings and enter the ID of an existing active Recurring payment link in Yolfi.

The order must contain one recurring product with quantity one. Its final total, including tax, and its currency must exactly match the payment link. Coupons, shipping, fees, and mixed carts are not supported for this recurring integration.

Yolfi manages the billing interval and renewal reminders. The buyer authorizes each payment from their wallet. Confirmed renewals are recorded as separate WooCommerce orders linked to the original purchase, with subscription information shown on the original order.

The plugin does not debit wallets automatically or implement WooCommerce Subscriptions scheduling, trials, or plan changes. WooCommerce Subscriptions is not required for these Yolfi recurring payments. Overdue or cancelled subscriptions require merchant review before access is restored.

Currencies and refunds

Use a pricing currency supported by both WooCommerce and your connected Yolfi service. Version 0.1.1 supports USD, EUR, and CNY as pricing currencies. The available cryptocurrencies and networks depend on Yolfi and your receiving-wallet settings. WordPress uses the final order price; Yolfi calculates the cryptocurrency amount.

Refunding a WooCommerce order does not automatically return cryptocurrency. Handle refunds through your existing Yolfi or wallet process and record the result in WooCommerce.

Data sent to Yolfi

The plugin sends the order reference, final amount and currency, return URLs, and the buyer email and name needed for checkout. It does not send wallet private keys, card details, postal addresses, telephone numbers, or order line items. It does not add advertising or analytics scripts.

See the Yolfi Privacy Policy and Terms of Service.

On this page