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

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.

{
  "walletTransactionID": "c2213b02e052f60cfb0e4ba4",
  "type": "debit",
  "companyID": "bf015b00e052f60cfb0e4a0d",
  "employeeID": "d210f054bf5b006f50aecbe0",
  "contractorID": null,
  "gross_amount": 102,
  "partner_fee": 1,
  "zeal_fee": 1,
  "net_amount": 100,
  "last_four": "0432"
}

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