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:

  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": "****"
}