Get an invoice

Look up an invoice by your reference.

GET/invoices/{reference}

If it’s still open, RazPay asks the provider once, and records it as paid (with its collection) if it has been.

referencepathstringrequired

The invoice’s external_reference.

Response

Request

curl -X GET 'https://api.razpay.razonetix.com/v1/invoices/fees-term2-0042' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("https://api.razpay.razonetix.com/v1/invoices/fees-term2-0042", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.razpay.razonetix.com/v1/invoices/fees-term2-0042",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "success": true,
  "message": "",
  "data": {
    "external_reference": "fees-term2-0042",
    "provider_id": "momo",
    "provider_ref": "5d1e7a2b-9c3f-4e6a-8b0d-2f4c6e8a0b1d",
    "provider_invoice_id": "8810223",
    "payment_reference": "PR-77120",
    "amount": 1500,
    "currency": "SZL",
    "payer_phone": "26876123456",
    "description": "Term 2 school fees",
    "validity_seconds": 1209600,
    "status": "paid",
    "expires_at": 1761984000,
    "metadata": {},
    "created_at": 1760774400,
    "updated_at": 1761206400
  }
}

{ "success": false, "message": "invoice not found", "data": null }