How do I upload a payout batch?

Introduction

Smart Bulk Payments allows businesses to submit bulk crypto payouts using either CSV file
uploads or API integration.
Both methods follow the same validation, compliance and processing workflow, allowing
organizations to automate high-volume crypto payouts while maintaining operational
consistency.
Smart Bulk Payments currently supports up to 10,000 recipients per payout batch.

This information is current as of August 2026.

Which upload methods are supported?

Upload Method Supported
CSV Upload ✓
API Integration ✓
Organizations may begin with manual CSV uploads and later migrate to API integration without
changing their operational workflow.

What information is required in a payout batch?

Each payout instruction contains the information necessary to process a crypto payout and
perform the required compliance and validation checks.
Typical payout information includes:
● Recipient information
● Wallet address
● Payout amount
● Internal payment reference
● Asset to be transferred
● Compliance information required for processing
The exact technical specification is provided during customer onboarding and API
implementation.

Maximum Batch Size

Smart Bulk Payments currently supports:

Up to 10,000 recipients per payout batch.
Organizations processing larger payment runs may split recipients across multiple batches.

Batch Validation

Every payout batch is validated before processing begins.
Validation includes:
● Required information is present
● Wallet address format verification
● Duplicate payment reference detection
● Asset validation
● Compliance screening
● Data integrity checks
Processing begins only after the validation stage has successfully completed.

Batch Processing Workflow

Every payout batch follows the same operational workflow.
Batch Submitted

Validation

Compliance Screening

Batch Processing

Blockchain Submission

Confirmation

Completed

Batch Status

Throughout processing, each batch progresses through a series of statuses.
Status Description
Uploaded Batch successfully received
Validating Data integrity and required information are being verified
Compliance Review Compliance and risk controls are being performed
Processing Payouts are being prepared for execution
Submitted Transactions have been broadcast to the blockchain
Completed All payouts processed successfully
Partially Completed One or more payouts require additional attention
Failed Batch could not be processed

What happens if validation detects errors?

If validation identifies one or more issues, the affected payout instructions must be corrected
before they can be processed.
Validation errors may include:
● Missing required information
● Invalid wallet address
● Unsupported asset
● Duplicate payment reference
● Invalid recipient information
Correcting validation issues before processing helps reduce operational delays and failed
payouts.

Batch Tracking

Every successfully accepted batch receives a unique batch identifier.
Organizations can use this identifier to:
● Monitor processing progress
● Review payout status
● Reconcile completed payouts
● Investigate failed transactions
● Support operational reporting

Security

Only authenticated business customers can submit payout batches.
All submitted batches are processed through Smart Bulk Payments validation, compliance
screening and operational controls before execution.

Best Practices

To improve processing efficiency:
● Validate recipient information before submission.
● Ensure wallet addresses are accurate.
● Use unique payment references.
● Submit supported digital assets only.
● Monitor batch status after submission.
● Correct validation errors before resubmitting a batch.

Frequently Asked Questions

How many recipients can one payout batch contain?

Smart Bulk Payments currently supports up to 10,000 recipients per batch.

Which upload methods are available?

Organizations can submit payout batches using CSV uploads or API integration.

Can I start with CSV and later integrate the API?

Yes.
Many organizations begin with CSV uploads before moving to full API integration.

What happens if a payout fails validation?

The affected payout instruction must be corrected before it can be processed.

Can I monitor the progress of a batch?

Yes.
Every accepted batch receives a unique identifier that can be used to monitor processing and
review payout status.

Does Smart Bulk Payments validate payout information?

Yes.
Every payout batch is validated before processing begins to help ensure successful execution
and compliance.

Related Documentation

● Supported Assets & Networks
● Settlement & Execution Times
● Compliance & Onboarding
● How to Upload a Payout Batch
● Payout Reconciliation

Last Updated

August 2026