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 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:

  1. Create
  2. Commit / Cancel

Funds will be deducted from account on step 2 if a commit was made

The Payout Object

ParameterTypeDescription
'id'NumberUnique id of payout object
'ewallet_id'Stringaccount id of the payout balance
'payout_option_id'StringPayout option id of the payout
'payout_method'EnumPayout method: bank_transfer
'amount'NumberAmount of the payout
currencyEnumaccount currency: 'USD', 'EUR', 'GBP'
'status'EnumPayout's status: 'Pending', 'Succeeded', 'Failed'

The Payout Option Object

ParameterTypeDescription
'id'StringUnique id of payout option
'identityType'EnumIdentity Type: VENDOR
'identity'Stringid of identity
'payout_option_type'EnumPayout option types: 'Card', 'Alternative', 'Bank Account'
'bank_account'ObjectFor Payout Option 'Bank Account' only.
'card_account'ObjectFor Payout Option 'Card' only.
'apm_account'ObjectFor 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": "****"
}