How to Send a Mass Payout

Initiating a Mass Payout

1. From the left-hand navigation menu, go to eCommerce → Pay Outs.
2. Click Create Payout → Mass Payout to proceed to Create a mass payout.

3. Next, choose the account/PMID you want to use to fund the Mass Payout.

• Note that auto-conversion is only available for fiat PMIDs, hence if you select a crypto PMID, all payouts within the Mass Payout file will need to match the currency (and network for USDT/USDC) of the PMID.

4. Click next to proceed to the Upload Screen.
5. At this point, you will be able to download the Mass Payout template which is relevant to the PMID you have selected. Any deviation from the headers in this template will cause your Mass Payout file to be rejected.
6. Click to download the CSV template and open it in your chosen software.

7. Fill out the template according to the guidance in filling your template.

8. Once your template is ready, save your template as a .csv (CSV) or a .xlsx (Excel) and upload it to the Orbital Client Portal.

• Any critical errors will appear at this point:
  • Invalid Balance: The account you have chosen does not have sufficient balance to fund the payouts in your file. You will need to return to your file to delete some payouts before reuploading it, or return to the account selection stage and choose an account with a higher balance.
  • Too Many Payouts: Mass Payouts currently supports up to 1000 payouts in a single file. If you exceed this amount, you will need to return to your file to delete some payouts before reuploading it.
  • Invalid Input in Amount Field: The ‘amount’ field may only contain alphanumeric characters (including . and , ) - you will need to return to your file to ensure that no rows contain invalid characters in the ‘amount’ field.

9. If no critical errors are displayed, click next to proceed to the review screen.
10. At this point, any errors within your payment file will be displayed. Click into a payment to review the error in more detail.

• To fix the error, you will need to edit your file accordingly and reupload it on the upload page. For more guidance, refer to filling your template.

11. Once the file has been uploaded and contains no errors, ensure you are happy with the payments listed then click next to proceed to the confirmation page - here you will be able to review the total amount, any applicable fees, and the amount to fund the payouts.
12. Click Confirm Mass Payout to proceed.

Viewing a Mass Payout

Once a Mass Payout has been submitted, the individual payouts will proceed to the eCommerce → Pay Outs → Payments Generating tab. Payouts in this table are being requested in the Orbital system, and once they have been successfully created (this should only take a short amount of time) they will move to the regular eCommerce → Pay Outs → All Payouts tab, where they will follow the process of a regular payout (including the regular statuses).

If you click onto a payout, you will find its BatchID, which identifies the Mass Payout it is a part of. You can use this BatchID to search in the Payments Generating and All Payouts tab, to view all payments from that batch.

Approving a Mass Payout

If you have approval rules enabled for eCommerce payouts, an eCommerce Mass Payout will join the approval queue. There are two options for how to approve a Mass Payout:

• Batch Approval Mode: A Mass Payout will appear as a single ‘batch’ in the approval queue. When you approve the Mass Payout, you are approving the entire batch (i.e. you cannot approve/reject individual payouts within a Mass Payout). This is best for quick, streamlined approval.
• Individual Approval Mode: Each individual payout within the Mass Payout will appear in the approval queue. You will approve/reject each individual payout separately. This is ideal for detailed oversight.

If you do not have approval rules enabled for eCommerce payouts, any Mass Payout will not be held for approval and will proceed like a regular eCommerce payout.

Selecting your Approval Mode

1. Navigate to Approval Queue.
2. Navigate to the Mass Payouts tab.
3. Select ‘Choose Approval Mode’ button.
4. Toggle Batch Approval Mode on/off depending on your desired setting.

Note: You will not be able to change the Approval Mode while there are payouts pending in the Approval Queue - ensure you have selected the correct Approval Mode for your business before you make any Mass Payouts.

Approving a Mass Payout using Batch Approval Mode

A Mass Payout will appear in the Approval Queue under the Mass Payouts tab.

When reviewing a Mass Payout for approval - you will see when the Mass Payout was submitted, total amount instructed, creator of the Mass Payout, number of transactions, and Batch ID - you can see all associated individual payouts associated with this batch (they will all have the same Batch ID, to support your reconciliation).

If you approve the Mass Payout, all individual payouts within the batch will proceed to processing. Due to the instantaneous nature of crypto payouts, it is virtually impossible to stop or cancel a transaction once the process has started. Please verify carefully before approving.

Approving a Mass Payout using Individual Approval Mode

All individual payouts from the Mass Payout will appear in the Approval Queue under the Mass Payouts tab.

Follow the regular approval process to approve or reject each payout from the Mass Payout. Due to the instantaneous nature of crypto payouts, it is virtually impossible to stop or cancel a transaction once the process has started. Please verify carefully before approving.

Reporting

Individual payouts from a Mass Payout are visible in your reports (see the Reporting section for instructions on how to generate an eCommerce report). Look for the dedicated BatchID field. You can use this unique ID to filter and reconcile all payments associated with a specific Mass Payout, including each individual payout’s status.

Filling your template

❗️

Ensure you download a new Mass Payout template every time you initiate a Mass Payout, as the precise data required is dependent on the PMID/account used to fund the transaction.

Refer to the below guidance on the formatting and requirements of the fields for either a crypto PMID or fiat PMID template, but if in doubt, check your template to see which fields are present.

Fiat PMID Template

For Fiat PMIDs, auto-conversion is undertaken. You can input multiple payout currencies into your file and Orbital will handle the conversion into the chosen currency for each beneficiary. Note that the inputted amount will be in your Source Currency (the fiat currency).

Field	Description	Required Format
Amount	The amount to be sent to the beneficiary's account (in the source Currency i.e. the fiat currency)	Mandatory Numeric characters and separators ( . , ) only
Description	Custom text to describe the payment	Optional Alpha-numeric characters only: letters (A-Z, a-z), digits (0-9), and spaces are permitted
Currency	The currency to be sent to the beneficiary's account	Mandatory Must be an allowed payout currency: USDT, USDC, ETH, BTC, LTC, BCH
Network	For USDT/USDC, the blockchain/network of the currency to be sent to the beneficiary's account	Conditional: Mandatory if Currency is USDT or USDC For USDT: TRX, ETH, MATIC, TON, BNB For USDC: SOL, ETH, MATIC, TRX, BNB
BeneficiaryType	The type of beneficiary (business or individual)	Mandatory A single character indicating the entity type - ‘B'/’b' (Business) or ‘I'/’i' (individual) only
BusinessRegisteredName	The registered name for a business beneficiary	Conditional: Mandatory if BeneficiaryType is B/b (Business) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
IndividualFirstName	The first name for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
IndividualLastName	The last name for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
WalletAddress	The beneficiary’s wallet address	Mandatory May only contain letters, numbers, colons ( : ), and dashes ( - )
CompanyRegistrationNumber	The company registration number for a business beneficiary	Conditional: Inclusion of this field is PMID-dependent. If present in your template, it is Mandatory when the BeneficiaryType is set to 'B' (Business). May only contain letters and numbers, with no symbols or line breaks.
DateOfBirth	The date of birth for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) Must be inputted in the format of DD/MM/YYYY

Crypto PMID Template

For Fiat PMIDs, auto-conversion is undertaken. You can input multiple payout currencies into your file and Orbital will handle the conversion into the chosen currency for each beneficiary.

Field	Description	Required Format
Amount	The amount to be sent to the beneficiary's account (in the given Currency)	Mandatory Numeric characters and separators ( . , ) only
Description	Custom text to describe the payment	Optional Alpha-numeric characters only: letters (A-Z, a-z), digits (0-9), and spaces are permitted
Currency	The currency to be sent to the beneficiary's account	Mandatory Must match the currency of the PMID you selected to fund the Mass Payout: USDT, USDC, ETH, BTC, LTC, BCH
Network	For USDT/USDC, the blockchain/network of the currency to be sent to the beneficiary's account	Conditional: Mandatory if Currency is USDT or USDC Must match the network of the PMID you selected to fund the Mass Payout For USDT: TRX, ETH, MATIC, TON, BNB For USDC: SOL, ETH, MATIC, TRX, BNB
BeneficiaryType	The type of beneficiary (business or individual)	Mandatory A single character indicating the entity type - ‘B'/’b' (Business) or ‘I'/’i' (individual) only
BusinessRegisteredName	The registered name for a business beneficiary	Conditional: Mandatory if BeneficiaryType is B/b (Business) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
IndividualFirstName	The first name for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
IndividualLastName	The last name for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
WalletAddress	The beneficiary’s wallet address	Mandatory May only contain letters, numbers, colons ( : ), and dashes ( - )
CompanyRegistrationNumber	The company registration number for a business beneficiary	Conditional: Inclusion of this field is PMID-dependent. If present in your template, it is Mandatory when the BeneficiaryType is set to 'B' (Business). May only contain letters and numbers, with no symbols or line breaks.
DateOfBirth	The date of birth for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) Must be inputted in the format of DD/MM/YYYY

Binance Pay Template

For Binance Pay PMIDs, payouts can be in either USDT or USDC. You will need to provide either the BinanceID or BinanceEmailAddress associated with your beneficiary for a successful payout. If both are provided, the BinanceID will be used to make the payout.

Field	Description	Required Format
Amount	The amount to be sent to the beneficiary's account (in the given Currency)	Mandatory Numeric characters and separators ( . , ) only
Description	Custom text to describe the payment	Optional Alpha-numeric characters only: letters (A-Z, a-z), digits (0-9), and spaces are permitted
Currency	The currency to be sent to the beneficiary's account	Mandatory Must be USDT or USDC
BeneficiaryType	The type of beneficiary (business or individual)	Mandatory A single character indicating the entity type - ‘B'/’b' (Business) or ‘I'/’i' (individual) only
BusinessRegisteredName	The registered name for a business beneficiary	Conditional: Mandatory if BeneficiaryType is B/b (Business) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
IndividualFirstName	The first name for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
IndividualLastName	The last name for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) May only contain letters, numbers, spaces, and the following symbols: . / \ - ? : ( ) , +
BinanceID	The beneficiary's BinanceId	Conditional: At least one of BinanceID and BinanceEmailAddress must be provided May only contain numbers, minimum 5 digits long, with no letters, spaces, or symbols
BinanceEmailAddress	The beneficiary's email address associated with their Binance account	Conditional: At least one of BinanceID and BinanceEmailAddress must be provided Must be a valid email address (e.g. [email protected])
DateOfBirth	The date of birth for a beneficiary that is an individual	Conditional: Mandatory if BeneficiaryType is I/i (Individual) Must be inputted in the format of DD/MM/YYYY

Errors

Invalid Format: In most cases, the error will notify you of the supported format, so you can edit the payout in your file and reupload. You can also refer to the template guides to check the valid format for each field.

Missing Data: If you have missed a mandatory data field for a payout, you will see an error in the Review page when you click into the flagged payout. You will need to return to your file and add this data before reuploading.

Data is not required for Business/Individual beneficiary: If you have inputted the Beneficiary Type as Business, but then fill out data fields specific to an individual (e.g. Date Of Birth, Individual First Name, Individual Last Name), this payout will be flagged and you will not be able to proceed. The same will happen if you input the Beneficiary Type as Individual, but fill out data fields specific to a business (e.g. Company Registration Number, Business Registered Name). You will need to return to your file to validate whether the Beneficiary Type is correct and ensure the correct information has been added for either a Business or Individual. You can also refer to the template guides to check which fields are mandatory for Business or Individual payouts.

FAQs

1. Why does a payout from a Mass Payout have a failed status?

If the payout is in the Payments Generating tab, and has the Failed status, this means that the payout could not be successfully created in the Orbital system. In this case, please retry the specific failed payout through eCommerce > Payouts > Create a Payout > Single Payout or eCommerce > Payouts > Create a Payout > Mass Payout if you have multiple payouts to make.

If the payout is in the All Payouts tab, it will follow the regular list of payout statuses.

2. Why does this field have an error displaying for my input?

Please refer to the relevant section for your template for details on how each field should be formatted. If you are still having issues with your file, please reach out to your Orbital Customer Service Representative.

3. Where can I find my Mass Payouts?

Your Mass Payouts exist in the same place as the existing singular payouts - eCommerce > Pay Outs. When a payout from your Mass Payout is still generating in the Orbital system, you will find it in the Payments Generating tab, but once it has been created, it will exist in the All Payouts tab, and is like any other payout.

4. How do I approve my Mass Payout?

You can select whether you want to use Bulk Approval Mode or Individual Approval Mode within the Approval Queue → Mass Payouts tab. Review the Approval Section for further details.

5. Why is my Mass Payout not in the approval queue yet?

When you submit a Mass Payout, all individual payouts must be created in the Orbital system in order for the Mass Payout to be approved. There can be some delay between clicking submit on a Mass Payout and it appearing in your approval queue - you can check whether the payments are in the process of being created by visiting the eCommerce > Pay Outs > Payments Generating tab.

6. Why can I not payout in this currency?

If a crypto PMID is selected, payouts must be in the same currency (including network for USDT/USDC) as that PMID.

If a Binance Pay PMID is selected, payouts must be using Binance Pay (i.e. providing Binance IDs or email addresses for payouts).

If a fiat PMID is selected, payouts can be in any supported cryptocurrency and Orbital will handle the auto-conversion.

7. Can I cancel my Mass Payout?

Once a Mass Payout file is submitted, the individual payouts are immediately created in the system and processing begins. If you have Approval Rules on, you can reject the relevant payouts in the Approval Queue. However, due to the instantaneous nature of crypto payouts, it is virtually impossible to stop or cancel a transaction once processing has started. Please verify your file carefully before confirming the submission.