---
title: "Refund a payment"
method: POST
path: "/v1/refunds"
tags: ["Refunds"]
---

# Refund a payment

`POST /v1/refunds`

Issue a full refund for a payment, identified by its transaction ID. The full remaining refundable amount is resolved automatically. Returns `pending` when the payment provider confirms the refund asynchronously.

## Request body

- CreateRefundRequestEntity
  - `transaction_id` string, required — The unique identifier of the transaction to refund in full.

## Response `200`

Successfully created the refund

- RefundResponseEntity
  - `status` 'pending' | 'requiresAction' | 'succeeded' | 'failed' | 'canceled', required — Status of the refund. `pending` and `requiresAction` represent non-terminal provider processing states.

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

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