---
title: "Process Refund"
method: POST
path: "/v2/{sid}/whatsapp/{phone_number}/payments_refund"
tags: ["Payments"]
---

# Process Refund

`POST /v2/{sid}/whatsapp/{phone_number}/payments_refund`

The Process Refund API allows you to initiate a refund for a successfully completed payment.

## Path parameters

- `sid` string, required
- `phone_number` string, required

## Request body

- RefundRequest
  - `reference_id` string, required — Unique reference ID for the order sent in order_details message.
  - `speed` string — Speed by which refund should be processed. Optional field. Can be one of instant or normal.
  - `payment_config_id` string, required — Payment configuration for the order sent in order_details message.
  - `amount` object, required — The amount object contains refund details.
    - `currency` string — The currency for this refund. Currently only INR is supported.
    - `value` string — Must be 100 for INR.
    - `offset` string — Positive integer representing the amount value multiplied by offset. For example, ₹12.34 = 1234.

## Response `200`

Successful refund initiation

- RefundResponse
  - `code` string, required
  - `message` string, required
  - `data` object, required
    - `id` string
    - `speed_processed` string
    - `status` string
  - `error` object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/kaleyra/apis/kaleyra-io-sms-apis.md) · [All operations](https://skmtc.net/kaleyra/apis/kaleyra-io-sms-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kaleyra/kaleyra-io-sms-apis/revisions/d9b785884d03/schema)