Wallet Transaction Object

attribute

type

description

walletTransactionID

string

Zeal Transaction ID

type

enum

Holds 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)

companyID

string

Zeal Company ID

employeeID

string

Zeal Employee ID

contractorID

string

Zeal Contractor ID

cardID

string

ID of card used in transaction

bankAccountID

string

ID of bank account used in transaction

gross_amount

float

Gross amount of transaction, before any fees.

net_amount

float

Net amount the transaction , after any fees. In the case of debit type, this is the amount the worker receives

partner_fee

float

Partner fees on the push-to-card transfer. Only applicable for debit type, otherwise $0.

zeal_fee

float

Zeal fees on the push-to-card transfer. Only applicable for debit type, otherwise $0.

last_four

string

Last four digits of card number. Only applicable for debit type.

date

string

Timestamp of transaction

{
    "walletTransactionID": "c2213b02e052f60cfb0e4ba4",
    "type": "debit",
    "companyID": "bf015b00e052f60cfb0e4a0d",
    "employeeID": "d210f054bf5b006f50aecbe0",
    "contractorID": null,
    "bankAccountID": null,
    "cardID": "10c313104851406408f4130be0540451",
    "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