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

# Create a Refund

`POST /refunds`

## Request

- Base URL: `https://api.paymongo.com`
- URL: `https://api.paymongo.com/refunds`
- Auth: HTTP basic

Use secret API key to create a Refund.

## Request body

- object
  - `data` object
    - `attributes` object
      - `amount` integer, required: Amount of the refund. A positive integer with minimum amount of 100. 100 is the smallest unit in cents. If you want to refund an amount of 1.00, the value that you should pass is 100. If you want to refund an amount of 1500.50, the value that you should pass is 150050. The refund amount can be less than or equal to the amount of the corresponding Payment resource.
      - `notes` string: Notes of the refund. You can use this value to save remarks about the refund. The maximum characters is 255.
      - `payment_id` string, required: The ID of a Payment resource to be refunded.
      - `reason` string, required: Reason for the refund. Possible values are `duplicate`, `fraudulent`, `requested_by_customer` and `others`.
      - `metadata` object: A set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the object in a structured format. Only string values are accepted. Keys that start with `PYM_` are reserved for internal use and are stripped on write.

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `f9ffaecbfe3d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paymongo/apis/paymongo-api/changes/refunds/post.md)

---

[API](https://skmtc.dev/paymongo/apis/paymongo-api.md) - [All operations](https://skmtc.dev/paymongo/apis/paymongo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/paymongo-api/revisions/f9ffaecbfe3d?raw)