---
title: "Internal transfer"
method: POST
path: "/payments/internal-transfer"
tags: ["Faster Payments"]
---

# Internal transfer

`POST /payments/internal-transfer`

Process an internal transfer between accounts.

## Headers

- `Company-Id` string, uuid
- `Mid` string, uuid

## Request body

- object
  - `transaction` object
    - `order_id` string, required — Unique reference assigned by you for the payment request.
    - `amount` number, float, required — The amount to be transferred to your payee bank account.
    - `currency` 'aed' | 'aud' | 'cad' | 'chf' | 'cny' | 'dkk' | 'eur' | 'gbp' | 'hkd' | 'jpy' | 'mxn' | 'sek' | 'usd' | 'zar', required — ISO 4217 currency code in lower case.
  - `payment` object
    - `from_mid` string, uuid, required — The unique identifier for the Acquired Mid to be debited.
    - `to_mid` string, uuid, required — The unique identifier for the Acquired Mid to be credited.
    - `reference` string, required — The reference to appear on the account holder's bank statement.

## Response `201`

Created

- object
  - `status` 'pending'
  - `transaction_id` string, uuid — Unique identifier assigned by Acquired.com for the transaction record.

## Other responses

- `400` — An error occurred
- `401` — An error occurred
- `500` — Internal Server error

---

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