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

# POST /Payments/{id}/refund

`POST /Payments/{id}/refund`

## Path parameters

- `id` string, required

## Request body

- RefundPaymentDto
  - `amount` union
    - number, double
    - string, double
  - `reason` string

## Response `200`

OK

- PaymentDto
  - `id` string
  - `paymentNumber` string
  - `invoiceId` string
  - `invoiceNumber` string, nullable
  - `clientId` string, nullable
  - `clientName` string, nullable
  - `paymentTokenId` string, nullable
  - `paymentToken` PaymentTokenSummaryDto
    - `id` string
    - `last4` string
    - `brand` string
    - `expirationMonth` union
      - integer
      - string, int32
    - `expirationYear` union
      - integer
      - string, int32
    - `isDefault` boolean
    - `nickname` string, nullable
  - `paymentMethod` string
  - `amount` union
    - number, double
    - string, double
  - `status` string
  - `description` string, nullable
  - `transactionId` string, nullable
  - `authorizationCode` string, nullable
  - `cashReceived` union
    - number, double
    - string, double
  - `changeDue` union
    - number, double
    - string, double
  - `markAsPaidType` string, nullable
  - `checkNumber` string, nullable
  - `routingNumberMasked` string, nullable
  - `accountNumberMasked` string, nullable
  - `text2PayPhoneNumber` string, nullable
  - `text2PayLinkSentAt` string, date-time, nullable
  - `refundedAmount` union
    - number, double
    - string, double
  - `originalPaymentId` string, nullable
  - `refunds` PaymentSummaryDto[], nullable
    - `id` string
    - `paymentNumber` string
    - `paymentMethod` string
    - `amount` union
      - number, double
      - string, double
    - `status` string
    - `refundedAmount` union
      - number, double
      - string, double
    - `createdAt` string, date-time
    - `clientName` string, nullable
    - `invoiceNumber` string, nullable
  - `processedBy` UserSummaryDto
    - `id` string
    - `email` string
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `displayName` string, nullable
    - `type` string
    - `roleId` string, nullable
    - `roleName` string, nullable
  - `processedAt` string, date-time, nullable
  - `createdAt` string, date-time
  - `cardEntryMethod` string, nullable
  - `applicationLabel` string, nullable
  - `maskedPan` string, nullable
  - `cardType` string, nullable
  - `lastFour` string, nullable
  - `emvAid` string, nullable
  - `emvTvr` string, nullable
  - `emvIad` string, nullable
  - `emvTsi` string, nullable
  - `cvmMethod` string, nullable
  - `pinVerified` boolean, nullable
  - `surchargeAmount` union
    - number, double
    - string, double
  - `baseAmount` union
    - number, double
    - string, double
  - `tipAmount` union
    - number, double
    - string, double
  - `cashbackAmount` union
    - number, double
    - string, double
  - `cashDiscountApplied` boolean, nullable
  - `cashDiscountAmount` union
    - number, double
    - string, double
  - `transactionType` string, nullable
  - `terminalId` string, nullable
  - `terminalName` string, nullable — Named terminal slug used for this transaction (e.g., "front-desk").
  - `isDuplicateTransaction` boolean — Whether this is a duplicate transaction that was previously approved. When true, no new charge was processed - this references a prior transaction.

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/versions/a905bde4e796/schema)