Integration steps
1
Activate Dintero Payout
Enable Dintero Payout on your account. This is the underlying service that handles fund distribution to multiple recipients.See Activate payout for the activation process.
2
Onboard merchants as payout destinations
Each merchant on your platform needs to be registered as a payout destination. This involves collecting their business details and completing KYC (Know Your Customer) verification through Dintero.You can onboard merchants through Backoffice or programmatically via the management API.See Add payout destinations for both approaches.
3
Create sessions with split rules and the merchant of record
When creating a checkout session, add a See Create a split session for the payload structure, and Platforms for the merchant of record.
splits array to each item in order.items to define how the payment is distributed. Each split specifies a payout_destination_id and the amount that recipient should receive.Every order must also set the merchant of record. Set order.store.payout_destination_id to the payout destination of the merchant who makes the sale:4
Handle the payment result
The callback tells you the payment is complete and includes the
transaction_id. Get the transaction with that ID to check its status and splits. Capture the transaction when the order is ready to ship, and Dintero distributes the funds to each merchant’s payout destination.Refunds are also split. A full refund uses the splits defined in the session. For a partial refund, include the items and their splits in the refund request, which also lets you allocate the refund differently, for example so that one party covers the entire refund. See Capture and refund.5
Monitor settlements and reports
Track payouts to each merchant through settlement reports. You can view reports per payout destination to reconcile what each merchant has been paid.See Split reports for report formats, and Fund transfer for manual transfers between destinations.
6
Test the integration
Use your sandbox account (
T prefix) to verify that split rules and the merchant of record are applied correctly. Create sessions with multiple payout destinations and confirm the split amounts in the transaction details.See Testing split payments for test scenarios.What’s next
Split Payout overview
How split payouts work and the steps to get started.
Activate payout
Enable Dintero Payout on your account.
Add payout destinations
Onboard merchants and create payout destinations.
Create a split session
Build a session with split payment rules and the merchant of record.