How country_locked affects checkout country, currency, and payment availability

When you create an order with country_locked=true, the order country is fixed at creation time. That also fixes the checkout currency for that order.

What this means in practice

• The player cannot switch the order country during checkout.

• The billing system returns only payment methods available for the order's country.

• If a payment method does not support the combination of the order currency/country and the player's actual card or payment instrument, the payment can be declined.

Example

If an order is created in USD and locked to a non-UK country, a player attempting to pay with a UK card may see the payment fail if the selected payment method does not support that combination.

What happens when country_locked is disabled

If country_locked is turned off, the player can be prompted to switch country when they choose a payment method that does not match the current order country.

1. The player selects a payment method that is unavailable for the current order country.

2. Checkout offers to change the country.

3. If the player agrees, the country is updated and the price and currency are recalculated according to the pricing matrix for the new country.

4. If the player declines, that payment method remains unavailable.

When to use it

• Use country_locked=true if you need the order country and currency to remain fixed.

• Disable it if you want players to be able to complete payment with payment methods tied to a different country, with checkout recalculating the price and currency as needed.

Troubleshooting

If a player says they previously could pay but now cannot, verify:

• whether country_locked is currently enabled,

• which country is being sent during order creation, and

• whether the expected payment method supports that country/currency combination.