POST
/
transfer
/
collection
/
initiate
Collection Account Transfer
curl --request POST \
  --url https://devapi.withedge.co/gateway/api/v1/transfer/collection/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'requestId: <requestid>' \
  --data '{
  "nameEnquirySessionId": "<string>",
  "sourceAccountNumber": "<string>",
  "beneficiaryAccountName": "<string>",
  "beneficiaryAccountNumber": "<string>",
  "beneficiaryBankCode": "<string>",
  "amount": 123,
  "narration": "<string>"
}'
{
	"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": []
}

Collection Account Transfer

Use this endpoint to initiate a transfer request from one of your Edge collection accounts to a beneficiary account.

Request Parameters

requestId
string
required
A unique identifier for the request, used for idempotency.
Example: e0b9f8d0-7a57-4a67-a8b2-4d7c7b5a37c9
nameEnquirySessionId
string
required
The session ID from a name enquiry request, required to confirm the beneficiary’s details.
Example: session_0011223344
sourceAccountNumber
string
required
The Edge collection account number from which the transfer will be made.
Example: 1234567890
beneficiaryAccountName
string
required
The name of the beneficiary receiving the transfer.
Example: Peter Parker
beneficiaryAccountNumber
string
required
The account number of the beneficiary.
Example: 0987654321
beneficiaryBankCode
string
required
The bank code of the beneficiary’s bank.
Example: 001001
amount
double
required
The amount to be transferred.
Example: 1000.50
narration
string
A brief description of the transaction.
Example: Transfer to Peter Parker
{
	"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": []
}