---
title: "Initiate a transfer"
method: POST
path: "/transfers"
---

# Initiate a transfer

`POST /transfers`

## Request body

- union
  - object
    - `amount` number, required
    - `currency` string, required
    - `channel` string
    - `beneficiary` string, required
    - `recipient` string
    - `description` string, required
    - `reference` string
  - object
    - `amount` number, required
    - `currency` string, required
    - `channel` string, required
    - `beneficiary` string
    - `recipient` string, required
    - `description` string, required
    - `reference` string

## Response `201`

Transfer initialized

- object
  - `status` string, required
  - `message` string, required
  - `code` integer, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/notchpay/apis/notch-pay-api.md) · [All operations](https://skmtc.net/notchpay/apis/notch-pay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notchpay/notch-pay-api/versions/483106380733/schema)