Wallet Transaction Object

attributetypedescription
walletTransactionIDstringZeal Transaction ID
typeenumHolds one of the following values:
credit : this represents a positive contribution to the wallet balance (net pay credits)
debit: this represents a negative contribution to the wallet balance (push-to-card transfers)
companyIDstringZeal Company ID
employeeIDstringZeal Employee ID
contractorIDstringZeal Contractor ID
cardIDstringID of card used in transaction
bankAccountIDstringID of bank account used in transaction
statusstringHolds one of the following values: processing, settled, returned
descriptionstringDescription of transaction
gross_amountfloatGross amount of transaction, before any fees.
net_amountfloatNet amount the transaction , after any fees. In the case of debit type, this is the amount the worker receives
partner_feefloatPartner fees on the push-to-card transfer. Only applicable for debit type, otherwise $0.
zeal_feefloatZeal fees on the push-to-card transfer. Only applicable for debit type, otherwise $0.
last_fourstringLast four digits of card number. Only applicable for debit type.
datestringTimestamp of transaction
{
  "walletTransactionID": "c2213b02e052f60cfb0e4ba4",
  "type": "debit",
  "companyID": "bf015b00e052f60cfb0e4a0d",
  "employeeID": "d210f054bf5b006f50aecbe0",
  "contractorID": null,
  "bankAccountID": null,
  "cardID": "10c313104851406408f4130be0540451",
  "status": "settled",
  "description": "Instant transfer",
  "gross_amount": 102,
  "partner_fee": 1,
  "zeal_fee": 1,
  "net_amount": 100,
  "last_four": "0432",
  "date": "2025-08-01T23:00:00.000Z"
}

A Wallet Transaction represents the movement of funds into (credit) or out of (debit) the worker's Instant Pay Wallet.

If the transaction isdebit type:

  • This represents a push to card transfer out of a worker's wallet to their card
  • If you have a Charge Policy set up with Instant Pay, Zeal will apply your partner fee and the Zeal fee on transfers out of the wallet. The resulting net_amount is what the worker will receive to their card
  • The last four digits of the worker's card that receives the funds is stored on the transaction object

If credit type:

  • This represents a payment made to the wallet, such as net pay credits
  • The gross amount and net amount will be equal since there are no fees