Wallet Statement

The wallet statement API provides merchants with the ability to generate wallet records for debits and credits done to any of their wallets.

Records contained in the wallet statement includes:

Deposits into the wallets (Credits)
Withdrawals for payment (Debits)
Transfer charges where applicable
Balances on every transaction
Transaction references and descriptions
Narration

To access this endpoint, include the Authorization header in your HTTP requests. The header should start with the word "Basic" followed by a space and a base64-encoded string representing your apiKey and clientSecret as "apiKey:clientSecret".

Endpoint Url: {{base_url}}/api/v1/disbursements/wallet/{{walletAccountNumber}}/statement

The {{base_url}} for test is https://sandbox.monnify.com but when you go live, it changes to the live url

Http Method: GET

To retrieve wallet statements, you would need to make a call to the "Wallet Statement" API. Additionally, merchants have the option to filter the request by providing date range and data size .

Sample Request

curl --location --request GET {{Base_Url}}/api/v1/disbursements/wallet/8016722372/statement?
startDate=1702076400000&endDate=1702458365000&pageNo=0&pageSize=11

Sample Response

{
  "requestSuccessful": true,
   "responseMessage": "success",
   "responseCode": "0",
   "responseBody": {
       "content": [
           {
               "walletTransactionReference": "AT5_MFDS7820231213095406006362L4V3F9_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS7820231213095406006362L4V3F9_1_DEBIT_0",
               "availableBalanceBefore": 630.0,
               "availableBalanceAfter": 500.0,
               "amount": 130.0,
               "transactionDate": "2023-12-13T08:54:06.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS7820231213095406006362L4V3F9/#/MFDB_483_4ace7c31-9b9d-43cb-bff1-48117f5e480f-1/#/test/#/GTBank/#/0456638287",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS7820231213095406006363AQ5EDQ_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS7820231213095406006363AQ5EDQ_1_DEBIT_0",
               "availableBalanceBefore": 500.0,
               "availableBalanceAfter": 390.0,
               "amount": 110.0,
               "transactionDate": "2023-12-13T08:54:06.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS7820231213095406006363AQ5EDQ/#/MFDB_483_4ace7c31-9b9d-43cb-bff1-48117f5e480f-2/#/test/#/First bank/#/3012686077",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS7820231213095406006364RD7AMA_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS7820231213095406006364RD7AMA_1_DEBIT_0",
               "availableBalanceBefore": 390.0,
               "availableBalanceAfter": 280.0,
               "amount": 110.0,
               "transactionDate": "2023-12-13T08:54:06.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS7820231213095406006364RD7AMA/#/MFDB_483_4ace7c31-9b9d-43cb-bff1-48117f5e480f-3/#/test/#/Zenith bank/#/2120456619",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS69420231213093010005157WG187R_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS69420231213093010005157WG187R_1_DEBIT_0",
               "availableBalanceBefore": 870.0,
               "availableBalanceAfter": 740.0,
               "amount": 130.0,
               "transactionDate": "2023-12-13T08:30:10.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS69420231213093010005157WG187R/#/MFDB_483_6002ba60-0df0-4219-972a-a2eb0650d9ff-1/#/test/#/GTBank/#/0456638287",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS69420231213093010005158VAQR70_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS69420231213093010005158VAQR70_1_DEBIT_0",
               "availableBalanceBefore": 980.0,
               "availableBalanceAfter": 870.0,
               "amount": 110.0,
               "transactionDate": "2023-12-13T08:30:10.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS69420231213093010005158VAQR70/#/MFDB_483_6002ba60-0df0-4219-972a-a2eb0650d9ff-2/#/test/#/First bank/#/3012686077",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS69420231213093010005159YKATJK_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS69420231213093010005159YKATJK_1_DEBIT_0",
               "availableBalanceBefore": 740.0,
               "availableBalanceAfter": 630.0,
               "amount": 110.0,
               "transactionDate": "2023-12-13T08:30:10.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS69420231213093010005159YKATJK/#/MFDB_483_6002ba60-0df0-4219-972a-a2eb0650d9ff-3/#/test/#/Zenith bank/#/2120456619",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS71720231213090951004371YGW97L_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS71720231213090951004371YGW97L_1_DEBIT_0",
               "availableBalanceBefore": 1110.0,
               "availableBalanceAfter": 980.0,
               "amount": 130.0,
               "transactionDate": "2023-12-13T08:09:55.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS71720231213090951004371YGW97L/#/MFDB_483_ee2036fc-380c-45e4-8cc2-79687d5782e4-1/#/test/#/GTBank/#/0456638287",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS7172023121309095400437222PJ74_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS7172023121309095400437222PJ74_1_DEBIT_0",
               "availableBalanceBefore": 1330.0,
               "availableBalanceAfter": 1220.0,
               "amount": 110.0,
               "transactionDate": "2023-12-13T08:09:54.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS7172023121309095400437222PJ74/#/MFDB_483_ee2036fc-380c-45e4-8cc2-79687d5782e4-2/#/test/#/First bank/#/3012686077",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS71720231213090954004373QP92S6_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS71720231213090954004373QP92S6_1_DEBIT_0",
               "availableBalanceBefore": 1220.0,
               "availableBalanceAfter": 1110.0,
               "amount": 110.0,
               "transactionDate": "2023-12-13T08:09:54.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS71720231213090954004373QP92S6/#/MFDB_483_ee2036fc-380c-45e4-8cc2-79687d5782e4-3/#/test/#/Zenith bank/#/2120456619",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS7820231213090805004333UGAJJR_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS7820231213090805004333UGAJJR_1_DEBIT_0",
               "availableBalanceBefore": 1570.0,
               "availableBalanceAfter": 1440.0,
               "amount": 130.0,
               "transactionDate": "2023-12-13T08:08:05.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS7820231213090805004333UGAJJR/#/MFDB_483_b816a551-2977-4c65-8da9-e077ce725dc7-1/#/test/#/GTBank/#/0456638287",
               "status": "COMPLETED"
           },
           {
               "walletTransactionReference": "AT5_MFDS782023121309080500433478V8X6_1_DEBIT_0",
               "monnifyTransactionReference": "AT5_MFDS782023121309080500433478V8X6_1_DEBIT_0",
               "availableBalanceBefore": 1440.0,
               "availableBalanceAfter": 1330.0,
               "amount": 110.0,
               "transactionDate": "2023-12-13T08:08:05.000+0000",
               "transactionType": "DEBIT",
               "message": null,
               "narration": "MFDS782023121309080500433478V8X6/#/MFDB_483_b816a551-2977-4c65-8da9-e077ce725dc7-2/#/test/#/First bank/#/3012686077",
               "status": "COMPLETED"
           }
       ],
       "pageable": {
           "sort": {
               "sorted": false,
               "unsorted": true,
               "empty": true
           },
           "pageSize": 11,
           "pageNumber": 0,
           "offset": 0,
           "unpaged": false,
           "paged": true
       },
       "last": false,
       "totalPages": 3,
       "totalElements": 29,
       "size": 11,
       "number": 0,
       "sort": {
           "sorted": false,
           "unsorted": true,
           "empty": true
       },
       "first": true,
       "numberOfElements": 11,
       "empty": false
   }
}