POST
/
refunds
/
{refund_id}
curl --request POST \
  --url https://sandbox.hyperswitch.io/refunds/{refund_id} \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "reason": "Paid by mistake"
}'
{
  "refund_id": "<string>",
  "payment_id": "<string>",
  "amount": 6540,
  "currency": "<string>",
  "status": "succeeded",
  "reason": "<string>",
  "metadata": {},
  "error_message": "<string>",
  "error_code": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "connector": "stripe",
  "profile_id": "<string>",
  "merchant_connector_id": "<string>",
  "charges": {
    "charge_id": "<string>",
    "revert_platform_fee": true,
    "revert_transfer": true
  }
}

Authorizations

api-key
string
headerrequired

Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.

Path Parameters

refund_id
string
required

The identifier for refund

Body

application/json
reason
string | null

An arbitrary string attached to the object. Often useful for displaying to users and your customer support executive

metadata
object | null

You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long. Metadata is useful for storing additional, structured information on an object.

Response

200 - application/json
refund_id
string
required

Unique Identifier for the refund

payment_id
string
required

The payment id against which refund is initiated

amount
integer
required

The refund amount, which should be less than or equal to the total payment amount. Amount for the payment in lowest denomination of the currency. (i.e) in cents for USD denomination, in paisa for INR denomination etc

currency
string
required

The three-letter ISO currency code

status
enum<string>
required

The status for refunds

Available options:
succeeded,
failed,
pending,
review
reason
string | null

An arbitrary string attached to the object. Often useful for displaying to users and your customer support executive

metadata
object | null

You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long. Metadata is useful for storing additional, structured information on an object

error_message
string | null

The error message

error_code
string | null

The code for the error

created_at
string | null

The timestamp at which refund is created

updated_at
string | null

The timestamp at which refund is updated

connector
string
required

The connector used for the refund and the corresponding payment

profile_id
string | null

The id of business profile for this refund

merchant_connector_id
string | null

The merchant_connector_id of the processor through which this payment went through

charges
object

Charge object for refunds