> ## Documentation Index
> Fetch the complete documentation index at: https://codebeans-payment-rules-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Market Payments Organizer

> The same zone model, keyed off the Shopify Markets you have already configured.

**Create customization → Country Payments Organizer → Organize payment methods by Shopify Market**

The same zone editor as the [Country Payments Organizer](https://codebeans-payment-rules-pro.mintlify.site/payments-organizers/country-payments-organizer.md), keyed off **Shopify Markets** instead of raw countries.

## Why Markets instead of countries

A Market is a group of countries you have already defined in **Shopify Settings → Markets**, together with its currency, pricing, and catalogue. If your commercial reality is already expressed as Markets, mapping payments to Markets keeps one source of truth. Add a country to a Market later and your payment rule follows automatically — with a country-based rule you would have to remember to edit it.

Use countries instead when your payment logic genuinely differs from your market structure — for example one country inside a Market that needs a local method the rest do not.

## Building one

1. **Title** — internal.
2. **Zones** — same as country zones, except **Add markets** offers your configured Shopify Markets rather than a country list.
3. **Available payment methods in this zone** — remove what should not appear, **Edit** to rename or set priority.
4. **Status** → **Save**.

The same gap applies: a Market you leave out of every zone is unaffected, and its customers see the default method list.

## Requirements

The app requests the `read_markets` permission at install, which is what lets it list your Markets. If the market picker is empty, check that you have Markets configured in **Settings → Markets** — a store that has never set one up has only the primary market.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.