---
title: "Refund a capture"
method: POST
path: "/paypal/captures/{id}/refund"
---

# Refund a capture

`POST /paypal/captures/{id}/refund`

## Request

- Base URL: `https://gateway.pmnts-sandbox.io/v1.0`
- URL: `https://gateway.pmnts-sandbox.io/v1.0/paypal/captures/{id}/refund`
- Auth: HTTP basic

## Path parameters

- `id` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `amount` integer: Amount to be refunded in the smallest unit of the currency.
  - `note_to_payer` string: A note to be attached with the refund. Will be visible to the customer

## Response `200`

200

- object
  - `successful` boolean
  - `response` object
    - `id` string
    - `amount` integer
    - `refunded` string
    - `message` string
    - `transaction_id` string
    - `currency` string
    - `successful` boolean
    - `transaction_date` string
    - `status` string
    - `note_to_payer` string
    - `invoice_id` string
    - `decimal_amount` number
    - `paypal_fee` integer
    - `seller_payable_net_amount` integer
    - `balance_available_for_refund` integer
    - `capture` string
    - `order` string
  - `errors` unknown[]
    - unknown
  - `test` boolean

## Other responses

- `400`: 400
- `401`: 401
- `404`: 404

## Changes

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

[Operation history](https://skmtc.dev/fatzebra/apis/gateway/changes/paypal/captures/:id/refund/post.md)

---

[API](https://skmtc.dev/fatzebra/apis/gateway.md) - [All operations](https://skmtc.dev/fatzebra/apis/gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/fatzebra/apis/gateway/revisions/a62ddbae3800?raw)