GLOBAL PAYMENT (CROSS-BORDER)

Supported Networks

Retrieve supported banks or mobile money operators for a given country and channel. Use the returned network_id in transfer and collection requests.

GET /v1/crossborder/networks

Request

Query Parameters

Parameter	Type	Required	Description
`country_code`	string	✅	ISO 3166-1 alpha-2 country code (e.g. `KE`)
`channel`	string	✅	`bank` for bank networks · `momo` for mobile money operators

Code Samples

const axios = require("axios");

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

console.log(response.data);

<?php

$params = http_build_query([
  "country_code" => "KE",
  "channel"      => "bank"
]);

$ch = curl_init();

curl_setopt_array($ch, [
  CURLOPT_URL => "https://sandbox.hitchpay.ng/v1/crossborder/networks?{$params}",
  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/networks"

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

params = {
    "country_code": "KE",
    "channel": "bank"
}

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

Response

200 — Success

{
  "status": "success",
  "message": "Supported networks retrieved successfully.",
  "data": [
    {
      "network_id": "30f11b2e-0905-4c09-ba5f-d05aa4e4a11c",
      "country": "KE",
      "name": "NATIONAL BANK OF KENYA",
      "channelIds": [
        "de274d59-46b3-49a8-8836-3c0cc5b73a4f"
      ]
    },
    {
      "network_id": "7ea6df5c-6bba-46b2-a7e6-f511959e7edb",
      "country": "KE",
      "name": "M-PESA",
      "channelIds": [
        "cebda160-9966-4485-8d36-6205d516b050"
      ]
    }
  ]
}

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