Check Payout Status

Verify Disbursement

Once a disburse request is received, it becomes available for status checks. When a disbursement is submitted, its status goes into pending and when processing is completed, the status updates to either completed or failed.

To check the status of a submitted disbursement. The transactions ref is passed to the API below.

Disburse Status

POST https://staging.moneywaveapp.com/v1/disburse/status

Headers

Name	Type	Description
Authorization	string	Authorization Token

Request Body

Name	Type	Description
ref	string	Unique transaction tracking reference

200

{
    "status": "success",
    "data": {
        "id": 1669531,
        "amount": 50000,
        "status": "completed",
        "system_type": "wallet-disburse",
        "ref": "15260407UAKFY6K6Y",
        "flutterResponseMessage": "Successful",
        "flutterResponseCode": "00",
        "flutterReference": "TTMW001669531",
        "linkingReference": "044031974029",
        "disburseOrderId": null,
        "ipr": null,
        "iprc": null,
        "r1": null,
        "r2": null,
        "meta": "{\"narration\":\"First Payout\",\"sender\":\"Business_Name\",\"balance\":84033.39",
        "createdAt": "2018-05-11T12:13:53.000Z",
        "updatedAt": "2018-05-11T17:21:06.000Z",
        "beneficiary": {
            "accountNumber": "0234600000",
            "bankCode": "035"
        },
        "walletCharged": true,
        "refund": false,
        "reversed": false
    }
}

Sample Code

Select a Language above ...

Node.JS

PHP

Confirming Success

When a disbursement is verified for status, the response returned contains specific fields required in determining the state of the disbursement. See the example response in the API snippet above.

A verified disbursement is successful only when the disburse status API response has the value below.

"status" : "completed"

There are additional fields further indicating the transaction status

"flutterResponseCode": "00"

"reversed": false

When the reversed flag is set to true, this indicates a disbursement that was returned by the destination bank, for example due to limits on destination account.