Initiate Refund

POST

/v2/refunds

Create a refund request for a previously completed payment.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v2/refunds' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 5000,
  "payment_id": "01KDH46CNWCPF25GQVHSWRWMWV",
  "merchant_reference": "refund_12345"
}'

Response Example

{
  "status": "success",
  "data": {
    "status": "successful",
    "message": "Refund request processed successfully",
    "data": {
      "id": "01KEVMNH1VJ5XA23KDHXRX972A",
      "merchant_reference": "e25c42ab-ab9e-4dc4-b5ad-7972a4e1cc55",
      "payment_id": "01KEH0ZC38ED8ER4D2EFH1YC47",
      "amount": 500,
      "currency": "USD",
      "status": "completed",
      "created": 1768306689083
    }
  }
}

Modified at 2026-01-13 12:30:38

Get Payment

List Refunds