---
title: "Create Refund"
method: POST
path: "/v1/payment_links/{id}/refunds"
tags: ["Payment Links"]
---

# Create Refund

`POST /v1/payment_links/{id}/refunds`

Creates a refund for a payment associated with a payment link.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `amount` number, float, required — Amount to refund in major currency units (e.g. 100.00 = PHP 100.00).
  - `payment_id` string, required — The ID of the payment to refund.
  - `reason` string, required — Reason for the refund.
  - `metadata` object — Additional metadata (string values).

## Response `201`

Refund created successfully.

- object
  - `data` object
    - `id` string, required — The unique identifier of the refund.
    - `type` string, required — Object type.
    - `attributes` object, required
      - `amount` integer, required — Refunded amount in the smallest currency unit.
      - `balance_transaction_id` string — Associated balance transaction ID.
      - `currency` string, required — Three-letter ISO currency code.
      - `livemode` boolean, required — Indicates whether the refund is live.
      - `metadata` object — Additional metadata.
      - `notes` string — Notes attached to the refund.
      - `payment_id` string, required — The ID of the refunded payment.
      - `payout_id` string — Associated payout ID.
      - `reason` string, required — Reason for the refund.
      - `status` string, required — Status of the refund.
      - `available_at` integer — Timestamp when refund becomes available (epoch).
      - `created_at` integer, required — Creation timestamp (epoch).
      - `refunded_at` integer — Timestamp when refund was processed (epoch).
      - `updated_at` integer, required — Last update timestamp (epoch).

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `404` — Payment or payment link not found.
- `500` — Internal server error.

---

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