Initiate Refund

POST

https://secure-staging.setu.solutions/v1/api/payment/refund

This endpoint refunds a successful payment. Only channels that support upstream refunds can use it, and only 30 minutes after the payment is completed. Identify the order with transactionRef. When the refund is accepted, status is Refund.

Request

Header Params

Body Params application/json

Example

{
    "transactionRef": "2c4d9ff6-dc9a-4bee-a751-18071257685c"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://secure-staging.setu.solutions/v1/api/payment/refund' \
--header 'MerchantID: FX100001' \
--header 'Signature: paLAc7iNnnFhOYaKIgukzKXNPHIMES47pFnrnHtZ9LZjRyeqehMeKnb7alAdvB8xkUwOJ7y4V1tMSIDXh2otHi2NAxpOMZBrE4D9JWqhEPWQQMJrjrqousC9pfibDXP0I6lhSFoaV0iAQjTcrpfz2ONSpswz3pvYy27UJtldai6gBx1eI2PztrWiotsMojx7TcERibfXjP0wY8mScGePSUxjWThkKK5FggBvkKOXyvQe27nZ7isHUEAdAhdbgeRV' \
--header 'Timestamp: 1750554703' \
--header 'Content-Type: application/json' \
--data '{
    "transactionRef": "2c4d9ff6-dc9a-4bee-a751-18071257685c"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

SUCCESSFAIL

{
    "code": "200",
    "message": "SUCCESS",
    "data": {
        "transactionRef": "dfce0d4d-0bdb-47b3-9cc9-b2e0f7905dac",
        "merchantRef": "de76d2c9-b4e7-4122-a066-d52fe2b5842e",
        "currency": "INR",
        "method": "NATIVE",
        "amount": 100.01,
        "paidAmount": 100.01,
        "fee": 5.5,
        "status": "Refund",
        "utr": "6265241431",
        "payerVPA": "test@pthdfc",
        "payerName": "test name"
    }
}

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Modified at 2026-10-08 20:05:37

Fetch Payment Status

Payout Webhook