DYNAMIC PAYMENTS

Retrieve Dynamic Payment

GET /v1/payments/dynamic-account/{tracking_id}

Retrieve the current status and details of a dynamic account payment using its tracking_id.

Request

Headers

Header	Value
`Authorization`	`Bearer {access_token}`

Path Parameters

Parameter	Type	Required	Description
`tracking_id`	string	✅	The `tracking_id` returned from the Create Dynamic Account endpoint

Code Samples

const axios = require("axios");

const trackingId = "EXTPAYA2165E437665";

const response = await axios.get(
  `https://sandbox.hitchpay.ng/v1/payments/dynamic-account/${trackingId}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.ACCESS_TOKEN}`
    }
  }
);

console.log(response.data);

<?php

$trackingId = "EXTPAYA2165E437665";

$ch = curl_init();

curl_setopt_array($ch, [
  CURLOPT_URL => "https://sandbox.hitchpay.ng/v1/payments/dynamic-account/{$trackingId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ]
]);

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

echo $response;

import requests

tracking_id = "EXTPAYA2165E437665"

url = f"https://sandbox.hitchpay.ng/v1/payments/dynamic-account/{tracking_id}"

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

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

Response

200 — Success

{
  "status": "success",
  "message": "Payment retrieved successfully.",
  "data": {
    "tracking_id": "EXTPAYA2165E437665",
    "merchant_reference": "1232456789",
    "amount": "1000.00",
    "amount_paid": null,
    "currency": "NGN",
    "description": "Testing",
    "account_number": "6020006173",
    "bank_name": null,
    "status": "paid",
    "date_created": "1776706406",
    "paid_at": null
  }
}

Payment Status Values

Status	Description
`pending`	Account generated, awaiting payment
`paid`	Payment received successfully
`failed`	Payment attempt failed
`expired`	Account expired before payment was received (after 15 minutes)

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