---
title: "Refund Payment"
method: POST
path: "/billing/payment/refund"
tags: ["provider", "billing"]
---

# Refund Payment

`POST /billing/payment/refund`

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- RefundCreate — Create a refund for a payment.
  - `paymentId` string, required
  - `providerId` string, required
  - `amount` integer, required
  - `reason` 'DUPLICATE' | 'DISPUTE' | 'BOOKING_FEE' | 'OTHER', required
  - `description` string, nullable
  - `locationId` string, nullable
  - `restoreInventory` boolean

## Response `200`

Successful Response

- RefundSummary
  - `id` string, required
  - `paymentId` string, required
  - `amount` integer, required
  - `reason` 'DUPLICATE' | 'DISPUTE' | 'BOOKING_FEE' | 'OTHER', required
  - `createdDate` string, date-time, required
  - `status` 'CANCELED' | 'CREATED' | 'FAILED' | 'IN_REVIEW' | 'PRESENTING' | 'PROCESSING' | 'SUCCEEDED', required
  - `rainforestRefundId` string, nullable
  - `fee` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)