Country context

GET /v1/countries/{code}/context

Public endpoint: no authentication required. Returns one country's summary plus its enabled service list, payment methods, and supported languages: the payload a client needs to render a market's entry screens.

Path

Param	In	Required	Notes
`code`	path	yes	ISO 3166-1 alpha-2

curl https://api.ouipay.africa/v1/countries/NG/context

Response `200`

{
  "data": {
    "code": "NG",
    "name": "Nigeria",
    "currency_code": "NGN",
    "currency_symbol": "₦",
    "phone_code": "+234",
    "locale": "en-NG",
    "flag_emoji": "🇳🇬",
    "registration_enabled": true,
    "exchange_enabled": true,
    "payments_enabled": true,
    "services_enabled": true,
    "timezone": "Africa/Lagos",
    "default_language_code": "en",
    "services": [
      {
        "service_code": "airtime",
        "title": "Airtime",
        "description": "Mobile airtime top-up",
        "icon": "phone",
        "sort_order": 1
      }
    ],
    "payment_methods": [
      {
        "method": "wallet",
        "enabled": true,
        "min_amount_minor": null,
        "max_amount_minor": null
      },
      {
        "method": "bank_transfer",
        "enabled": true,
        "min_amount_minor": 10000,
        "max_amount_minor": null
      }
    ],
    "supported_language_codes": ["en", "fr"]
  }
}

The services list is the static country catalogue: what the market offers. It is not the customer-resolved catalogue: executability, eligibility, and presentation state live on the authenticated GET /v1/services call.

Errors

HTTP	`error.code`	Cause
400	`VALIDATION`	`code` is not a 2-letter ISO code
404	`NOT_FOUND`	Country not found or disabled

Country context

Path

Response 200

Errors

On this page

Response `200`