Retrieve Proof of Payments (New)

Overview

This endpoint retrieves the official Proof of Payment (POP) for a transaction by supplying the transaction reference. The returned record contains the scheme-specific receipt link or verification data confirming the successful transmission and settlement of funds.

Resource Access

• HTTP Method: GET
• Endpoint: /banking/ibans/v2/profile/transaction-history/proof-of-payment/{reference}
• Authentication: Bearer token required

Request Headers

Header	Value	Required	Description
Accept	application/json	Yes	Content type for the response
Authorization	Bearer {access_token}	Yes	Bearer token for authentication
x-api-key	string	No	API key for additional authentication

Path Parameters

Parameter	Type	Required	Description
reference	string	Yes	The unique transaction reference (e.g., T0-28052024-046).

Response

Success Response (200 OK)

{
  "success": true,
  "result": {
    "pop": "https://storage.ahrvo.network/pop/T0-28052024-046.pdf",
    "type": "Faster Payments Proof of Payment"
  }
}

Response Fields

Field	Type	Description
success	boolean	Indicates whether the proof of payment was successfully retrieved.
result	object	Contains detailed information about the proof of payment.
result.pop	string	URL or digital certificate content of the proof of payment document.
result.type	string	The clearing scheme or document type (e.g., Faster Payments, SEPA, SWIFT).

Error Responses

• 400 Bad Request: Invalid reference parameter format.
• 401 Unauthorized: Missing or expired Bearer access token.
• 403 Forbidden: Access denied to the requested transaction record.
• 404 Not Found: No transaction or proof record found for the provided reference.
• 500 Internal Server Error: Internal platform error while fetching proof of payment.

Code Examples

cURL

curl -X GET "https://api.ahrvo.network/banking/ibans/v2/profile/transaction-history/proof-of-payment/T0-28052024-046" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

Python

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/profile/transaction-history/proof-of-payment/T0-28052024-046"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json()
print("POP URL:", data["result"]["pop"])

JavaScript

const response = await fetch(
  "https://api.ahrvo.network/banking/ibans/v2/profile/transaction-history/proof-of-payment/T0-28052024-046",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_ACCESS_TOKEN",
      "Accept": "application/json"
    }
  }
);

const data = await response.json();
console.log("Proof of Payment:", data.result.pop);

Interactive API Explorer