How do I upload a payout batch?

Published: [September 8, 2026] · Last updated: [September 21, 2026] · Author: [Admin]

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 MethodSupported
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.

StatusDescription
UploadedBatch successfully received
ValidatingData integrity and required information are being verified
Compliance ReviewCompliance and risk controls are being performed
ProcessingPayouts are being prepared for execution
SubmittedTransactions have been broadcast to the blockchain
CompletedAll payouts processed successfully
Partially CompletedOne or more payouts require additional attention
FailedBatch 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
● Payout Reconciliation

Last Updated

August 2026