Transfers

To perform monetary transactions with a user's eyowo account or wallet <X-App-Wallet-Access-Token>, you must obtain the user's access wallet token. See the previous chapter on Authentications.

You can perform two types of transactions:

Transfer to Phone or Phone Transfer: this transfer is from a user's Eyowo account to another user's eyowo account or wallet.

Transfer to Bank or Bank Transfer: this transfer is from a user's Eyowo account to any bank account.

Phone Transfers

POST https://api.console.eyowo.com/v1/users/transfers/phone

Request Body: { "mobile" : "234000000000", "amount": "4000" }

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-To

Request Body

Name	Type	Description
sendSms	boolean	default to true <sends sms on successful transfer. N5 per sms>
mobile	string	23480123456789 <valid Nigerian num>
amount	number	10000 = 1,000.00 <in kobo>

200 Sucessfully made the transfer

{
  "success": true,
  "data": {
    "transaction": {
      "reference": "5c4f2d205d73fe5abe0a4393",
      "amount": 10000
    }
  },
  "message": "Transaction successful"
}

404 Could not find a cake matching this query.

{    "message": "Ain't no cake like that."}

Bank Transfers

POST https://api.console.eyowo.com/v1/users/transfers/bank

Request Body: { "accountName" : "EYOWO DEVELOPER", "accountNumber": "393082038494", "bankCode": "00004", "amount" : "40000" }

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

Request Body

Name	Type	Description
accountName	string	recipients account name
accountNumber	string	recipients account number
bankCode	string	recipients bank code
amount	number	amount in kobo

200 Bank transfer was successful

{
    "success": true,
    "data": {
        "transaction": {
            "amount": 100000,
            "accountName": "DAMBATTA MARYAM LAMI",
            "transactionReference": "5ec58e1f084c634901127b75",
            "statusCode": "000002"
        }
    },
    "message": "Transaction successful"
}

Requery Bank Transfer

GET https://api.console.eyowo.com/v1/users/transfers/requery/bank/:transactionRef

The endpoint validates the current status of a bank transfer initated using your Eyowo developer app.

Path Parameters

Name	Type	Description
transactionRef	string	5d1a8..... <valid transaction ref>

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

200

{
    "success": true,
    "data": {
        "transaction": {
            "statusMessage": "success",
            "statusCode": "000001"
        }
    }
} 

Status Code	Status Message
000000	Failed
000001	Success
000002	Pending

The transactionRefrenece in the request must belong to the X-App-Key provided in the header.