ONE.lat for WooCommerce
| 开发者 | onelatok |
|---|---|
| 更新时间 | 2026年9月25日 01:43 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
ONE.lat for WooCommerce connects your store to ONE, a payment gateway built for Latin America. Your customers pay with their country's local method — 🇦🇷 bank transfers, 🇧🇷 PIX, 🇨🇴 PSE, 🇲🇽 SPEI, or cryptocurrency — and you get settled in USDC directly to your wallet, within minutes, with no need for a US LLC or a US dollar bank account.
Why ONE
- Local payment methods: 🇦🇷 bank transfers in Argentina, 🇧🇷 PIX in Brazil, 🇨🇴 PSE in Colombia, 🇲🇽 SPEI in Mexico, and crypto in any country.
- Settlement in minutes, in USDC: funds reach your wallet in minutes instead of days, with no banking intermediaries.
- No chargebacks: transfers and crypto payments are irreversible, unlike credit cards — once a payment is confirmed, it stays confirmed.
- No infrastructure friction: you don't need to open a US LLC or a US dollar bank account to start charging and settling in your store.
- Native WooCommerce integration: works with both classic checkout and Cart & Checkout Blocks, and is compatible with HPOS (High-Performance Order Storage).
- The customer selects "ONE" as the payment method at your checkout.
- Your store creates a Checkout Preference through the ONE API and redirects the customer to a secure, hosted payment page.
- The customer pays with the local method available in their country.
- ONE notifies the result via webhook. The plugin never trusts that notification on its own: it always makes an authenticated request back to the ONE API to confirm the real status before marking the order as paid.
安装:
- Install and activate WooCommerce if you haven't already.
- Upload the
one-lat-for-woocommercefolder to/wp-content/plugins/, or install the plugin directly from the WordPress plugin screen. - Activate the plugin through the Plugins menu.
- Go to WooCommerce > Settings > Payments > ONE and enable the payment method.
- To test without an account, copy the public API Key and API Secret from ONE developers. To sell for real, create an account at ONE and use your own keys.
- Leave the environment on Staging while you use the test keys. Switch to Production only with your own dashboard credentials.
屏幕截图:
常见问题:
Do I need a ONE account to use this plugin?
Not for a test order. Copy the public test API Key and API Secret from ONE developers and use the Staging environment. To accept live payments you do need an account at one.lat and your own credentials.
Which countries does it work in?
The ONE API supports payments in Argentina, Brazil, Colombia, and Mexico with local methods, plus crypto in any country. The billing currencies supported by the plugin are USD, ARS, BRL, COP, and MXN.
How is a payment confirmed?
ONE notifies status changes via webhook, but the plugin never updates an order based on that notification alone: it always makes an authenticated GET request back to the ONE API to confirm the real status before marking the order as paid, rejected, or expired.
Does the plugin process refunds automatically?
No. The ONE API does not yet expose an endpoint to create refunds, only to look them up. When ONE confirms a refund, the plugin adds a note to the order so you can reconcile it manually — no automatic refund is created in WooCommerce.
Is it compatible with Cart & Checkout Blocks and HPOS?
Yes, both are explicitly declared and tested.
What happens if my store bills in an unsupported currency?
The ONE payment method is automatically hidden at checkout if the store's currency isn't one of the supported ones.
更新日志:
1.0.2
- Release 1.0.2.
- Release 1.0.1.
- Every request to the ONE API now sends two extra headers:
x-woocommerce-plugin-version(the installed plugin version) andx-origin: WOOCOMMERCE, so ONE can identify the integration and enforce a minimum supported plugin version.
- Updated the plugin description (header and readme) to better reflect actual coverage: local payments in 4 countries and crypto worldwide, settlement in USDC dollars.
- Added a "Settings" link on the plugins list page (next to "Deactivate") linking directly to the gateway settings.
- Removed the embedded iframe checkout: both classic checkout and Checkout Blocks now do a full-page redirect to the ONE hosted checkout. This avoids failures in ONE's anti-bot challenge (Cloudflare/AWS WAF), which cannot complete inside a cross-origin iframe.
- Simplified the Cart & Checkout Blocks integration: it no longer depends on pre-creating a draft order or exposing its own REST endpoints for that.
- The payment method title shown to the customer (previously fixed per currency) is now editable per store in the gateway settings, with the same previous text as the default value.
- Removed the hardcoded minimum/maximum amounts: in Staging the error returned by the ONE API is shown as-is (useful for testing); in Production a generic, customer-facing message is shown instead, without exposing numbers that could become outdated relative to the real API.
- Errors returned by the ONE API when creating a Checkout Preference (amount out of range, invalid contact details, credentials, etc.) are now translated into specific messages for the customer, instead of a single generic message.
- First version of the embedded iframe checkout for Checkout Blocks (later replaced in 0.2.0 by the full-page redirect).
- Visible warning in Staging when the store's currency isn't supported or the order amount is out of range.
- Initial version: redirect-type gateway to the ONE hosted checkout.
- Payment confirmation via webhook with authenticated GET verification (the webhook payload is never trusted on its own).
- Logging of ONE refunds as an order note for manual reconciliation.
- Cart & Checkout Blocks integration and HPOS compatibility.
- Option to delete stored settings on uninstall.