Outbound Transfers

You can use the Outbound Transfer APIs to facilitate single or bulk transfers to beneficiaries instantly from your paydestal payout account.

Before you proceed with this section, You need to have created Outbound Transaction PIN and an Outbound Transfer Account

Environment Urls

Sandbox: https://devbox.paydestal.com/payout
Prod:    https://api.paydestal.com/payout

Outbound transfer process flow

• Fund your paydestal outbound account

• Get List of Banks to obtain destination bank code

• Verify Beneficiary Account Number (Name Enquiry)

• Transfer the money to beneficiary

GET List of Outbound Transfer Banks

curl --location 'https://devbox.paydestal.com/payout/transfer/api/v1/get-nip-bank-list'
--header 'Authorization: Bearer {Your client secret}'

POST Verify Beneficiary Bank Account Number

curl --location 'https://devbox.paydestal.com/payout/transfer/api/v1/verify-beneficiary-bank-account' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Your client secret}' \
--data '{
    "accountNumber": "{beneficiaryAccountNumber}",
    "beneficiaryBank": "{bankCode}"
}'

POST Transfer Money to Beneficiary

curl --location 'https://devbox.paydestal.com/payout/transfer/api/v1/nip-transfer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Your client secret}' \
--data '{
  "senderAccountNumber": "{senderAccountNumber}",
  "beneficiaryAccountNumber": "1000074944",
  "amount": 300.55,
  "currency": "NGN",
  "pin": "{your pin}",
  "beneficiaryBankName": "VFD MICROFINANCE BANK",
  "beneficiaryBankCode": "999999",
  "narration": "Message of love"
}'

Request Body

Name	Type	Description
reference	String	Unique Reference String
beneficiaryAccountName	String	Name of Receiver
beneficaryAccountNumber	NUBAN	Receiver's Account Number
beneficiaryBankCode	String	Gotten from List of Banks endpoint
senderAccountNumber	NUBAN	Paydestal Wallet
amount	Double	Amount
currency	String	NGN
narration	String	Remark
pin	Preset PIN