Payout Channels
The following payout channels are available:
BANK_TRANSFER
: Standard bank transferPUSH_TO_CARD
: Transfer Directly to customer's card
The vlue represents the channel through which you want to credit the recipient. The details of the receipient are usually supplied in the recipient object. The request object may slightly vary depedning on the payout channel selected.
BANK_TRANSFER
This is your typical transfer to a recipient's bank account. For you to be able to transfer to a customer's bank, you must ideally have selected the customer's bank from a list of recipient banks, before you then send the values as part of the recipient object.
Here's a sample request for bank_transfer
"recipient": {
"recipientAccount": "0037320662",
"recipientBank": "TRP",
"currencyCode":"NGN",
"amount":"1400.00"
}
Request Description
Field | Description | Data Type | Required |
---|---|---|---|
recipientAccount | Account Number of Recipient | String | Y |
recipientBank | Bank Code of Recipient | String | Y |
currencyCode | Currency Code of Transaction | String | Y |
amount | Amount in major denomination e.g Naira | Decimal | Y |
Test Accounts
Account Number | Bank Code | Test Scenario |
---|---|---|
0037320662 | TRP | Successful Transactions |
PUSH_TO_CARD
This channel allows you send money directly into a customer's card. You'll typically collect the recipient's card number and expiry, and with this, we can do a lookup to return the relevant customer details tied to the card, and when you send a payout request, we instantly credit the relevant customer's account tied to their card instantly with their bank.
The following countries and cards are currently supported:
Country | Currency Code | Supported Cards |
---|---|---|
Nigeria | NGN | Verve |
Uganda | UGX | Verve |
Here's a sample request for push_to_card
"recipient": {
"recipientAccount": "5061006978432106787",
"currencyCode":"NGN",
"amount":"1400.00",
"additionalData": {
"expiry": "2511"
}
}
Request Description
Field | Description | Data Type | Required |
---|---|---|---|
recipientAccount | Card Number of Recipient | String | Y |
currencyCode | Currency Code of Transaction | String | Y |
amount | Amount in major denomination e.g Naira | Decimal | Y |
additionalData.expiry | Expiry date of the card in YYMM format | String | Y |
Updated about 2 months ago