A Caravel Pay partner connects stores to Caravel Pay and adds its own fee to their payments. You sign up on this site in a minute: no call, no application form and no review. Your fee is paid on-chain to your own Polygon wallet with every paid order, in the same settlement as the store's payout.
Sign up as a partner Read the partner API
How it works#
- Sign up. Give your Polygon wallet, your name, a contact email and the highest fee you want to be able to charge, up to 12%. You get a partner id and a partner secret straight away. The secret is shown once: store it like a password.
- Put your brand on the checkout (optional). Send your name, logo and colour once. Every checkout of a store you connected then shows your brand instead of Caravel Pay's.
- Connect stores. From your own server with a signed API call, or with a partner code that the store's integration sends when it connects. You choose your fee for each store.
- Get paid on every order. When a buyer pays, the payment is split on-chain: the store's payout to the store's wallet, the 2% Caravel fee, and your fee to your wallet. Nobody holds your fee and there is nothing to invoice.
Fees#
- The 2% Caravel fee stays the same for stores connected through a partner. It is not shared with partners.
- Your fee is yours. You set it for each store, from 0.01% up to your own maximum, and no partner fee is above 12%. It is a share of the order amount, rounded to the cent like the 2% Caravel fee, and it comes off what the store receives.
- The store sees both. When a store is connected through you, its connect answer and its merchant record show the 2% Caravel fee, your fee and the total.
- No monthly fee and no setup fee, for you or for the store. There is no referral or affiliate payout: partners earn their own fee only.
Worked example, a $100 order from a store you connected at 1.5%:
| The buyer pays | $100.00 |
|---|---|
| The card provider keeps, typically | −$5.00 |
| Arrives | 95.00 USDC |
| 2% Caravel fee (of the order amount) | −2.00 USDC |
| Your fee, 1.5% (of the order amount) | −1.50 USDC, sent to your wallet |
| The store receives | 91.50 USDC |
About 5% is typical of the card orders paid through Caravel Pay so far; most were between 4% and 6%, a few under 1% or up to about 8%. It depends on the provider, the payment method, the buyer's country and the order size, so it is an estimate, not a guarantee. Payments sent directly in crypto have no provider fee.
Your brand on the checkout#
Partners can white-label the hosted checkout of the stores they connect. You send a display name, an accent colour, an optional website and an optional PNG logo with one API call (how).
- What buyers see: your logo or name in the top bar, in your colour; your name in the browser tab and footer; and your name wherever the checkout's texts would name Caravel Pay, in all 13 languages of the checkout.
- What stays the same: the amount, the payment methods, the payouts and the fees. The "Report this seller" link stays on every checkout, so buyers can always reach us about a store.
- Where the checkout runs: at
pay.caravelpay.app, with your brand on it. Checkouts on your own domain are not available. - Payment links that your stores create still show Caravel Pay's brand on the link page; the checkout they open shows yours.
Connecting stores#
- From your server. Sign
POST /v1/connectwith your partner id and secret, and name your fee for that store. You get the store's own merchant id and secret back, and you run its checkouts or hand the credentials to its integration. See Connect a store. - With a partner code. A partner code names you, your fee for the stores that use it and an expiry date (at most a year). You make it with your secret, on the sign-up page or in your own code, and give it to the store. The store's integration sends it with its connect call, and the store is connected through you at that fee. Your secret never leaves you. See Partner codes.
- WooCommerce. The Caravel Pay WooCommerce plugin connects a store on its own, without a partner. To connect a WooCommerce store through you, connect it from your server, or use your own integration that sends your partner code.
Each store's fee is fixed when it connects. A different fee means connecting again, which gives the store a new merchant id; open checkouts keep the fee they were created with. You can connect up to 50 stores in any 24 hours.
Partner rules#
Version 2026-11-15. You accept these rules when you sign up.
- Every store you connect follows the acceptable use policy. You are responsible for checking the stores you connect and what they sell.
- Tell each store your fee before you connect it. Only connect stores that agreed to it. The store also sees your fee and the total in its own records.
- Your brand must be your own. Don't use the name or logo of another business (a bank, a card network, a wallet or another payment company), and don't choose a name meant to mislead buyers.
- Describe Caravel Pay honestly. Don't promise stores or buyers anything it doesn't do.
- Keep your partner secret private. Anyone who has it can connect stores as you and change your brand. If it leaks, stop using that partner id.
- We can pause a partner, or a store connected through it, that breaks these rules, without notice. A paused partner can't connect new stores or change its brand. Stores it already connected keep working on the fee they were connected with, unless we pause them too.
- One business, few partner ids. A wallet and a contact email can each belong to at most 3 partners.
- No promises. Caravel Pay doesn't promise you any number of stores, orders, payments or earnings, and doesn't promise that any card provider will serve a given buyer or store.
- The rules can change. A change gets a new version date on this page.
Who sees what#
- Caravel Pay sees every partner, its contact email and wallet, and every store connected through it with its fee and payment totals.
- Stores see your partner id, your fee and the total fee in their connect answer and their merchant record.
- Buyers see your brand on the checkout, if you set one. They never see your fee.
- Your own records:
GET /v1/partnerandGET /v1/partner/merchants, and your wallet's history on Polygon, where every fee you were paid is a transfer.
Frequently asked questions#
Is there a review before I can start?#
No. The sign-up creates your partner id at once. We keep an eye on who signs up and on the stores they connect, and we pause partners and stores that break the partner rules or the acceptable use policy.
Can I get a share of the 2% Caravel fee?#
No. There is no referral or affiliate program. Partners earn their own fee, which they add on top of the 2% Caravel fee.
Do I need POL for gas?#
No. The transfer of your fee to your wallet is sent for you, like the store's payout.
Can I change my fee or my wallet?#
Your fee is chosen per store, up to your maximum. Your maximum and your wallet are fixed for your partner id; for a new maximum or a new wallet, sign up again for a new partner id. Stores you already connected keep paying the wallet and fee they were connected with.
What if I lose my partner secret?#
It can't be shown again. Sign up again for a new partner id. Stores connected under the old id keep working and keep paying the old wallet.
What about refunds and disputes?#
The same as on every Caravel Pay checkout: payouts are final on-chain transfers, a dispute is between the buyer, their bank and the card provider, and the store sends any refund itself. Neither the 2% Caravel fee nor your fee is returned.
Can the checkout run on my own domain?#
Not today. The checkout runs at pay.caravelpay.app, with your brand on it.