> ## Documentation Index
> Fetch the complete documentation index at: https://doc.withedge.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Initiate Customer Transfer Request

> This endpoint allows you to initiate a transfer request on behalf of your customer.

# Initiate Customer Transfer Request

## Use this endpoint to initiate a transfer request on behalf of a customer using their generated account numbers.

## Additional Information

<Info>
  **Note**\
  You can initiate transfer requests only with account numbers generated specifically for your customer.
</Info>

***

## Request Parameters

<ParamField header="requestId" type="string" required>
  A unique identifier for the request, used for idempotency.\
  **Example:** `e0b9f8d0-7a57-4a67-a8b2-4d7c7b5a37c9`
</ParamField>

<ParamField body="nameEnquirySessionId" type="string" required>
  The session ID from a name enquiry request, required to confirm the beneficiary's details.\
  **Example:** `session_0011223344`
</ParamField>

<ParamField body="customerId" type="string" required>
  The unique identifier of the customer initiating the transfer.\
  **Example:** `cus_0011223344`
</ParamField>

<ParamField body="sourceAccountName" type="string" required>
  The name associated with the source account of the customer.\
  **Example:** `John Doe`
</ParamField>

<ParamField body="sourceAccountNumber" type="string" required>
  The account number of the customer from which the transfer is being initiated.\
  **Example:** `1234567890`
</ParamField>

<ParamField body="beneficiaryAccountName" type="string" required>
  The name of the beneficiary receiving the transfer.\
  **Example:** `Peter Parker`
</ParamField>

<ParamField body="beneficiaryAccountNumber" type="string" required>
  The account number of the beneficiary.\
  **Example:** `0987654321`
</ParamField>

<ParamField body="beneficiaryBankCode" type="string" required>
  The bank code of the beneficiary's bank.\
  **Example:** `001001`
</ParamField>

<ParamField body="amount" type="double" required>
  The amount to be transferred.\
  **Example:** `5000.00`
</ParamField>

<ParamField body="narration" type="string" optional>
  A brief description of the transaction.\
  **Example:** `Payment for services`
</ParamField>

<ResponseExample>
  ```json
  {
  	"statusCode": 00,
  	"message": "Transfer initiated successfully."
  	"data": {
  		"amount": 1213211231,
  		"beneficiaryAccountName": "Peter Parker",
  		"beneficiaryAccountNumber": "1234567890",
  		"beneficiaryBankCode": "001001",
  		"narration": "Transfer to John Doe",
  		"transactionId": "txn_0011223344",
  		"otpReferneceId": "654578797858"
  	},
  	"errors": []
  }
  ```
</ResponseExample>