Search / List

Transaction listing and search using specified parameters are available using the API below. Data is returned with meta providing total number of records found, current page and the set limit per page.

GET https://staging.moneywaveapp.com/v1/report/transactions

Query Parameters

Name	Type	Description
page	string	Specify a report page
limit	string	Specify transactions limit per page
date	string	Transaction date filter specified a single date 2019-03-19 or date range 2018-12-19--2019-01-10
status	string	Transaction status filter
amount	string	Transaction amount filter
ref	string	Your transaction reference
flwref	string	Flutterwave transaction reference
currency	string	Transaction currency filter
type	string	Transacion type specified as Credit or Debit
wallet	string	Balance ID filter, for transactions related to the specified balance only.

Headers

Name	Type	Description
Authorization	string	Authorization Token

200

{
    "status": "success",
    "data": [
        {
            "id": 1,
            "amount": 500,
            "fee": null,
            "status": "completed",
            "system_type": "wallet-fund",
            "source": "card",
            "source_id": 810,
            "dest": "wallet",
            "dest_id": 1,
            "ref": null,
            "flutterResponseMessage": null,
            "flutterResponseCode": null,
            "flutterReference": null,
            "linkingReference": null,
            "disburseOrderId": null,
            "createdAt": "2016-11-23T14:34:50.000Z",
            "currencyId": 1,
            "walletCharged": null,
            "refund": null,
            "reversed": null
        },
        {
        ...
        },
        {
            "id": 432131,
            "amount": 10,
            "fee": 25,
            "status": "failed",
            "system_type": "wallet-disburse",
            "source": "wallet",
            "source_id": 331,
            "dest": "beneficiary",
            "dest_id": null,
            "ref": null,
            "flutterResponseMessage": "Not enough wallet balance",
            "flutterResponseCode": "CF",
            "flutterReference": null,
            "linkingReference": null,
            "disburseOrderId": 38684,
            "createdAt": "2017-08-10T06:54:42.000Z",
            "currencyId": 3,
            "walletCharged": null,
            "refund": null,
            "reversed": null
        }
    ],
    "meta": {
        "count": 500,
        "page": 1,
        "limit": 100
    }
}

Successful Beneficiary Payouts have their signature as - status : completed, system_type : wallet-disburse, dest : beneficiary, walletCharged: true, reversed : false, and refund : false.

Balance Debit Parameter Definitions

walletCharged - this flag indicates a debit has been successfully passed to the balance specified when requesting a disbursement.

reversed - indicates a previously successful transaction that has been returned. Note two transactions would exist, the disburse transaction with its reversed flag set as true, and a funding transaction to return the funds.

refund - indicates a failed transaction for which debit had occurred but processing failed. when this value is true, it means funds have been returned. There would be only one transaction, the failed disbursement request with the refund flag set as true.