Title: Yolfi Payments for WooCommerce
Author: yolfi
Published: <strong>November 18, 2026</strong>
Last modified: November 18, 2026

---

Search plugins

![](https://ps.w.org/yolfi-payments-for-woocommerce/assets/icon.svg?rev=3808691)

# Yolfi Payments for WooCommerce

 By [yolfi](https://profiles.wordpress.org/yolfi/)

[Download](https://downloads.wordpress.org/plugin/yolfi-payments-for-woocommerce.0.1.1.zip)

 * [Details](https://wordpress.org/plugins/yolfi-payments-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/yolfi-payments-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/yolfi-payments-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/yolfi-payments-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/yolfi-payments-for-woocommerce/)

## Description

Accept cryptocurrency payments in your WordPress store with Yolfi. The plugin works
with WooCommerce Classic Checkout and Checkout Blocks, using your existing Yolfi
organization and receiving wallets.

Keep your WooCommerce products, taxes, shipping and discounts. Customers choose 
an available cryptocurrency and network in Yolfi hosted checkout. Payment confirmation
updates the matching order; returning to the store is not proof of payment.

 * One-time crypto checkout for WooCommerce orders.
 * USDC, USDT, ETH and other payment assets available in your Yolfi settings.
 * Existing organization API key and automatic payment notifications.
 * HPOS and legacy order storage.
 * Translatable interface using standard WordPress.org language packs.

The plugin sends the final server-calculated order total and currency to Yolfi. 
Taxes, shipping and discounts remain under WooCommerce control. Yolfi calculates
the payment-token amount in hosted checkout; this plugin does not perform foreign
exchange or assume a stablecoin is exactly one US dollar.

Pricing currencies: USD, EUR and CNY. The available payment tokens and blockchain
networks are determined by Yolfi and your receiving-wallet settings, not by a hard-
coded asset list in this plugin.

Use your existing Yolfi organization and its normal API key. The plugin sets up 
its payment-notification endpoint automatically when you save the settings. No separate
store account, WooCommerce key or authorization flow is required. The plugin is 
free. The external Yolfi payment service has its own terms and fees. See https://
yolfi.com/ and the terms linked below before connecting.

### Native Yolfi recurring payments

For a simple virtual product, enable “Yolfi recurring payment” and enter an existing
enabled RECURRING Paylink UUID. Purchase it alone with quantity one and no coupons,
shipping or fees. The entire order total, including any taxes, must equal the Paylink
price and currency exactly.

Yolfi manages the billing cadence, renewal reminders and customer-authorized wallet
payments. Confirmed renewals create separate WooCommerce orders linked to the original
order. This plugin does not debit wallets automatically and does not implement WooCommerce
Subscriptions scheduling, trials, upgrades or automatic renewals. WooCommerce Subscriptions
is not required. Its ordinary manually paid renewal orders may use this gateway 
as one-time payments.

Subscription status and billing-period information appear on the original order 
details in My Account. Follow your Yolfi renewal email to authorize a renewal payment.
Contact the merchant to request subscription cancellation. The plugin does not grant
the store broad customer-subscription management access.

Overdue or cancelled subscriptions are never reactivated automatically by late payments.
Payments requiring manual review are recorded without automatic fulfillment. Previously
paid WooCommerce orders are not cancelled when a subscription becomes overdue.

### External service and privacy

This plugin uses the existing production API at https://app.yolfi.com/api for organization
verification, Paylink checks, Checkout Session creation, payment-status retrieval,
subscription-state verification and webhook endpoint setup. The buyer is redirected
to https://pay.yolfi.com to complete payment. The plugin has no separate sandbox
mode. Test notifications from Yolfi Webhooks only check delivery and never fulfill
orders.

When you save the settings, the server authenticates with your existing organization
API key, reads the organization and webhook endpoints, and registers its own WordPress
callback if needed. The endpoint-specific signing secret is saved server-side automatically.
For each checkout, the server sends the order identifier, final amount and currency(
or the mapped Paylink identifier), customer billing email and name, an order reference,
and return/cancel URLs. Yolfi uses these to provide checkout, customer communication,
payment processing and recurring payments when selected. No card details, wallet
private keys, line items, postal addresses or telephone numbers are sent by this
plugin. Yolfi sends signed payment and subscription events to the configured webhook
URL.

Connection credentials remain server-side in WordPress options and must be protected
along with database backups. Uninstall removes saved connection credentials. The
plugin stores checkout references, immutable pricing snapshots, subscription references
and event receipts in the local WordPress database. It adds no analytics or tracking
and loads the cube icon and Checkout Blocks script locally. Data required for financial
records is retained after deactivation and uninstall; delete it only according to
your store’s record-retention policy.

The original checkout request, including the billing name, email and return/cancel
URLs, is also saved with the order so retries can reuse the same request. WooCommerce’s
personal-data erasure tools do not automatically remove this saved request; include
it in your store’s retention and erasure procedures.

Service terms: https://yolfi.com/terms
 Service privacy: https://yolfi.com/privacy
Documentation: https://docs.yolfi.com/en/integrations/woocommerce Website: https://
yolfi.com/ Support: https://yolfi.com/contact

### Source and licenses

All PHP and JavaScript source is included and human-readable. assets/js/blocks.js
runs directly and has no compilation step. It uses WooCommerce and WordPress scripts
already installed on the store; no third-party code is bundled. Code and Yolfi-provided
cube artwork in this package are licensed GPL-2.0-or-later. See license.txt.

## Screenshots

[⌊Gateway settings with the existing organization API key and automatically connected
payment notifications. Demo identifiers only.⌉⌊Gateway settings with the existing
organization API key and automatically connected payment notifications. Demo identifiers
only.⌉[

Gateway settings with the existing organization API key and automatically connected
payment notifications. Demo identifiers only.

[⌊Yolfi selected in the native WooCommerce Checkout Block. Demo product and customer
data only.⌉⌊Yolfi selected in the native WooCommerce Checkout Block. Demo product
and customer data only.⌉[

Yolfi selected in the native WooCommerce Checkout Block. Demo product and customer
data only.

## Installation

 1. Install WooCommerce and configure your store currency and HTTPS checkout.
 2. Install and activate this plugin from the official WordPress.org plugin directory.
    Its payment gateway is disabled by default.
 3. Create an organization or sign in at https://app.yolfi.com/ and configure receiving
    wallets.
 4. Copy your existing organization API key from Yolfi Settings > API Keys.
 5. Open WooCommerce > Settings > Payments > Yolfi, paste the API key and save. The
    plugin verifies the organization and automatically creates or reuses its native
    payment-notification endpoint. You do not need to copy a callback URL or signing
    secret between applications.
 6. Enable Yolfi payments and save. Send a test notification from Yolfi Webhooks if
    you want to check delivery. Test notifications never fulfill orders.
 7. Verify a controlled live payment before using the integration for customer fulfillment.
    For recurring products, also verify the exact Paylink amount, currency and billing
    cadence in Yolfi.

WooCommerce’s bundled Action Scheduler reconciles pending payments in the background.
Keep scheduled actions and WordPress cron running. Set up a real scheduler to invoke
WordPress cron on stores without regular traffic.

To stop accepting new payments, disable the Yolfi payment method in WooCommerce 
settings. Keep the plugin active while pending payments or Yolfi recurring subscriptions
still need payment and status notifications. Deactivating the plugin removes its
notification receiver and background callbacks; missed updates are not automatically
recovered after reactivation.

## FAQ

### Are refunds automatic?

No. Refunds require the merchant’s existing Yolfi/wallet process. Do not assume 
that refunding the WooCommerce order sends crypto back to a customer.

### Does a successful browser redirect mark an order paid?

No. Only a verified live payment confirmation or an authenticated settled-payment
response can fulfill an order. A Checkout Session marked COMPLETED is not payment
confirmation.

### Can I retry after a network error?

Retry the same order. Its persisted request and idempotency key are reused. An expired
attempt or modified order requires merchant review before a replacement order is
created.

### What if notification setup cannot recover an existing signing secret?

Yolfi returns an endpoint’s signing secret only when it is created or explicitly
rotated. The plugin reuses its saved endpoint and secret, and never silently rotates
an existing secret. If an endpoint already uses this WordPress callback but the 
secret was lost, remove that endpoint in Yolfi Webhooks and save the plugin settings
again. Other endpoints are left unchanged. A key for a different organization is
rejected so existing orders cannot be silently reassigned.

### Is this compatible with HPOS?

The integration uses WooCommerce order CRUD and declares HPOS compatibility. Verify
your store’s plugins and tax configuration before enabling payments.

### Does this support all WooCommerce recurring-product plugins?

No. Native Yolfi recurring payments use the explicit existing-Paylink mapping described
above. No automatic WooCommerce Subscriptions compatibility is claimed.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Yolfi Payments for WooCommerce” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ yolfi ](https://profiles.wordpress.org/yolfi/)

[Translate “Yolfi Payments for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/yolfi-payments-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/yolfi-payments-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/yolfi-payments-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/yolfi-payments-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/yolfi-payments-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.1

 * Use WordPress.org language packs without bundled catalogs or a manual translation
   loader.

#### 0.1.0

 * Initial hosted-payment gateway, signed payment verification, Checkout Blocks 
   integration and Yolfi-managed recurring payment records.

## Meta

 *  Version **0.1.1**
 *  Last updated **13 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.6 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [checkout](https://wordpress.org/plugins/tags/checkout/)[cryptocurrency](https://wordpress.org/plugins/tags/cryptocurrency/)
   [payments](https://wordpress.org/plugins/tags/payments/)[stablecoin](https://wordpress.org/plugins/tags/stablecoin/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/yolfi-payments-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/yolfi-payments-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/yolfi-payments-for-woocommerce/reviews/)

## Contributors

 *   [ yolfi ](https://profiles.wordpress.org/yolfi/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/yolfi-payments-for-woocommerce/)