POST
/
transfer
/
collection
/
initiate
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": []
}

Was this page helpful?

Validate Customer Transfer RequestCheck Status