---
title: "Refund payment."
method: POST
path: "/practices/{practice_id}/payments/{payment_id}/refund"
tags: ["payments"]
---

# Refund payment.

`POST /practices/{practice_id}/payments/{payment_id}/refund`

## Request

- Base URL: `sandbox.collectly.co/api/api/partners/v1` (relative, and the document’s source URL is not known)
- URL: `sandbox.collectly.co/api/api/partners/v1/practices/{practice_id}/payments/{payment_id}/refund`
- Auth: API key in header `Authorization`

Refund payment.
        Payment can be refunded both fully and partially.

## Path parameters

- `practice_id` string, required
- `payment_id` string, required

## Request body

- Payment
  - `allocations` Allocation[]
    - `amount` number, required
    - `charge_id` string, nullable
    - `id` string
    - `visit_id` unknown
  - `amount` number, nullable
  - `collectly_id` string: Unique Collectly resource ID
  - `collectly_payment_plan_id` string: Collectly payment plan ID. It is NOT null in case the payment was charged as a part of the payment plan
  - `collectly_source_payment_id` string: Collectly source payment ID. Used only for refunds.
  - `copay_amount` number
  - `created_at` unknown
  - `id` string, required: Unique resource ID from your integration
  - `modified_at` unknown
  - `patient_id` string, required: Patient ID from your integration who owns the resource
  - `payment_type` 'payment' | 'copay' | 'refund' | 'part_ref' | 'autodeb' | 'collect'
  - `post_date` string, date, nullable
  - `status` string
  - `transaction_id` string, nullable

## Response `200`

OK

- Payment
  - `allocations` Allocation[]
    - `amount` number, required
    - `charge_id` string, nullable
    - `id` string
    - `visit_id` unknown
  - `amount` number, nullable
  - `collectly_id` string: Unique Collectly resource ID
  - `collectly_payment_plan_id` string: Collectly payment plan ID. It is NOT null in case the payment was charged as a part of the payment plan
  - `collectly_source_payment_id` string: Collectly source payment ID. Used only for refunds.
  - `copay_amount` number
  - `created_at` unknown
  - `id` string, required: Unique resource ID from your integration
  - `modified_at` unknown
  - `patient_id` string, required: Patient ID from your integration who owns the resource
  - `payment_type` 'payment' | 'copay' | 'refund' | 'part_ref' | 'autodeb' | 'collect'
  - `post_date` string, date, nullable
  - `status` string
  - `transaction_id` string, nullable

## Changes

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

[Operation history](https://skmtc.dev/collectly/apis/partners1/changes/practices/:practice_id/payments/:payment_id/refund/post.md)

---

[API](https://skmtc.dev/collectly/apis/partners1.md) - [All operations](https://skmtc.dev/collectly/apis/partners1/llms.txt) - [OpenAPI document](https://skmtc.dev/collectly/apis/partners1/revisions/a45575a6e4b8?raw)