Skip to main content
Your billing country is selected when registering a business workspace or personal account. Paid-plan activation, paid add-ons and payable invoice issuance require staff approval of evidence supporting that country.

Verify your country

Open Settings > Billing > Verify billing country in Console or Verify. Upload a PDF, PNG or JPEG of up to 5 MB showing your residence or your organization’s registration/address. Platform staff review the evidence and record their decision. Nationality alone does not necessarily establish residence. A pending country-change review prevents new paid billing until resolved. Changing a recorded country invalidates its previous approval; changing it back does not restore that approval. A rejected change leaves any still-valid approval for the unchanged original country intact.

Prices and provider choices

The authenticated billing configuration and plan catalog use the saved account country. URL country parameters and network location do not change that account’s billing country. Public, unauthenticated catalog estimates may accept a country for comparison; these estimates do not verify eligibility. The current regional catalog applies existing country-group multipliers: full price, Latin America 70%, Middle East/North Africa 80%, Southeast Asia 60%, and the configured Africa and South Asia groups 50%. Country coverage follows the service’s country mapping; these are not blanket discounts for every country on a continent. Individually agreed contracts require their own terms review. Use visible_providers from billing configuration to offer Stripe or Flutterwave, and effective_provider as the default. Configured African routes can offer both. An empty provider list means no provider is available for the recorded country. Paystack is not part of this implementation. Catalog and current hosted checkout amounts are in USD. Regional discounts do not imply local-currency collection or that every bank/mobile-money method is enabled. The provider displays the payment methods actually available for the currency and merchant account.
Flutterwave monthly subscriptions require configured recurring payment plans. Checkout refuses to substitute a one-time charge when a recurring plan is missing. A listed provider or a checkout link does not prove that payment succeeded.

Existing subscriptions

Payment management follows the provider recorded on the subscription. Choosing a different option does not silently transfer an existing subscription or its payment methods. Manage an existing paid subscription before starting a replacement checkout to avoid duplicate subscriptions. Stripe supports the configured payment-method portal. Flutterwave does not provide a matching self-service portal in Truthlocks; use billing support for existing payment arrangements.

API handling

A checkout blocked by country review returns HTTP 409 with code BILLING_COUNTRY_REVIEW_REQUIRED. Direct the account holder to the signed-in country-review page. Do not retry with another country parameter or provider to bypass approval. See checkout, plans, and payment management.