Paycards (Early Access)

Intro

Paycards allow workers to get paid faster and have easier access to their funds. Once a worker completes paycard enrollment, a paycard is provisioned to them, and the paycard is now available as a disbursement method for an employee check or contractor payment (e.g. net pay is sent to the paycard). A worker can currently see their paycard details, see transaction history, and transfer funds to an external bank account through the whitelabeled mobile app.

Note: This product is in Early Access. Please reach out to the Zeal team to get access to this Product.

In this guide

  • How to include the paycard enrollment screen in worker onboarding
  • How to set paycards as a disbursement method on an employee check or contractor payment
  • How workers can access paycard details
  • How to access paycard information in the Zeal API

Paycard Enrollment

Every worker that you wish to provision a virtual paycard for must complete paycard enrollment. To include the paycard enrollment page in worker onboarding, you can set paycard to true when generating the Contractor Onboarding Link or when generating the Employee Onboarding Link.

A worker must agree and consent to agreements on the Paycard Enrollment page. Once the agreements are consented to and the onboarding is complete, a paycard will be provisioned for the worker and the paycard_enabled field will be true on the Employee or Contractor.

Paycard Disbursement Method

If you wish to have a worker's net pay be sent to their paycard, you can set disbursement_method = paycard when creating an employee check or contractor payment. If the disbursement method is set to paycard, the net pay amount will be available on the paycard when payroll is processed (e.g. the balance on the paycard will increase by the net pay amount and a new credit transaction will be shown to the worker).

You will receive an error if you try to use disbursement_method = paycard on a worker that does not have paycard_enabled = true.

Paycards in Mobile App

Workers can access their paycard details by logging into their worker dashboard in the mobile app and selecting the "Paycard" screen. On this page, workers can:

  1. view the paycard details
  2. add the card to digital wallet
  3. see transaction history
  4. transfer balance to an external bank account
  5. lock the card


Paycards API

You can find the Paycard Object details here and can use the GET /paycard endpoint to get all Paycard Objects for a company. This can be helpful for programmatically monitoring the status of paycards for workers. The status field holds one of the following values: active, suspended, terminated.

Recap

  • Workers must complete the paycard enrollment page which can be included in worker onboarding through UI or API
  • Workers can access the Paycard page in the mobile app
  • Paycard objects can be retrieved using the API