---
title: "POST /refund"
method: POST
path: "/refund"
tags: ["Refund"]
---

# POST /refund

`POST /refund`

## Request body

- InitiateRefundDto
  - `id` string, required — Unqiue client generated UUID of the refund
  - `payment_intent_id` string, required — id of the payment intent
  - `amount` number — Transaction amount. Values must be passed in the base units of their currency. For example, $10.50 should be provided as `1050`.
  - `currency_code` string — Currency code of the amount to charge. This should be a 3-letter ISO-4217 currency code. For example, if you wish to charge 10 AED, you should pass AED. For more information on supported currencies, please visit the [supported currencies page](/supported-currencies)
  - `test` boolean — Whether to create a test payment. Test payments do not require a payment method and can be used to test the payment flow. You won't be charged for this call. You can use [test cards](/test-cards) to test the payment flow.

## Response `default`

- RefundDto
  - `id` string, required — Id of the refund
  - `payment_intent_id` string, required — id of the payment intent
  - `amount` number, required — Transaction amount. Values must be passed in the base units of their currency. For example, $10.50 should be provided as `1050`.
  - `currency_code` string, required — Currency code of the amount to charge. This should be a 3-letter ISO-4217 currency code. For example, if you wish to charge 10 AED, you should pass AED. For more information on supported currencies, please visit the [supported currencies page](/supported-currencies)
  - `status` 'pending' | 'completed' | 'failed', required
  - `created_at` string, required — Unix timestamp in milliseconds
  - `error` ErrorDto
    - `message` string, required — A human-readable error message
    - `code` string, required — HTTP error status code

---

[API](https://skmtc.dev/ziina/apis/account-api.md) · [All operations](https://skmtc.dev/ziina/apis/account-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ziina/account-api/revisions/fc7d9901e5ba/schema)