=== 1pay.cx Payments for WooCommerce === Contributors: 1pay Tags: woocommerce, payment gateway, crypto payments, bitcoin, monero Requires at least: 6.0 Tested up to: 7.1 Requires PHP: 7.4 Requires Plugins: woocommerce WC requires at least: 7.0 WC tested up to: 11.2 Stable tag: 2.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Accept card, Bitcoin, Monero and stablecoin payments in WooCommerce. Hosted checkout, on-chain settlement and automatic order updates. == Description == Accept cards and crypto in your WooCommerce store with 1pay.cx. An alternative payment gateway for merchants, including eligible high-risk businesses. No business verification is required to get started, subject to our [Acceptable Use Policy](https://1pay.cx/acceptable-use). Offer hosted checkout with Visa, Mastercard, supported mobile wallets, Bitcoin, Litecoin, Monero and stablecoins. Available methods depend on the buyer and your account settings. Orders are marked paid automatically after verification. Card payments settle on-chain to your configured wallet. Crypto payments are credited to your 1pay.cx balance for withdrawal. The plugin is free; transaction fees apply. ### Features * Accept cards and supported mobile wallets through a hosted checkout. * Accept Bitcoin, Litecoin, Monero and supported stablecoins from crypto wallets. * Start with a 1pay.cx account and API key; no business verification is required to get started, subject to the service's acceptable-use policy. * On-chain card settlement to your configured payout wallet and asset. * A flat 1% service fee for crypto payments; see the fee information below for cards. * Automatic WooCommerce order updates after a signed payment notification and a separate payment-status check with 1pay.cx. * Supports both classic and block-based WooCommerce checkout. * Compatible with WooCommerce High-Performance Order Storage (HPOS). * Uses your WooCommerce order amount, currency, billing email and order reference. * Customize the payment-method title and description shown at checkout. * Optional direct card checkout for stores that want to skip the card-or-crypto selection page. * Test with a 1pay.cx test API key before accepting live payments. * Payment references and confirmation notes are stored on the WooCommerce order. * Card details are entered on the hosted payment-provider page and never pass through your WordPress server. == Installation == 1. Install and activate WooCommerce. 2. In **Plugins > Add New**, search for "1pay.cx Payments for WooCommerce", install it and activate it. You can also upload the plugin ZIP. 3. Sign in to 1pay.cx and create an API key in **Settings > API keys** with permission to create and read payments. 4. Open **WooCommerce > Settings > Payments > 1pay.cx**. 5. Enable the gateway, paste the API key and save. Your key is verified and the payment-notification secret is retrieved automatically. Look for confirmation before accepting payments. 6. Place a test order with a test API key. After verifying your checkout and order updates, save a live API key and configure your settlement preferences in 1pay.cx. [Setup and API documentation](https://1pay.cx/docs#woocommerce) | [Service status](https://1pay.cx/status) | [Fees](https://1pay.cx/merchants#pricing) ### Payment service Requires a 1pay.cx account and API key. Saving or refreshing the key sends it to `https://api.1pay.cx/v1/me` to validate it and retrieve your merchant ID and notification signing secret. At checkout, `https://api.1pay.cx/v1/payments` receives the order amount, currency, billing email, order number, callback URL and return URL; the buyer then visits hosted checkout. Signed notifications trigger an API-key-authenticated check at `https://api.1pay.cx/v1/payments/{payment-id}` before the order is marked paid. Card details never pass through your WordPress server. [Terms of Service](https://1pay.cx/terms) | [Privacy Policy](https://1pay.cx/privacy) | [Acceptable Use Policy](https://1pay.cx/acceptable-use) == Screenshots == 1. Gateway settings in WooCommerce: enable 1pay.cx, customize the checkout label and connect your API key. 2. Classic WooCommerce checkout with the "Pay by card or crypto" payment option. 3. Block-based WooCommerce checkout with the same 1pay.cx payment method. 4. A demonstration order after payment confirmation, with the payment reference and confirmation note recorded in WooCommerce. == Frequently Asked Questions == = Do I need a 1pay.cx account? = Yes. Create a 1pay.cx account and an API key, then connect the key in the gateway settings. The plugin cannot process payments without the 1pay.cx service. Business verification is not required to get started; your business must comply with the service's terms and acceptable-use policy. = Does this plugin require WooCommerce? = Yes. This is a WooCommerce payment gateway for store orders. Version 2.0.0 makes this listing WooCommerce-only; the page-button block and shortcode from the earlier standalone WordPress release are not included. = Which payment methods can my customers use? = The hosted checkout supports cards and available mobile wallets, Bitcoin, Litecoin, Monero and supported stablecoins. Availability varies by country, device, order amount, network and your enabled payment methods. A method that is unavailable for a particular buyer will not be offered to that buyer. = When and where do I receive my funds? = Card payments settle on-chain in the asset and wallet configured in your 1pay.cx account, usually within minutes after a successful payment. Crypto payments appear in your 1pay.cx balance after the required network confirmations, and can then be withdrawn to your own wallet. Timing depends on the payment method and network; the plugin does not guarantee instant payout. = What are the fees? = The plugin has no purchase or subscription fee. The 1pay.cx service charges a flat 1% for crypto payments. For cards, 1pay.cx charges 2.9%, with additional payment-provider and settlement fees depending on the method and country. Check the current pricing and the amount shown at checkout before paying. = Why does checkout say there are no available payment methods? = First check that WooCommerce and this plugin are active, the 1pay.cx gateway is enabled, and the API key was verified when you saved it. Check your store's currency, the order amount and your enabled methods in 1pay.cx. Individual card or wallet methods may have country, device or minimum-amount restrictions. Check the service-status page if the gateway was working previously. = My customer paid, but the order is still pending. What should I check? = Check the payment in your 1pay.cx account and the notes on the WooCommerce order. Your site must be reachable over HTTPS so 1pay.cx can deliver the signed payment notification. A firewall, maintenance page or security plugin must not block the WooCommerce callback URL. A crypto payment may still be waiting for network confirmations. If you need help, provide support with the WooCommerce order number and 1pay.cx payment ID; never send your API key. = Do I need to register a webhook manually? = No. The plugin sends the callback URL with each payment and retrieves the signing secret when you save your API key. Payment notifications are verified before the order is updated. = Does this work with block checkout and HPOS? = Yes. The plugin includes a payment method for WooCommerce's block-based checkout as well as classic checkout, and declares compatibility with High-Performance Order Storage. = Can I test without moving money? = Yes. Save a test API key from 1pay.cx, place a test order and use the test checkout to simulate its outcome. Test payments do not move funds. Replace the test key with your live key only when you are ready to accept real payments. = Does the plugin support multiple currencies? = The plugin sends your WooCommerce order's currency to 1pay.cx. Your currency must be supported by the payment service and available payment methods. The payout asset is configured separately in your 1pay.cx account. = What does direct card checkout do? = It sends the buyer directly to card checkout instead of the 1pay.cx payment selection page. WooCommerce supplies the order's billing email. Because the selection page is skipped, this option does not offer crypto payment methods. Leave it disabled if you want buyers to choose between cards and crypto. = Can I issue refunds from WooCommerce? = This gateway does not provide automatic card refunds through WooCommerce. Arrange refunds through your agreed manual or store-credit process and explain your refund policy to customers before purchase. = Are any businesses restricted? = Yes. Your use of the service must comply with the [Acceptable Use Policy](https://1pay.cx/acceptable-use) and [Terms of Service](https://1pay.cx/terms). Review those policies before connecting your store; installing the plugin does not override service restrictions. = How do I get support for an order or setup problem? = Use the support chat at 1pay.cx or the WordPress.org support forum for this plugin. Include the plugin, WordPress and WooCommerce versions, your order number and the payment ID when applicable. Do not post customer information, API keys or webhook secrets in a public support topic. == Changelog == = 2.0.0 = * Makes the existing 1pay.cx Payments listing the WooCommerce payment gateway. WooCommerce is required; the earlier standalone page-button block and shortcode are not part of this release. * Includes classic checkout, block checkout and HPOS compatibility. * Adds setup instructions, service disclosures, troubleshooting, screenshots and a detailed FAQ for WooCommerce merchants. * Uses the assigned 1pay-cx-payments translation domain and account contributor. * Retains signed payment notifications, mode checks and independent API verification before an order is marked paid. = 1.2.0 = * WooCommerce gateway hardening: verifies the stored payment ID, order amount, currency and mode, and checks paid status through the API before updating an order. * Verifies timestamped payment signatures and refreshes mode-specific secrets. == Upgrade Notice == = 2.0.0 = This listing now provides the WooCommerce gateway. Install and activate WooCommerce, then connect an API key in WooCommerce > Settings > Payments > 1pay.cx. The earlier standalone WordPress page-button block and shortcode are not included.