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

# Move Payment

`POST /billing/payment/move`

Move a payment and all related objects from one patient to another.

This function updates:
1. The payment itself (patient_id)
2. Payment method used for the payment (patient_id) if it exists
3. All charges associated with this payment (patient_id)
4. All alerts related to the payment (patient_id)
5. All alerts related to the charges (patient_id)
6. All alerts related to adjustments of the charges (patient_id)
7. All alerts related to refunds of the payment (patient_id)

## Headers

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

## Request body

- MovePaymentRequest — Request to move a payment from one patient to another.
  - `paymentId` string, required — The ID of the payment to move.
  - `newPatientId` string, required — The ID of the patient to move the payment to.

## Response `200`

Successful Response

- PaymentSummary
  - `id` string, required — The unique identifier for the payment.
  - `patientId` string, nullable — The ID of the patient associated with the payment.
  - `payinId` string, nullable — The ID of the payin associated with the payment.
  - `amount` integer, required — The total amount of the payment.
  - `status` 'CANCELED' | 'CREATED' | 'FAILED' | 'IN_REVIEW' | 'PRESENTING' | 'PROCESSING' | 'SUCCEEDED', required
  - `currency` string — The currency in which the payment was made.
  - `payinConfigId` string, nullable — The configuration ID for the payin.
  - `paymentMedium` string, required — The name of the payment medium.
  - `paymentMethodId` string, nullable — The ID of the payment method used.
  - `stripePaymentIntentId` string, nullable — Stripe's payment intent ID if used.
  - `failedReason` string, nullable — Reason for payment failure if applicable.
  - `updatedDate` string, date-time, nullable — The date and time the payment was last updated.
  - `createdDate` string, date-time, required — The date and time the payment was created.
  - `fee` integer — The fee charged by the payment processor.
  - `feeToPatient` integer, required — The fee charged to the patient for the transaction.

## 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)