Overview
Wallet Accounts serve as a holding account for receiving payments within your platform. Any amount being paid out to a seller in Zai will pass through the wallet account of that seller. Wallet Accounts have a one-to-one relationship with a user, and each user has a wallet account by default.
When a user receives payments into the Wallet Account, these amounts are automatically paid out from the user’s Wallet Account into the bank account by default, following our batch payment schedule.
Wallet Accounts can also be used as a payment source should your platform workflow require this.
There are strict controls around the use of Wallet Accounts within your platform. Contact Zai support if you want to manually payout funds and by implication, allow the wallet account to be used as a payment funding source.
How it works
Wallet Account features
Instant payments
Funds held in a Wallet Account can be used to pay for good or services within your platform, and these funds are paid immediately.
Everyone has one
Every user is given a wallet account upon creation of the user object. The platform administrator user also has a wallet account, which is used to receive platform fees billed to users.
Chained payments
Wallet accounts can be used as an intermediate holding account, and so can be part of a chain of payments within your platform. This allows a variety of complex payment scenarios, such as where many users need to pay to a single user (ie. group funding).
Bundled payouts
Wallet accounts can also be used to hold funds until the user wants to withdraw these funds, perhaps waiting for a higher balance or minimum value, thereby reducing the number and cost of payouts to their bank account.
Easy funding
A wallet account can be funded from deposits made from a user’s Bank Account or from the proceeds of payments received from items sold.
Currencies
Wallet accounts follow your platform’s default currency (AUD, NZD or USD).
Refunds
Refunds to wallet accounts are immediate and are returned to the wallet account that was used as the payment source.
Processing transactions
Payments from wallet accounts are processed immediately. They are applied from existing funds already held on behalf of the user.
By default, the user’s wallet account balance will be automatically paid out to them as per the batch schedule (several times per day). A platform can request that wallet accounts be set to manual payouts, and as such funds can be held indefinitely on behalf of the user and be used to fund further Items, or until a scheduled payout minimum value.
Walkthrough
1) Depositing funds to a Wallet Account
Use Deposit Funds to add funds to a Wallet Account. Funds can be added to a wallet account by specifying which account the funds should be sourced from and the amount (in cents).
Zai only supports using a Bank Account as a source for funds to be added to a wallet account. If paying using direct debit a Bank Account and Direct Debit Authority needs to exist prior to depositing funds. If paying using a wire transfer, the details are shown including the reference. Users must use the reference when sending funds so that they can be matched up to their wallet account.
2) Withdrawing funds from a Wallet Account
Use Withdraw Funds to withdraw funds from a Wallet Account. Funds can be withdrawn from a wallet account by specifying which account the funds should be paid out to and the amount (in cents). Zai supports using a Bank Account or a PayPal account as a payout destination. The Bank Account or the PayPal account needs to exist prior to attempting the withdraw of funds. Note that a Bank Account is a prerequisite to a PayPal account being used for payout.
3) Displaying a Wallet Account balance
Use Show Wallet Account to display the details and balance of a wallet account.
4) Making Payment using a Wallet Account
A Wallet Account acts like a Card Account or Bank Account. When making a payment within your platform, the ID of the Wallet Account simply needs to be passed through to Make Payment. This requires the Wallet Account funds to have a sufficient amount available.