Payment Tracking Details (Atlas)

Overview

The GET /banking/ibans/v2/payments/payment-tracking/{reference} endpoint returns complete banking tracking details for an outbound transfer or FX order using its unique business reference.

This includes:

• SWIFT MT103: Raw or structured SWIFT settlement message (Fields 71A, 72, 77B).
• SWIFT GPI UETR: Unique End-to-End Transaction Reference for tracking cross-border payments across correspondent banking networks.
• Unique Bank Reference: Core clearing network tracking ID.
• Proof of Payment (pop): Direct pre-signed URL or S3 link to the generated PDF proof of payment.

Resource Access

• HTTP Method: GET
• Endpoint: /banking/ibans/v2/payments/payment-tracking/{reference}
• Authentication: Bearer token required
• Permissions: Client:Make Payment To Account:write, Client:Make Payment To Another Business:write, Admin:Exchange Now:write, Client:At Desired Rate:write

Request Headers

Header	Value	Required	Description
Authorization	Bearer {access_token}	Yes	JWT Bearer access token
Accept	application/json	Yes	Response payload format

Path Parameters

Parameter	Type	Required	Pattern	Description	Example
reference	string	Yes	^(TO|EN)-[A-Z0-9-]+$	FX order (EN-...) or wallet payout reference (TO-...).	TO-29072023-A114

---

Response

Success Response (200 OK)

{
  "reference": "TO-01012025-A111",
  "mt103": ":71A:OUR\n:72:BNF\n:77B:Invoice 4059",
  "uetr": "dd60300f-25e6-4fb3-bb87-36ceb02844f2",
  "uniqueBankReference": "BNK-9883104",
  "pop": "https://s3.amazonaws.com/ahrvo-settlements/proofs/TO-01012025-A111.pdf",
  "type": "PDF"
}

Response Fields

Field	Type	Description
reference	string	Matched order or payment reference.
mt103	string	SWIFT MT103 raw confirmation string (if routed via SWIFT).
uetr	string	36-character SWIFT GPI Unique End-to-End Transaction Reference.
uniqueBankReference	string	Clearing bank settlement sequence number.
pop	string	S3 download URI or pre-signed link for the official Proof of Payment document.
type	string	Document type format (e.g. PDF, MT103, UETR).

---

Code Examples

cURL

curl -X GET "https://api.ahrvo.network/banking/ibans/v2/payments/payment-tracking/TO-29072023-A114" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

JavaScript (Fetch)

const reference = 'TO-29072023-A114';
const response = await fetch(`https://api.ahrvo.network/banking/ibans/v2/payments/payment-tracking/${reference}`, {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Accept': 'application/json'
  }
});

const tracking = await response.json();
console.log('UETR:', tracking.uetr);
console.log('Proof of Payment:', tracking.pop);

Python (requests)

import requests

reference = "TO-29072023-A114"
url = f"https://api.ahrvo.network/banking/ibans/v2/payments/payment-tracking/{reference}"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
}

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

---

Interactive API Console

Test the endpoint directly in your browser: