Skip to main content
POST
/
api
/
v2
/
order
/
refund
/
fetch
Refund Status
curl --request POST \
  --url https://api.paytring.com/api/v2/order/refund/fetch \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "id": "<string>",
  "hash": "null"
}
'
{
  "status": true,
  "message": "Refund Data Fetched Successfully",
  "data": {
    "refund_id": "7230436xxxxxxxx056",
    "amount": 100,
    "type": "Full",
    "status": "initiated",
    "rrn": "xxxxxxxxxxxxxxxxxxx",
    "attempted_at": "2xxx-0x-2xT07:55:30.000000Z"
  },
  "request_id": "6xxf20axxxxxf"
}
This API retrieves the status of a refund for a specific order.

​
Request Parameters

  • key (string): Merchant API key
  • refund_id (string): Refund ID
  • hash (string): Calculated hash for request validation

​
Responses

​
200 OK

{
  "status": true,
  "refund_status": "processed",
  "refund_id": "string"
}

​
400 Bad Request

{
  "status": false,
  "error": {
    "message": "Invalid request",
    "code": 400
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
key
string
required

Merchant Account API

​
id
string
required

Refund Id will be provided in refund order api or refund attempts api

​
hash
string
default:null
required

Only required in V1 API . Pass NULL IN V2 API

Response

200

​
status
boolean
default:true
Example:

true

​
message
string
Example:

"Refund Data Fetched Successfully"

​
data
object
​
request_id
string
Example:

"6xxf20axxxxxf"