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.staging-api.eyowo.com/v1/users/transfers/phone
Usage: { "mobile" : "234000000000", "amount": "4000" }
Headers
Name | Type | Description |
---|---|---|
X-App-Key | string |
|
X-App-Wallet-Access-Token | string |
|
Request Body
Name | Type | Description |
---|---|---|
mobile | string |
|
amount | number |
|
Bank Transfers
POST
https://api.console.eyowo.com/v1/users/transfers/bank
Usage: { "accountName" : "EYOWO DEVELOPER", "accountNumber": "393082038494", "bankCode": "00004", "amount" : "40000" }
Headers
Name | Type | Description |
---|---|---|
X-App-Key | string |
|
X-App-Wallet-Access-Token | string |
|
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 |
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 |
|
Headers
Name | Type | Description |
---|---|---|
X-App-Key | string | X-App-Key |
X-App-Wallet-Access-Token | string |
|
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.
Last updated