Wallet Accounts serve as a holding account for receiving payments within your platform. Any amount being paid out to a seller in Assembly 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 Assembly support if you want to manually pay out funds and by implication, allow the wallet account to be used as a payment funding source.
How it works
Wallet Account features
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.
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 pay outs
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 pay outs to their bank account.
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.
Wallet accounts follow your platform’s default currency (AUD, NZD or USD).
Refunds to wallet accounts are immediate and are returned to the wallet account that was used as the payment source.
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 pay outs, and as such funds can be held indefinitely on behalf of the user and be used to fund further Items, or until a scheduled pay out minimum value.
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).
Assembly 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). Assembly supports using a Bank Account or a PayPal account as a pay out 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 pay out.
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.