> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Split payments on a platform

> Split each Checkout payment on your platform, set the merchant of record on every order, and let Dintero pay out the merchant share and your platform share.

Run a platform where many merchants use your software to sell under their own names. Dintero Split Payout lets you onboard merchants, set the merchant of record on each order, define how each payment is split, and automatically route funds to the right recipients after each transaction.

This is you if customers buy from the merchants on your platform, not from your platform, and each merchant is the merchant of record for its own sales. Your merchants go through a fuller KYC than marketplace sellers.

> [!TIP]
>
> Not quite right? If customers buy from your brand and you are the merchant of record, see [Split payments across sellers on a marketplace](https://docs.dintero.com/docs/checkout/use-cases/marketplace-split-payments.md). To compare the two models, see [Marketplace or platform](https://docs.dintero.com/docs/checkout/use-cases/marketplaces-and-platforms).

The customer sees a single checkout. Behind the scenes, Dintero splits the captured amount according to the rules you define in the session. The difference from a marketplace is that every session names the merchant of record.

```mermaid theme={null}
sequenceDiagram
    participant Customer as Customer
    participant Checkout as Checkout page
    participant API as Dintero API
    participant Platform as Platform
    participant Merchant as Merchant

    Platform->>API: Create session with split rules and merchant of record
    API->>Checkout: Display checkout
    Customer->>Checkout: Pay full amount
    Checkout->>API: Payment captured
    API->>Platform: Callback with transaction status
    API->>Merchant: Payout (split share)
    API->>Platform: Payout (platform share)
```

## 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](https://docs.dintero.com/docs/checkout/split-payment/activate-payout.md) 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](https://docs.dintero.com/docs/checkout/split-payment/add-payout-destinations.md) for both approaches.

**3. Create sessions with split rules and the merchant of record**

When creating a checkout session, add a `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:

```json theme={null}
{
  "order": {
    "store": {
      "id": "my-store-id",
      "payout_destination_id": "merchant"
    }
  }
}
```

See [Create a split session](https://docs.dintero.com/docs/checkout/split-payment/creating-split-session.md) for the payload structure, and [Platforms](https://docs.dintero.com/docs/checkout/split-payment/creating-split-session.md#platforms) for the merchant of record.

**4. Handle the payment result**

The callback tells you the payment is complete and includes the `transaction_id`. [Get the transaction](https://docs.dintero.com/api-reference/transactions/transactions_id_get.md) 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](https://docs.dintero.com/docs/checkout/split-payment/creating-split-session.md#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](https://docs.dintero.com/docs/checkout/split-payment/split-reports.md) for report formats, and [Fund transfer](https://docs.dintero.com/docs/checkout/split-payment/fund-transfer.md) 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](https://docs.dintero.com/docs/checkout/split-payment/testing-split-payments.md) for test scenarios.

## What's next

> [card] [Split Payout overview](https://docs.dintero.com/docs/checkout/split-payment/split-overview.md)
>
> How split payouts work and the steps to get started.

> [card] [Activate payout](https://docs.dintero.com/docs/checkout/split-payment/activate-payout.md)
>
> Enable Dintero Payout on your account.

> [card] [Add payout destinations](https://docs.dintero.com/docs/checkout/split-payment/add-payout-destinations.md)
>
> Onboard merchants and create payout destinations.

> [card] [Create a split session](https://docs.dintero.com/docs/checkout/split-payment/creating-split-session.md)
>
> Build a session with split payment rules and the merchant of record.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.