Checkout Payments

List Payments

Retrieve a paginated list of payments for the authenticated merchant.

GET /v1/payments

Retrieve a paginated list of transactions for the authenticated merchant.

Request

Query Parameters

Parameter	Type	Required	Default	Description
`currency`	string	❌	—	Filter by currency: `NGN`, `USD`, `KES`, `GHS`
`status`	string	❌	—	Filter by status: `pending`, `successful`, `failed`, `partial`
`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/payments",
  {
    params: {
      currency: "NGN",
      status: "successful",
      limit: 10,
      page: 1
    },
    headers: {
      Authorization: `Bearer ${process.env.ACCESS_TOKEN}`
    }
  }
);

console.log(response.data);

<?php

$params = http_build_query([
  "currency" => "NGN",
  "status"   => "successful",
  "limit"    => 10,
  "page"     => 1
]);

$ch = curl_init();

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

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

params = {
    "currency": "NGN",
    "status": "successful",
    "limit": 10,
    "page": 1
}

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

Response

200 — Success

{
  "status": "success",
  "message": "Payments retrieved successfully.",
  "data": {
    "total_count": 25,
    "page": 1,
    "limit": 10,
    "payments": [
      {
        "reference": "HCHK380B3716D4",
        "status": "successful",
        "amount": "100.00",
        "currency": "NGN",
        "paid_at": "2025-11-06T01:59:23.000Z",
        "payment_channel": "dynamic_account"
      }
    ]
  }
}

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