Geo-routed
Send buyers to a different checkout based on the country they're in, from a single share link.
A geo-routed checkout sends buyers to a different checkout based on the country they're in. You share one link, and CheckoutJoy detects the buyer's country and routes them to the checkout you've assigned.
This lets you offer the right processor, currency, and pricing per region.
For example, you can route your local customers to a checkout priced in their local currency, and international customers to a checkout priced in US Dollars.
- South African buyers → a PayFast checkout priced in Rands (ZAR).
- All other buyers → a PayPal checkout priced in USD + EUR + AUD.
How it works
A flow is built from three elements:
| Element | Purpose |
|---|---|
| Geo Router | The starting point. Detects the buyer's country and sends them down a matching route. |
| Checkout | A hosted checkout page for a product. Add one per audience. |
| Thank-you page | Where the buyer is redirected after a successful payment. |
The Geo Router has one or more routes, each mapping a set of countries to a checkout, plus a Default route that catches every country you haven't assigned.
Creating a geo-routed checkout
Start a new flow
Go to Checkouts, click Create, and choose Geo-routed checkout flow. The flow builder opens with a Geo Router as the starting point.
Add a checkout for each audience
Add a Checkout element for each region you want to target and select the product checkout it should use — for example one PayFast checkout in ZAR and one PayPal checkout in USD.
Set up the routes
On the Geo Router, assign countries to each route (e.g. South Africa to the PayFast route). The Default route handles all other countries.
Connect the elements
Connect each route to its checkout, then connect each checkout to a Thank-you page.
Publish
Click Publish. Share the flow link — buyers are routed automatically by country.