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"
}'
"{\n    \"status\": true,\n    \"message\": \"Refund Data Fetched Successfully\",\n    \"data\": {\n        \"refund_id\": \"7230436xxxxxxxx056\",\n        \"amount\": 100,\n        \"type\": \"Full\",\n        \"status\": \"initiated\",\n        \"rrn\": \"xxxxxxxxxxxxxxxxxxx\",\n        \"attempted_at\": \"2xxx-0x-2xT07:55:30.000000Z\"\n    },\n    \"request_id\": \"6xxf20axxxxxf\"\n}"
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"

⌘I