Create a Refund

Initiates a refund against a captured payment. If amount is not specified, the full payment amount is refunded. You can issue multiple partial refunds as long as the total does not exceed the captured amount.

POST /payments/{id}/refund

Create a Refund

cURL

curl --request POST \
  --url https://api.razorpay.com/v1/payments/{id}/refund \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 50000,
  "speed": "normal",
  "notes": {
    "reason": "Customer request"
  },
  "receipt": "receipt_refund_1001"
}
'

200

{
  "id": "rfnd_FP8QHiV938haTz",
  "entity": "refund",
  "amount": 50000,
  "currency": "INR",
  "payment_id": "pay_DJkTfWoJ5ZFPce",
  "status": "processed",
  "speed_processed": "normal",
  "receipt": "receipt_refund_1001",
  "notes": {
    "reason": "Customer request"
  },
  "created_at": 1595491208
}

Authorizations

Authorization · string · header · required

Use your Razorpay Key ID as the username and Key Secret as the password.

Path Parameters

id · string · required

The unique identifier of the captured payment to refund.

Example:

"pay_DJkTfWoJ5ZFPce"

Body

application/json

Request body for creating a refund against a payment. If amount is omitted, a full refund is initiated.

amount · integer

The amount to refund, in the smallest currency sub-unit. If not provided, the full payment amount is refunded. Must not exceed the captured payment amount.

Example:

50000

speed · enum<string>

The processing speed for the refund. normal takes 5-7 business days; optimum processes instantly where supported, falling back to normal otherwise.

Available options: normal, optimum

Example:

"normal"

notes · object

A key-value store of custom metadata to attach to the refund.

Show child attributes

Example:

{ "reason": "Customer request" }

receipt · string

A unique receipt number for the refund, for your internal reference.

Example:

"receipt_refund_1001"

Response

200

application/json

The refund was successfully initiated. Returns the refund object.

A Razorpay Refund object representing a refund transaction.

id · string

Unique identifier for the refund.

Example:

"rfnd_FP8QHiV938haTz"

entity · string

Entity type, always refund for refund objects.

Example:

"refund"

amount · integer

The refund amount in the smallest currency sub-unit (e.g., paise for INR).

Example:

50000

currency · string

The ISO 4217 currency code for the refund.

Example:

"INR"

payment_id · string

The unique identifier of the payment against which the refund was initiated.

Example:

"pay_DJkTfWoJ5ZFPce"

status · enum<string>

The current status of the refund.

Available options: pending, processed, failed

Example:

"processed"

speed_processed · string

The processing speed at which the refund was processed. normal refunds are processed within 5-7 business days; optimum refunds are processed instantly where supported.

Example:

"normal"

receipt · string

A unique receipt number for the refund, for your internal reference.

Example:

"receipt_refund_1001"

notes · object

A key-value store of custom metadata attached to the refund.

Show child attributes

Example:

{ "reason": "Customer request" }

created_at · integer

Unix timestamp (in seconds) at which the refund was created.

Example:

1595491208