Get a transaction

Look up any of your project's transactions by your own reference.

GET/payments/{reference}

Returns a collection, payout or refund by its external_reference. If it’s still pending, RazPay also asks the provider once, so this doubles as a status check.

referencepathstringrequired

The transaction’s external_reference.

Response

A transaction, plus:

refundsarrayrequired

For a collection, its refunds (each a transaction with type: refund). Empty otherwise.

refund_summaryobjectrequired

For a collection, how much has been returned.

properties

refundednumberrequired

Total of successful refunds.

pendingnumberrequired

Total of refunds still in progress.

refundablenumberrequired

What’s left to refund. 0 for anything that can’t be refunded.

Request

curl -X GET 'https://api.razpay.razonetix.com/v1/payments/order-1001' \
  -H 'Authorization: Bearer YOUR_TOKEN'

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

import requests

response = requests.get(
    "https://api.razpay.razonetix.com/v1/payments/order-1001",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "success": true,
  "message": "",
  "data": {
    "external_reference": "order-1001",
    "type": "collection",
    "direction": "in",
    "provider_id": "momo",
    "provider_ref": "6f0a2e1c-8b1d-4a8e-9a55-0c7d0e3b1f42",
    "amount": 30,
    "currency": "SZL",
    "status": "successful",
    "financial_tx_id": "6543210987",
    "payer_phone": "26876123456",
    "metadata": {},
    "created_at": 1760774400,
    "updated_at": 1760774460,
    "refunds": [],
    "refund_summary": { "refunded": 0, "pending": 0, "refundable": 30 }
  }
}

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