Wallets

List all wallets#

All the information from the Zūm Wallets can be pulled with one API call. The information includes the wallet type, the wallet ID and the balance.

Method: GET

Endpoint: {{env}}/api/wallet

tip

Use this endpoint to know the Wallet ID in order to create AccountsPayable or AccountsReceivable transactions from/to Zūm Wallet.

Response

{
  "statusCode": 200,
  "message": "GET Request successful.",
  "isError": false,
  "result": [
    {
      "Id": "30126b59-...-008376504211",
      "Type": "AccountsPayable",
      "Balance": 50000.88
    },
    {
      "Id": "30126b59-...-008376504210",
      "Type": "Unified",
      "Balance": 1000.5
    }
  ]
}

Response

Parameter	Type	Description
Id	guid	Wallet id
Type	string	Wallet type
Balance	decimal	Current balance in the wallet

Filter wallet transactions#

Use this endpoint to list the transactions from a specific wallet. The response includes all debits and credits from the wallet.

Method: POST

Endpoint: {{env}}/api/wallet/transactions/filter

Request
Response

{
  "WalletId": "30126b59-...-008376504210",
  "Pagination": {
    "PageNumber": 1
  }
}

info

This endpoint is also available in {{env}}/api/wallet/transactions, but it may be removed eventually.

Request parameters

Parameter	Type	Mandatory	Description
WalletId	guid	yes	Wallet id
TransactionMethod	string	no	Transaction method
ZumRailsType	string	no	Transaction Type
GenericSearch	string	no	Filter wallets by description
CreatedAtFrom	datetime	no	Start date (This field is only used when the operator is between)
CreatedAtTo	datetime	no	End date (This field is only used when the operator is between)
CreatedAt	datetime	no	Create date
CreatedAtOperator	string	no	Operator to filter with CreatedAt properties
Pagination		no
PageNumber	number	no	The respective page, starting at 1

Response

Parameter	Type	Description
CurrentPage	number	The current page
PageSize	number	The amount of rows returned in the current page
TotalCount	number	The total rows the filter returns
Items		List of wallet transactions
Id	guid	Transaction id
CreatedAt	datetime	When the transaction was created
Description	string	Transaction description
Debit	decimal	Debit amount
Credit	decimal	Credit amount
Balance	decimal	Balance at that moment
Type	string	Credit or Debit
Authorized	bool	If the transaction is completed and authorized