---
title: "Create an Intent Split"
method: POST
path: "/v3.0/{ClientId}/payins/intents/{IntentId}/splits"
tags: ["Intents"]
---

# Create an Intent Split

`POST /v3.0/{ClientId}/payins/intents/{IntentId}/splits`

Create a transfer to the wallet of the seller of an Intent line item.

Once the Intent is `PARTIALLY_CAPTURED` or `CAPTURED`, you can create Splits to set up the transfers to the seller wallet(s).

## Path parameters

- `ClientId` string, required
- `IntentId` string, required

## Headers

- `Authorization` string, required

## Request body

- CreateAnIntentSplitRequest
  - `Splits` CreateAnIntentSplitRequestSplitsItems[] — The future Splits to create to transfer Intent funds to the line item sellers.
    - `LineItemId` string, required — The unique identifier of the line item.
    - `SplitAmount` integer, required — The amount to transfer to the seller's `WalledId`. The sum of the `SplitAmount` values of all `Splits` must be lower than or equal to the `AvailableAmountToSplit` of the Intent.
    - `FeesAmount` integer — The amount of fees. The sum of the `FeesAmount` values of all `Splits` must be lower than or equal to the `PlatformFeesAmount` of the Intent.
    - `TransferDate` integer — The future date when the funds are to be automatically transferred to the seller's wallet.
    - `Description` string — The description of the Split.
    - `SplitOriginWalletId` string — The unique identifier of the wallet from which the split will be debited. This parameter is required for Intents where `ExternalProviderName` is `Mangopay`. If it is not defined in the Intent it must be defined at Split creation.
    - `Tag` string — Max. length: 255 characters Custom data that you can add to this object.

## Response `200`

Success

- IntentSplitsResponse
  - `Splits` IntentSplitsResponseSplitsItems[] — The Splits requested.
    - `Id` string — The unique identifier of the Split.
    - `LineItemId` string — The unique identifier of the line item.
    - `SellerId` string — The unique identifier of the seller of the line item.
    - `WalletId` string — The unique identifier of the wallet to credit the seller's funds.
    - `SplitAmount` integer — The amount to transfer to the seller's `WalledId`. The sum of the `SplitAmount` values of all `Splits` must be lower than or equal to the `AvailableAmountToSplit` of the Intent.
    - `FeesAmount` integer — The amount of fees. The sum of the `FeesAmount` values of all `Splits` must be lower than or equal to the `PlatformFeesAmount` of the Intent.
    - `TransferDate` integer — The future date when the funds are to be automatically transferred to the seller's wallet.
    - `Description` string — The description of the Split.
    - `Status` string — The status of the Split: - `CREATED` - `PENDING_FUNDS_RECEPTION` - `AVAILABLE` - `PENDING` - `COMPLETED` - `REJECTED` - `FAILED` - `REVERSED` - `REFUND_SPLIT_PENDING` - `REFUND_SPLIT_REJECTED` - `REFUND_SPLIT_COMPLETED`
    - `SplitOriginWalletId` string — The unique identifier of the wallet from which the split will be debited. This parameter is required for Intents where `ExternalProviderName` is `Mangopay`. If it is not defined in the Intent it must be defined at Split creation.
    - `Tag` string — Max. length: 255 characters Custom data that you can add to this object.

## Other responses

- `400` — Bad Request

## Changes

- **2026-07-26** `795281070285` — 2 info
  - added the new optional request property `Splits/items/Tag`
  - added the optional property `Splits/items/Tag` to the response with the `200` status

[Change history](https://skmtc.dev/mangopay/apis/api-reference/changes/v3.0/:ClientId/payins/intents/:IntentId/splits/post.md)

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/956211a94070/schema)