Overview
A payout is the transfer of funds to a bank account or other payment option. To receive funds (for you or your vendors), you can pay out from an existing account containing an available balance (payable_balance
).
Make sure to implement payout webhooks so you will get notified about your vendors activity
What you can do with the Payouts
- Send fast payouts to your Vendors' Bank account
- Send fast payouts to your Bank account
Scheduled Payout
You can decide whether you like to schedule payouts or perform an on-demand payout.
UNIPaaS allow you to schedule your own payouts and your vendor payouts. you can also schedule a payout for each vendor separately. If you embedded our vendor view in your admin, your vendors will be able to configure their own scheduled payouts.
You can [learn more] (https://docs.unipaas.com/docs/payouts-from-unipaas-portal) about scheduled payouts here
Before You Begin
- Make sure you have the relevant account ID
- Make sure you have the correct Vendor ID
- Make sure you have a relevant payout option configured or register new one
Request Payout
Requesting a payout consists of 2 steps:
- Create
- Commit / Cancel
Funds will be deducted from account on step 2 if a commit was made
The Payout Object
Parameter | Type | Description |
---|---|---|
'id' | Number | Unique id of payout object |
'ewallet_id' | String | account id of the payout balance |
'payout_option_id' | String | Payout option id of the payout |
'payout_method' | Enum | Payout method: bank_transfer |
'amount' | Number | Amount of the payout |
currency | Enum | account currency: 'USD', 'EUR', 'GBP' |
'status' | Enum | Payout's status: 'Pending', 'Succeeded', 'Failed' |
The Payout Option Object
Parameter | Type | Description |
---|---|---|
'id' | String | Unique id of payout option |
'identityType' | Enum | Identity Type: VENDOR |
'identity' | String | id of identity |
'payout_option_type' | Enum | Payout option types: 'Card', 'Alternative', 'Bank Account' |
'bank_account' | Object | For Payout Option 'Bank Account' only. |
'card_account' | Object | For Payout Option 'Card' only. |
'apm_account' | Object | For Payout Option 'Alternative' only. |
An example for 'bank_account' object:
{
"iban": "GB71BARC20032634966595",
"name": "Unipass docs example",
"country": "GB"
}
An example for 'apm_account' object:
{
"name": "Unipass docs example"
}
An example for 'card_account' object:
{
"brand": "VISA",
"issuer_country": "GB",
"program": "Visa Traditional",
"bin": "*******",
"expiration_month": "09",
"expiration_year": "22",
"last4Digits": "****"
}
Updated almost 2 years ago