---
title: "Create a Refund"
method: POST
path: "/v1/refunds"
---

# Create a Refund

`POST /v1/refunds`

Refund the funds from a Charge to the Payment Method.

Creating a Refund will refund a Charge that has previously been created. 
Funds will be returned to the Payment Method that was originally charged.

You can optionally refund only part of a charge. 
You can do so multiple times, until the entire charge has been refunded.

## Request body

- object
  - `charge` string, required — The identifier of the charge to refund.
  - `amount_to_refund` string — Amount intended to be refunded from the Charge in minor units.Can refund only up to the remaining, unrefunded amount of the Charge. The field is optional and if not provided will default to the entire Charge.
  - `reference` string — A unique string to reference the Refund. Can be used to reconcile the object with your internal systems.
  - `metadata` Metadata

## Response `200`

Example response

- Refund
  - `id` string — Unique identifier for Refund object.
  - `resource` string — String representing the resource type.
  - `amount` integer — Amount, in minor units.
  - `amount_human_readable` string — Amount in human readable format.
  - `charge` string — ID of the Charge that was refunded.
  - `created` string — Time at which the resource was created. ISO String format.
  - `currency` string — Three-letter ISO currency code, in lowercase.
  - `customer` string — ID of the customer this Refund is for if one exists.
  - `customer_reference_id` string — A unique identifier for your customer, This is a customer ID that identifies the customer that the Refund belongs to that was supplied at creation of the Charge.
  - `metadata` object — Set of key-value pairs that were attached to the resource at creation.
  - `reference` string — A unique string to reference the Refund that was entered while creating the resource. Can be used to reconcile the object with your internal systems.
  - `status` 'succeeded' | 'failed' | 'pending' — Status of the refund.

---

[API](https://skmtc.net/pay/apis/pay-com-api.md) · [All operations](https://skmtc.net/pay/apis/pay-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pay/pay-com-api/versions/53cd74fc31e3/schema)