Refunds API — create and retrieve payment refunds

You can issue a full or partial refund on any captured payment. Refunds are processed asynchronously — the status transitions from pending to processed or failed.

Create a refund

POST /v1/payments/:id/refund

Request parameters

integer

Amount to refund in the smallest currency unit. Omit this field to issue a full refund for the total payment amount.

string

Refund speed. Use normal for standard 5–7 business day processing, or optimum for instant refunds where available. Defaults to normal.

object

Key-value pairs for custom metadata. Maximum 15 keys, each value up to 256 characters.

string

Your internal reference ID for this refund.

curl -X POST https://api.razorpay.com/v1/payments/pay_DJkTfWoJ5ZFPce/refund \
  -u rzp_test_YOUR_KEY_ID:YOUR_KEY_SECRET \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "speed": "normal",
    "notes": {
      "reason": "Customer request"
    },
    "receipt": "refund_001"
  }'

Response

{
  "id": "rfnd_FP8QHiV938haTz",
  "entity": "refund",
  "amount": 50000,
  "currency": "USD",
  "payment_id": "pay_DJkTfWoJ5ZFPce",
  "status": "processed",
  "speed_processed": "normal",
  "created_at": 1591097057
}

string

Unique refund identifier.

string

Refund status. One of pending, processed, or failed.

string

The actual speed at which the refund was processed (normal or instant).

string

The payment ID against which this refund was issued.

Fetch a refund

GET /v1/refunds/:id

curl -X GET https://api.razorpay.com/v1/refunds/rfnd_FP8QHiV938haTz \
  -u rzp_test_YOUR_KEY_ID:YOUR_KEY_SECRET

Introduction

API Guides

Core Resources API

Products API

Additional Resources

Payments

QR Codes

RazorpayX

Partners

Refunds API — create and retrieve payment refunds

Create a refund

Request parameters

Response

Fetch a refund

​Create a refund

​Request parameters

​Response

​Fetch a refund

Create a refund

Request parameters

Response

Fetch a refund