---
title: "Initiate Transfer"
method: POST
path: "/pms/api/external/request/wallet/transfer/"
tags: ["Transfers"]
---

# Initiate Transfer

`POST /pms/api/external/request/wallet/transfer/`

Send money from your managed wallet to a bank account

## Headers

- `api-key` string, required
- `api-secret` string, required
- `Content-Type` 'application/json', required

## Request body

- InitiateTransferRequest
  - `amount` string, required — Amount to transfer in the smallest currency unit
  - `account_number` string, required — Destination bank account number
  - `bank_code` string, required — Destination bank code
  - `account_name` string — Optional account name for records
  - `narration` string — Description for beneficiary statement
  - `reference` string, required — Unique transfer reference
  - `otp` string — One-time password when required

## Response `200`

Transfer initiated successfully

- InitiateTransferResponse
  - `status` boolean — Request status
  - `message` string — Response message
  - `data` object
    - `reference` string — Transfer reference
    - `session_id` string — Session ID for status tracking
    - `amount` string — Transfer amount
    - `status` string — Transfer status
    - `destination_account_number` string — Destination account number
    - `destination_bank_code` string — Destination bank code
    - `destination_account_name` string — Destination account name

---

[API](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api.md) · [All operations](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payvessel/payvessel-value-added-services-api/revisions/31040a9358ef/schema)