# WooCommerce (/en/integrations/woocommerce)



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.

<Callout type="info">
  Install [Yolfi Payments for WooCommerce](https://wordpress.org/plugins/yolfi-payments-for-woocommerce/)
  from the official WordPress.org plugin directory. This guide covers version **0.1.1**.
</Callout>

Before you connect [#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 [#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](https://wordpress.org/plugins/yolfi-payments-for-woocommerce/).
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 [#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 [#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 [#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 [#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 [#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](https://yolfi.com/privacy) and
[Terms of Service](https://yolfi.com/terms).
