Guides
Settlements
Settlements allow you to batch multiple transactions and transfer funds to your bank account in a single operation.
Overview
Settlements group multiple completed payments together and calculate fees, allowing you to receive funds in batches rather than individual transactions.
How Settlements Work
- Select Transactions - Choose completed payments to include in the settlement
- Calculate Fees - One2Pays calculates fees based on your fee configuration
- Create Settlement - Settlement is created with calculated totals
- Process Settlement - Settlement is processed and funds are transferred to your bank account
- Receive Webhook - You receive a webhook notification when settlement is completed
Settlement Statuses
pending- Settlement is pending approvalapproved- Settlement has been approvedprocessing- Settlement is being processedcompleted- Settlement completed successfullyrejected- Settlement was rejectedfailed- Settlement processing failed
Settlement Status Flow
Settlement Components
A settlement includes:
- Total Amount - Sum of all transaction amounts
- Fee Amount - Total fees calculated
- Net Amount - Amount you'll receive (total - fees)
- Transaction Count - Number of transactions included
- Settlement Date - Date the settlement is processed
Creating Settlements
Settlements are typically created through the merchant dashboard, but you can also create them programmatically via the API.
Settlements are usually managed through the merchant dashboard for better visibility and control. API access may be available for advanced use cases.
Settlement Schedule
Settlements can be:
- Manual - Created on-demand when you choose
- Automatic - Scheduled to run daily, weekly, or monthly
- Threshold-based - Triggered when a certain amount is reached
Fee Calculation
Fees are calculated based on:
- Payment Method - Different methods may have different fee rates
- Integration - Fee configuration per integration
- Merchant - Merchant-level fee overrides
Best Practices
- Review settlements regularly - Check settlement details before processing
- Monitor settlement status - Use webhooks to track settlement progress
- Understand fee structure - Know how fees are calculated for your account
- Keep bank account updated - Ensure settlement bank account is current
- Reconcile settlements - Match settlements with your accounting records