Payout Channels

The following payout channels are available:

  • BANK_TRANSFER: Standard bank transfer
  • PUSH_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

FieldDescriptionData TypeRequired
recipientAccountAccount Number of RecipientStringY
recipientBankBank Code of RecipientStringY
currencyCodeCurrency Code of TransactionStringY
amountAmount in major denomination e.g NairaDecimalY

Test Accounts

Account NumberBank CodeTest Scenario
0037320662TRPSuccessful 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:

CountryCurrency CodeSupported Cards
NigeriaNGNVerve
UgandaUGXVerve

Here's a sample request for push_to_card

 "recipient": {
        "recipientAccount": "5061006978432106787",
        "currencyCode":"NGN",
        "amount":"1400.00",
        "additionalData": {
            "expiry": "2511"
        }
    }

Request Description


FieldDescriptionData TypeRequired
recipientAccountCard Number of RecipientStringY
currencyCodeCurrency Code of TransactionStringY
amountAmount in major denomination e.g NairaDecimalY
additionalData.expiryExpiry date of the card in YYMM formatStringY