Onboarding
Setup and get started easily
To onboard as a POS service owner, you would need to signup on via the mobile App. You can find the Flutterwave POS app at this link.
Once you have completed signup, your credentials will enable you access the APIs below.
Login
Get Account Profile and Balance
Initiate Transfer
Initiate Bills Payments
Receive Notification on balance activity
Login
The Login API accepts valid credentials and returns an access token. This token is passed as authorization in the request header for subsequent requests. Tokens last for 1 hour before expiry.
Login
POST
https://staging.moneywaveapp.com/app/v1/auth
Returns authorization token
Request Body
Name | Type | Description |
---|---|---|
identifier* | String | Email or username |
password* | String | Password credential |
device_id* | String | Device ID |
Account Profile & Balance
The Profile API returns key information about your account and also the current balance.
Fetch Profile
POST
https://staging.moneywaveapp.com/app/v1/me
Returns Profile and Balance
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Authorization token |
Transfers
Request transfer to local banks.
Initiate Transfer
POST
https://staging.moneywaveapp.com/app/v1/payout
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Authorization token |
Request Body
Name | Type | Description |
---|---|---|
account_number* | String | Account number |
bank_code* | String | Bank Code |
amount* | String | Amount |
currency* | String | Currency |
narration* | String | Narration |
custom_sender_phonenumber* | String | Sender Phone number |
ref* | String | Transaction Reference |
pin* | String | Device PIN |
wallet_uref | String | Wallet user reference - Sub wallet |
lock | String | Sub wallet lock code |
Resolve account number
GET
https://staging.moneywaveapp.com/app/v1/account/resolve
Returns Beneficiary Name
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Authorization token |
Request Body
Name | Type | Description |
---|---|---|
account_number | String | Account Number |
bank_code | String | Bank code |
currency | String | Currency |
Bill Payments
Request Value added payments such as Airtime and Utility bill payments.
Fetch available bill payments / VAS
GET
https://staging.moneywaveapp.com/app/v1/bill/category
Returns an array of available bill payments
Headers
Name | Type | Description |
---|---|---|
Authorization | String | Authorization |
Initiate Bill payment
POST
https://staging.moneywaveapp.com/app/v1/bill/order
Headers
Name | Type | Description |
---|---|---|
Authorization | String | Authorization code |
Request Body
Name | Type | Description |
---|---|---|
country | String | Bill payment Country |
customerId | String | Customer ID |
billerName | String | Biller Name - from bills.billername |
shortName | String | Short Name - from bills.name |
amount | Number | Transaction amount |
ref | String | Transaction Reference |
balPassword | String | Balance password / Device pin |
Notifications
Receive notification for credit and debit activities on your balance.
A callback url is required for pushing notifications, please see here for additional information
Status Checks
Verify transaction status and fetch full transaction information using the status check API.
Last updated