---
title: "Refund payment"
method: POST
path: "/payments/{id}/refund"
tags: ["Payments"]
---

# Refund payment

`POST /payments/{id}/refund`

Refund a payment with a specified reason and amount.

**gigstack Connect:** Refund other teams' payments using the `team` parameter.

## Key Features
- Partial or full refunds supported
- Optional external processor refund handling
- Automatic refund tracking and reporting
- Supports Stripe integration for automatic processor refunds

## Path parameters

- `id` string, required

## Query parameters

- `team` string

## Request body

- RefundPaymentInput
  - `reason` string, required — Reason for the refund
  - `amount` number, required — Amount to refund
  - `external_processor_refund` boolean, nullable — Whether to process refund through external payment processor

## Response `200`

Payment refunded successfully

- StandardSuccessResponse
  - `message` string, required
  - `data` object, required

---

[API](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2.md) · [All operations](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/disruptive-learning/gigstack-api-v2/revisions/5cf53ffd7580/schema)