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

# Move Payment To Location

`POST /billing/payment/move-to-location`

## Request

- Base URL: `https://docs.decodahealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.decodahealth.com/billing/payment/move-to-location`
- Auth: none declared. Required headers: `TENANT`, `API-KEY`
- TypeScript: <https://skmtc.dev/decodahealth/apis/decoda-api/docs/billing/payment/move-to-location/post.ts> (a function with typed inputs; its response is checked against the schema)

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

This function updates:
1. The payment itself (location_id)
2. All charges associated with this payment (location_id)
3. All refunds associated with this payment (location_id)
4. All adjustments associated with the charges (location_id)
5. All alerts related to the payment, charges, adjustments, and refunds (location_id)

## Headers

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

## Request body

- MovePaymentToLocationRequest: Request to move a payment from one location to another.
  - `paymentId` string, required: The ID of the payment to move.
  - `newLocationId` string, required: The ID of the location 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.dev/decodahealth/apis/decoda-api/revisions/4ab18c80f9e9?raw)