---
title: "Create a Transfer"
method: POST
path: "/v1/transactions/transfer-payout"
tags: ["Transactions"]
---

# Create a Transfer

`POST /v1/transactions/transfer-payout`

Initiate a transfer payout to a beneficiary.

**Validation Rules:**
- Minimum amount: 500 cents (5.00 in major currency units)
- Attachments array is optional, but if provided must contain at least one item

## Request body

- object
  - `beneficiary_id` string, uuid, required
  - `reference_id` string, required
  - `amount` integer, required — Amount in cents (multiply by 100). Minimum 500 cents required.
  - `remarks` string, required
  - `attachments` object[]
    - `remark` string, required
    - `uri` string, required

## Response `200`

Transfer created successfully

- object
  - `data` object
    - `transfer_id` string, uuid
    - `reference_id` string
    - `deposit_instruction` object
      - `liquidation_address` string
      - `currency` string
      - `rail` string
    - `quotation` object
      - `currency` string
      - `to_amount` integer
      - `developer_fee` integer
    - `created_at` string, date-time
    - `expire_at` string, date-time

## Other responses

- `401` — Authentication failed due to invalid credentials
- `422` — Failed due to a formatting error.

---

[API](https://skmtc.net/fin/apis/fin-com-api.md) · [All operations](https://skmtc.net/fin/apis/fin-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fin/fin-com-api/revisions/6e69503ee7b8/schema)