{"id":406064,"date":"2026-11-18T06:49:22","date_gmt":"2026-11-18T06:49:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/yolfi-payments-for-woocommerce\/"},"modified":"2026-11-18T06:49:00","modified_gmt":"2026-11-18T06:49:00","slug":"yolfi-payments-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/yolfi-payments-for-woocommerce\/","author":23605677,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.1","stable_tag":"0.1.1","tested":"7.1.5","requires":"6.6","requires_php":"7.4","requires_plugins":null,"header_name":"Yolfi Payments for WooCommerce","header_author":"Yolfi Group","header_description":"Hosted crypto payments and Yolfi-managed recurring payments for WooCommerce.","last_updated":"2026-11-18 06:49:00","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/docs.yolfi.com\/en\/integrations\/woocommerce","header_author_uri":"https:\/\/yolfi.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":44,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.1":{"tag":"0.1.1","author":"yolfi","date":"2026-11-18 06:49:00","revision":3808691}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3808691,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3808691,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3808691,"resolution":false,"location":"assets","locale":false}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3808691,"resolution":"1","location":"assets","locale":"","width":624,"height":1076},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3808691,"resolution":"2","location":"assets","locale":"","width":1280,"height":1507}},"screenshots":{"1":"Gateway settings with the existing organization API key and automatically connected payment notifications. Demo identifiers only.","2":"Yolfi selected in the native WooCommerce Checkout Block. Demo product and customer data only."}},"plugin_section":[],"plugin_tags":[3148,12611,1887,231844,286],"plugin_category":[45],"plugin_contributors":[293549],"plugin_business_model":[],"class_list":["post-406064","plugin","type-plugin","status-publish","hentry","plugin_tags-checkout","plugin_tags-cryptocurrency","plugin_tags-payments","plugin_tags-stablecoin","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-yolfi","plugin_committers-yolfi"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/yolfi-payments-for-woocommerce\/assets\/icon.svg?rev=3808691","icon":"https:\/\/ps.w.org\/yolfi-payments-for-woocommerce\/assets\/icon.svg?rev=3808691","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/yolfi-payments-for-woocommerce\/assets\/screenshot-1.jpg?rev=3808691","caption":"Gateway settings with the existing organization API key and automatically connected payment notifications. Demo identifiers only."},{"src":"https:\/\/ps.w.org\/yolfi-payments-for-woocommerce\/assets\/screenshot-2.png?rev=3808691","caption":"Yolfi selected in the native WooCommerce Checkout Block. Demo product and customer data only."}],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<ul>\n<li>One-time crypto checkout for WooCommerce orders.<\/li>\n<li>USDC, USDT, ETH and other payment assets available in your Yolfi settings.<\/li>\n<li>Existing organization API key and automatic payment notifications.<\/li>\n<li>HPOS and legacy order storage.<\/li>\n<li>Translatable interface using standard WordPress.org language packs.<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<h3>Native Yolfi recurring payments<\/h3>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<h3>External service and privacy<\/h3>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>Service terms: https:\/\/yolfi.com\/terms\nService privacy: https:\/\/yolfi.com\/privacy\nDocumentation: https:\/\/docs.yolfi.com\/en\/integrations\/woocommerce\nWebsite: https:\/\/yolfi.com\/\nSupport: https:\/\/yolfi.com\/contact<\/p>\n\n<h3>Source and licenses<\/h3>\n\n<p>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.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install WooCommerce and configure your store currency and HTTPS checkout.<\/li>\n<li>Install and activate this plugin from the official WordPress.org plugin directory. Its payment gateway is disabled by default.<\/li>\n<li>Create an organization or sign in at https:\/\/app.yolfi.com\/ and configure receiving wallets.<\/li>\n<li>Copy your existing organization API key from Yolfi Settings &gt; API Keys.<\/li>\n<li>Open WooCommerce &gt; Settings &gt; Payments &gt; 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.<\/li>\n<li>Enable Yolfi payments and save. Send a test notification from Yolfi Webhooks if you want to check delivery. Test notifications never fulfill orders.<\/li>\n<li>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.<\/li>\n<\/ol>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"are%20refunds%20automatic%3F\"><h3>Are refunds automatic?<\/h3><\/dt>\n<dd><p>No. Refunds require the merchant's existing Yolfi\/wallet process. Do not assume that refunding the WooCommerce order sends crypto back to a customer.<\/p><\/dd>\n<dt id=\"does%20a%20successful%20browser%20redirect%20mark%20an%20order%20paid%3F\"><h3>Does a successful browser redirect mark an order paid?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"can%20i%20retry%20after%20a%20network%20error%3F\"><h3>Can I retry after a network error?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20if%20notification%20setup%20cannot%20recover%20an%20existing%20signing%20secret%3F\"><h3>What if notification setup cannot recover an existing signing secret?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"is%20this%20compatible%20with%20hpos%3F\"><h3>Is this compatible with HPOS?<\/h3><\/dt>\n<dd><p>The integration uses WooCommerce order CRUD and declares HPOS compatibility. Verify your store's plugins and tax configuration before enabling payments.<\/p><\/dd>\n<dt id=\"does%20this%20support%20all%20woocommerce%20recurring-product%20plugins%3F\"><h3>Does this support all WooCommerce recurring-product plugins?<\/h3><\/dt>\n<dd><p>No. Native Yolfi recurring payments use the explicit existing-Paylink mapping described above. No automatic WooCommerce Subscriptions compatibility is claimed.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>Use WordPress.org language packs without bundled catalogs or a manual translation loader.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial hosted-payment gateway, signed payment verification, Checkout Blocks integration and Yolfi-managed recurring payment records.<\/li>\n<\/ul>","raw_excerpt":"Accept crypto payments in WooCommerce with Yolfi hosted checkout, one-time payments and Yolfi-managed recurring plans.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/406064","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=406064"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/yolfi"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=406064"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=406064"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=406064"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=406064"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=406064"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=406064"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}