GLOBAL PAYMENT (CROSS-BORDER)

Supported Countries

Retrieve the full list of countries supported for cross-border transfers and collections. Use the returned code and currency when calling the channels and networks endpoints.

GET /v1/crossborder/countries

Code Samples

const axios = require("axios");

const response = await axios.get(
  "https://sandbox.hitchpay.ng/v1/crossborder/countries",
  {
    headers: {
      Authorization: `Bearer ${process.env.ACCESS_TOKEN}`
    }
  }
);

console.log(response.data);

<?php

$ch = curl_init();

curl_setopt_array($ch, [
  CURLOPT_URL => "https://sandbox.hitchpay.ng/v1/crossborder/countries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ]
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

url = "https://sandbox.hitchpay.ng/v1/crossborder/countries"

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

Response

200 — Success

{
  "status": "success",
  "message": "Supported countries retrieved successfully.",
  "data": [
    { "name": "Nigeria",        "code": "NG", "currency": "NGN" },
    { "name": "Kenya",          "code": "KE", "currency": "KES" },
    { "name": "Ghana",          "code": "GH", "currency": "GHS" },
    { "name": "Uganda",         "code": "UG", "currency": "UGX" },
    { "name": "Tanzania",       "code": "TZ", "currency": "TZS" },
    { "name": "South Africa",   "code": "ZA", "currency": "ZAR" },
    { "name": "United States",  "code": "US", "currency": "USD" },
    { "name": "United Kingdom", "code": "GB", "currency": "GBP" }
  ]
}

Always call this endpoint dynamically — do not hardcode the country list.

Questions? Email [email protected]. Also on GitBook.