Description
Caravel Pay adds a hosted checkout to WooCommerce. Buyers pay by card, Apple Pay or Google Pay (or directly with USDC, USDC.e or POL on Polygon), and each paid order is sent straight to your own Polygon wallet. There is no account to create, no merchant application, no dashboard and nothing to withdraw, which suits stores that card processors call high-risk.
- Paste your payout wallet and save. That connects your store; there is nothing else to copy.
- Classic checkout and Checkout block, and High-Performance Order Storage (HPOS). Card and wallet logos fade into each other next to the title.
- Orders update themselves from signed webhooks: Processing (or Completed for virtual and downloadable orders) when paid, On hold when underpaid or under review, Cancelled when the checkout expires.
- A note on every paid order shows the payout amount, the token and a link to the transaction.
- PayPal and Venmo for US buyers (optional, orders from $25), paid out in PYUSD on Ethereum, never swapped. Buyers can also send from Cash App (US, not New York) or the Revolut app (UK, Norway).
- A separate “Revolut” choice (optional): the payment page opens on Revolut only.
- Prices in your own currency. US dollars, euros, pounds and 24 more: the order total is converted to US dollars when the buyer pays, and the buyer sees it first.
- You choose who pays the fees: you (the default), your buyer for the card provider’s fee, or your buyer for both fees. Card surcharges are restricted in some countries, so check your local rules before passing fees on.
- Moving from the PayGate plugin? “Import from PayGate plugin” copies your checkout title, description and icon and shows your PayGate payout wallet. The PayGate plugin is only read, never changed.
What it costs
Caravel Pay charges one fee: the 2% Caravel fee on each payment. It is taken from the payment before your payout is sent, and it includes the network gas for the payout. There is no setup fee and no monthly fee.
A card payment goes through an independent card provider. Your buyer pays the order total, and most card providers keep their own fee out of it before the USDC arrives. Typically that is about 5%: on a $100 order, 95.00 USDC arrives and you receive 93.00 USDC. Not a guarantee: most card orders so far were between 4% and 6%. Details: https://caravelpay.app/pricing/
Requirements
- WooCommerce on a site served over HTTPS.
- A supported store currency (see the FAQ).
- A Polygon address you control, for payouts.
Full guide: https://caravelpay.app/docs/woocommerce
Visa, Mastercard, Apple Pay and Google Pay are trademarks of their owners.
External services
This plugin connects to the Caravel Pay API (https://api.caravelpay.app), a service run by Caravel Pay, to create payments and confirm them. It is required: the plugin can’t take payments without it. The plugin sends data only at these moments:
- When you save the settings for the first time, change the payout wallet, or click Reconnect: your site address, your payout wallet address, your WordPress admin email address (used only for operational notices, never for a login), the platform name (“woocommerce”) and the plugin version. Caravel Pay answers with a merchant ID and secret, which the plugin stores in your database and never displays. Replaced credentials are kept for 7 days so payments already started can still be confirmed.
- On the plugin’s settings page, and at most every 10 minutes when checkout is shown: a signed request for your connection status (merchant ID only).
- When checkout is shown in a store that doesn’t price in US dollars, at most every 10 minutes: a signed request for the current exchange rate (merchant ID and your store’s currency code only), so the buyer can be shown an estimate in US dollars.
- When a buyer places an order with Caravel Pay: the order reference, order total, currency, the buyer’s billing email address (to prefill the payment page), and your store’s return, cancel and webhook URLs, plus your “Who pays the fees” choice and exchange-rate buffer when they aren’t the defaults. The buyer is then redirected to the hosted payment page at https://pay.caravelpay.app, where they enter their payment details with Caravel Pay’s card providers. Card details never pass through your site.
- When you turn the PayPal and Venmo setting on or off: a signed request with that choice and the Ethereum payout address, if you entered one.
- When checkout is shown with the Revolut choice turned on, at most every 10 minutes: an unsigned request for Caravel Pay’s public list of the countries Revolut serves (https://api.caravelpay.app/api/v1/provider-country-policies). Nothing about your store, the order or the buyer is sent; the buyer’s billing country is compared with the list on your own site.
- When Caravel Pay sends a webhook to your site, and while the buyer views the order-received page: a signed request for the checkout’s current status (checkout ID only).
Caravel Pay terms of service: https://caravelpay.app/terms/
Caravel Pay privacy policy: https://caravelpay.app/privacy/
No other data is sent, and no code is loaded from outside the plugin.
Installation
- In WordPress, go to Plugins › Add New Plugin, search for “Caravel Pay” and click Install Now.
- Click Activate Plugin. WooCommerce must be installed and active.
- Go to WooCommerce › Settings › Payments › Caravel Pay, turn on Enable, paste your Polygon payout wallet and save. The status line shows Connected.
- Place a cheap test order in a private browser window and pay it.
FAQ
Do I need an account with Caravel Pay?
No. Saving your payout wallet connects the store; there is no login and no dashboard. Your buyers may be asked by the card provider to verify their identity, usually only the first time they buy.
Do my buyers need crypto?
No. They pay by card, Apple Pay or Google Pay on a hosted page and return to your order-received page.
Can buyers pay with PayPal or Venmo?
Yes, US buyers, once you tick “PayPal and Venmo (US buyers)” in the settings. They send PYUSD on Ethereum from the app; you receive it minus the 2% Caravel fee, at an Ethereum address you control (an exchange deposit address may not credit PYUSD).
Can I offer a separate “Revolut” choice?
Yes. Turn on Enable under WooCommerce › Settings › Payments › Caravel Pay: Revolut (Caravel Pay itself must be connected). Buyers who pick it go straight to Revolut on the payment page. It is shown only where Revolut serves the buyer’s billing country, and you can set a minimum order total.
Can a payout be reversed?
No. A payout is an on-chain transfer to your wallet, and nobody can pull it back, so check your wallet address twice. Refunds are yours to send, from your wallet or another way you agree with your buyer.
Caravel Pay doesn’t show at checkout
Make sure Enable is on, a payout wallet is saved, the status line on the settings page says Connected, and the store currency is one Caravel Pay supports.
An order stays on Pending payment after paying
The webhook is probably not reaching your store. Check that no security plugin, firewall, CDN rule, maintenance mode, password or page cache blocks POST requests to /wp-json/caravel-pay/v1/webhook. Every webhook is logged under WooCommerce › Status › Logs (source caravel-pay) and retried for up to 24 hours.
The status line says “Not connected”
The line shows the reason. Your site needs a public https:// address and outgoing HTTPS requests, and the payout wallet must be a Polygon address you control. Fix the cause, then click Reconnect.
How do I change my payout wallet?
Enter the new wallet and save. The plugin reconnects and receives new credentials: new orders pay out to the new wallet, and orders already started keep the previous one.
My store doesn’t price in US dollars. Does it work?
Yes. Supported store currencies: USD, EUR, GBP, CAD, AUD, NZD, SEK, NOK, DKK, CHF, PLN, CZK, HUF, RON, HKD, SGD, MXN, BRL, ZAR, ILS, INR, THB, MYR, PHP, TRY, JPY and KRW. Your prices and orders stay in your own currency. When a buyer chooses Caravel Pay, the order total is converted to US dollars at that moment’s rate and fixed for the payment: buyers are charged in US dollars and you are paid in USDC. Checkout and the payment page show both prices.
What is the exchange-rate buffer?
An optional margin (0 to 5%) on the converted amount, for stores that don’t price in US dollars, to cover exchange-rate movement before you convert your USDC. Leave it at 0 to charge the plain converted amount.
Screenshots
Changelog
1.2.7
- Checkout logos: Visa, Mastercard, Apple Pay and Google Pay, one after another next to the title. Setting “Checkout logos”; an imported icon is kept.
- Payouts in USDT or ETH link to Etherscan.
1.0.0 to 1.2.6
- First release; “Who pays the fees”; 26 more store currencies and the exchange-rate buffer; PayPal and Venmo for US buyers; the “Revolut” choice; filter caravel_pay_cancel_expired_order.




