Payouts Tab

Payout is the the type of operation where you transfer money to an end-user’s account.

The "Payouts" table displays the following columns:

Name	Description
Title	Displays the name given to the payout process as a way of identification on the platform.
Date	Displays the date and time the payout process was created.
Count	Displays the amount of payouts executed on this payout process (for mass payout purposes).
Status	Displays the current status of the payout process: Success, Partial success, Pending, Failed.
Total in USD	Displays the amount to be paid in USD.

On the Payouts tab you can:

Filter the Payouts Table

There are two ways of filtering the "Payouts" table:

• Search bar:

1. Click on the Search icon:

   

2. Insert the desired value into the search bar:

   

   You can search by title, address, external tag.

3. The table displays only the entries that match the inserted text:

   

• Filter selection:

1. 1. In the top-left corner of the screen you have a drop-down menu:

   

2. Click on the desired status from the drop-down menu.

3. The table only displays the entries that match the selected status.

Click the title of the desired column to sort the table in ascending or descending order based on that column’s values.

See the Payout Operation Info

1. Hover over the desired payout row on the Payouts table:

   

2. Click on the "Options" button of the desired payout:

   

3. Click on Info from the drop-down menu:

   

4. The "Payout info" card is displayed:

   

See the Mass Payout Operation Info

1. Hover over the desired payout row on the Payouts table:

   

2. Click on the "Options" button of the desired payout:

   

3. Click on Details from the drop-down menu:

   

4. The page displays the entries on the mass payout operation:

   

5. Hover over the desired entry row:

   

6. Click on the "Options" button of the desired payout:

   

7. Click on Details from the drop-down menu:

   

8. The "Payout details" card is displayed:

   

Approve a Payout

1. Hover over the desired payout row on the Payouts table:

   

2. Click on the "Options" button of the desired payout:

   

3. Click on Details from the drop-down menu:

   

4. The page displays the entries on the mass payout operation:

   

5. Click "Approve" next to the desired payout:

   

6. Confirm the action with your one-time (2FA) password.

You can approve all payouts by clicking on the "Approve all" button:

Add a Payout

1. Hover over the desired payout row on the Payouts table:

   

2. Click on the "Options" button of the desired payout:

   

3. Click on Details from the drop-down menu:

   

4. The page displays the entries in the mass payout operation:

   

5. Click the Add payout button:

   

6. The Payout card is displayed:

   

7. Select the desired asset to use for the payout operation.

8. The Payout card expands:

   

9. In "Amount", insert the desired amount of crypto to transfer (from the available crypto for the selected cryptocurrency).

10. Select the the desired address to move the crypto to from the Address Book drop-down list or insert an address in the "Destination address".

11. In "External ID", insert the desired tag for internal purposes (for example, to have the payouts to a specific destination marked with the same tag). This field is optional and it can be left blank.

12. In "Wallet tag", insert the unique numerical code, required by some blockchains, to pair with the deposit address, as an additional Security measure. This field is only visible for some assets and is required when transferring to a centralized exchange.

13. Click on the checkbox to set as "true" if you want the network fees to be paid by the end user:

    • If checked: The network fee amount is deducted from the inserted amount (the end user receives the amount minus the network fees).

      This is only possible for the native asset of the network and not for the tokens.

    • If unchecked: The network fees are added to the amount to pay for the payout operation.

14. The "Estimated network fee" displays the fee to pay based on your asset selection.

15. The "Processing fee" displays the fee to pay based on your Settlement selections.

16. The "Total estimated proceeds" displays the total amount to pay for the Settlement.

17. The "Estimated amount to be received" displays the amount that the user is expected to receive.

18. Click on the "Done" button to proceed (the button becomes clickable when all required fields are filled).

19. Confirm the action with your one-time (2FA) password.

20. The payout operation is created and displayed on the "Mass Payout details" table.

Edit a Payout

1. Hover over the desired payout row on the Payouts table:

   

2. Click on the "Options" button of the desired payout:

   

3. Click on Details from the drop-down menu:

   

4. The page displays the entries in the mass payout operation:

   

5. Hover over the desired entry row:

   

6. Click on the "Options" button of the desired payout:

   

7. Click on Edit from the drop-down menu:

   

8. The Edit payout card is displayed:

   

9. Edit the payout. The following fields are available to edit:

   • Requested asset: Select the desired asset from the drop-down menu.
   • Amount: Insert the desired amount of the selected asset.
   • Address: Insert the desired address to send the amount to.
   • External ID: Insert the desired external tag for external purposes.

10. Click on the Submit button to proceed.

11. The payout entry is changed and displayed on the Mass Payout details table.

Delete a Mass Payout entry

1. Hover over the desired payout row on the Payouts table:

   

2. Click on the "Options" button of the desired payout:

   

3. Click on Details from the drop-down menu:

   

4. The page displays the entries in the mass payout operation:

   

5. Hover over the desired entry row:

   

6. Click on the "Options" button of the desired payout:

   

7. Click on Delete from the drop-down menu:

   

8. A pop-up card is displayed requiring confirmation:

   

9. Click on the Confirm button to proceed.

10. The mass payout entry is deleted and removed from the "Mass Payout details" table.

The "Delete" button is only available if the entry is in PENDING status.

Retry Failed Payouts

1. Hover over the desired payout row on the Payouts table:

   

2. Click on the "Options" button of the desired payout:

   

3. Click on Details from the drop-down menu:

   

4. The page displays the entries in the mass payout operation:

   

5. Click on the Retry all failed button:

   

Create a Payout

1. Click on the Payout button:

   

2. The Payout card is displayed:

   

3. Select the desired asset to use for the payout operation.

4. The Payout card expands:

   

5. In "Amount", insert the desired amount of crypto to transfer (from the available crypto for the selected cryptocurrency).

6. Select the the desired address to move the crypto to from the Address Book drop-down list or insert an address in the "Destination address".

7. In "External ID", insert the desired tag for internal purposes (for example, to have the payouts to a specific destination marked with the same tag). This field is optional and it can be left blank.

8. In "Wallet tag", insert the unique numerical code, required by some blockchains, to pair with the deposit address, as an additional Security measure. This field is only visible for some assets and is required when transferring to a centralized exchange.

9. Click on the checkbox to set as "true" if you want the network fees to be paid by the end user:

   • If checked: The network fee amount is deducted from the inserted amount (the end user receives the amount minus the network fees).

     This is only possible for the native asset of the network and not for the tokens.

   • If unchecked: The network fees are added to the amount to pay for the payout operation.

10. The "Estimated network fee" displays the fee to pay based on your asset selection.

11. The "Processing fee" displays the fee to pay based on your Settlement selections.

12. The "Total estimated proceeds" displays the total amount to pay for the Settlement.

13. The "Estimated amount to be received" displays the amount that the user is expected to receive.

14. Click on the "Done" button to proceed (the button becomes clickable when all required fields are filled).

15. Confirm the action with your one-time (2FA) password.

16. The payout operation is created and displayed on the "Payouts" table.

Create a Mass Payout

1. Click on the "Mass payout" button:

   

2. The "Mass payout" card is displayed:

   

3. Insert the desired name to identify the mass payout operation.

4. Drag and drop or select the desired CSV file to add.

   The CSV file must comply with the expected template strcuture:

   • destination: Insert the desired address to move the crypto to.
   • amount: Insert the desired amount of crypto to transfer.
   • asset: Insert the desired cryptocurrency (or fiat) use on the payout.
   • treatedAsGrossAmount: Set to True if you want the network fees to be paid by the end user (The network fee amount is deducted from the inserted amount and the end user receives the amount minus the network fees) or False if you want to assume the network fees (the network fees are added to the amount to pay for the payout operation.)
   • externalID: Insert the desired Internal ID (from your own system) to better keep track of these operations.
   • requestedAmount: Insert the desired amount requested as payment in the selected asset (requested asset).
   • requestedAsset: Insert the desired asset in which the requested amount is set as payment.
   • walletTag: Insert the unique numerical code, required by some blockchains, to pair with the deposit address, as an additional Security measure. This field is only required by XRP and TON assets. If requestedAmount and requestedAsset are used, “amount” must remain empty.

   Note on network fees: These apply only to native assets. For example, ETH is the native asset of the Ethereum blockchain, while USDC and MATIC are tokens built on top of Ethereum. The targetAsGrossAmount setting only works with assets that are native to their respective networks, such as ETH, BTC, or BNB.

   To get the template file, click on the "use the template" link.

5. The file is displayed on the card and the "Delimiter" drop-down menu is displayed:

   

6. Select the columns delimiter, from the drop-down menu, on "Choose delimiter":

   

7. "Semicolon (;)" is set by default (Using the wrong delimeter fails the CSV upload).

8. Click on the Done button.

9. Confirm the action with your one-time (2FA) password.

10. The mass payout operation is created and displayed on the "Payouts" table with a notification in the bottom-left corner of the screen confirming the success of the mass payout creation:

    

11. Hover over the new entry row:

    

12. Click on the "Options" button:

    

13. Click on the "Details" button:

    

14. The entries on the mass payout list are displayed:

    

    The entries are displayed in the same rows order as the uploaded file. This way it's easier to track mistakes in the initial file.

15. The status is "uploaded" because it is waiting for approval to proceed.

16. Click on the "Approve" button of the desired entry to confirm:

    

17. You can click on "Approve all" to proceed with all entries:

    

18. Confirm the action with your one-time (2FA) password.

Validation of the address is done in ETH network (including tokens) and BTC network. It is cross-check validated that the asset specified in the upload file is a match with the address.

Example: If the asset USDT (Ethereum network) is specified and an invalid Ethereum address is provided an “invalid address error” is displayed.

Using Coinsflow Pay

1. Click on the "Coinsflow pay" button:

   

2. The Coinsflow pay card is displayed:

   

3. Select the desired asset to transfer (if it is not displayed already).

4. Insert the desired Coinsflow pay id to transfer the asset to.

5. Insert the desired amount of the selected asset to transfer to (click on the "All" button to transfer the total amount of the asset).

6. Click on the "Send" button to proceed.

7. Confirm the action with your one-time (2FA) password.

8. The inserted amount of the selected asset is transferred to the indicated project.

9. The operation is created and displayed on the Operations table, on the Operations tab, under the Outgoing transfer type (the recipient sees the same operation with the Incoming transfer type). The amount used on the pay operation is subtracted from the balance of the selected asset and the balance of that asset is updated on the Balances table on the Balances tab.