Skip to content
HitchPay API Docs

GLOBAL PAYMENT (CROSS-BORDER)

List Transactions

Retrieve a paginated list of all cross-border transactions (transfers and collections) for the authenticated merchant.

GET /v1/crossborder/transactions

Request

Query Parameters

Parameter Type Required Default Description
type string ❌ — Filter by type: transfer or collection
status string ❌ — Filter by status: processing, successful, failed, reversed
limit integer ❌ 10 Records per page
page integer ❌ 1 Page number

Code Samples

const axios = require("axios");

const response = await axios.get(
  "https://sandbox.hitchpay.ng/v1/crossborder/transactions",
  {
    params: {
      type: "transfer",
      status: "successful",
      limit: 20,
      page: 1
    },
    headers: {
      Authorization: `Bearer ${process.env.ACCESS_TOKEN}`
    }
  }
);

console.log(response.data);
<?php

$params = http_build_query([
  "type"   => "transfer",
  "status" => "successful",
  "limit"  => 20,
  "page"   => 1
]);

$ch = curl_init();

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

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

params = {
    "type": "transfer",
    "status": "successful",
    "limit": 20,
    "page": 1
}

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

Response

200 — Success

{
  "status": "success",
  "message": "Transactions retrieved successfully.",
  "data": {
    "total_count": 5,
    "page": 1,
    "limit": 10,
    "transactions": [
      {
        "type": "transfer",
        "reference": "HTCB606D14B03A77",
        "external_reference": "9029112992",
        "status": "processing",
        "reason": "Payment for services",
        "failure_reason": null,
        "created_at": "2026-03-16T00:58:11.000Z",
        "amount_sent": 5,
        "source_currency": "USD",
        "destination_currency": "KES",
        "estimated_amount_received": 645.18,
        "beneficiary": {
          "account_name": "John Smith",
          "country_code": "KE"
        }
      }
    ]
  }
}

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