Update an Intent Split

Modify a Split before execution.

PUT /v3.0/{ClientId}/payins/intents/{IntentId}/splits/{SplitId}

{
    "LineItemId": "int_li_019778b4-7e87-7153-8fa0-746b23ecae7e",
    "SplitAmount": 6000,
    "FeesAmount": 60,
    "TransferDate": 1752439988,
    "Description": "Example description of the Split"
}

{
    "Splits": [
        {
            "Id": "int_split_019778c4-29c7-7c62-b7c6-775b744ab9f2",
            "LineItemId": "int_li_019778b4-7e87-7153-8fa0-746b23ecae7e",
            "SellerId": "user_m_01JXWB53KC8ZZFQNC6S34W9CN0",
            "WalletId": "wlt_m_01JXWB5WF962GM9N4GC3VJVK8K",
            "SplitAmount": 6000,
            "FeesAmount": 60,
            "TransferDate": 1742428800,
            "Description": "Example description of the Split",
            "Status": "CREATED"
        }
    ]
}

Note – Split Status values that allow modification

To modify a split, its Status must be:

• CREATED
• PENDING_FUNDS_RECEPTION
• AVAILABLE
• FAILED

Path parameters

IntentId · string · required

The unique identifier of the Intent.

SplitId · string · required

The unique identifier of the Split.

Body parameters

Splits · array (object)

The future Splits to create to transfer Intent funds to the line item sellers.

Show child attributes

LineItemId · string · required

The unique identifier of the line item.

SplitAmount · type · 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 · string

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 · Unix timestamp

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.

Responses

200 - Response parameters

Splits · array (object)

The Splits requested.

Show child attributes

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 · type

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 · string

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 · Unix timestamp

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.

{
    "Splits": [
        {
            "Id": "int_split_019778c4-29c7-7c62-b7c6-775b744ab9f2",
            "LineItemId": "int_li_019778b4-7e87-7153-8fa0-746b23ecae7e",
            "SellerId": "user_m_01JXWB53KC8ZZFQNC6S34W9CN0",
            "WalletId": "wlt_m_01JXWB5WF962GM9N4GC3VJVK8K",
            "SplitAmount": 6000,
            "FeesAmount": 60,
            "TransferDate": 1742428800,
            "Description": "Example description of the Split",
            "Status": "CREATED"
        }
    ]
}

{
    "LineItemId": "int_li_019778b4-7e87-7153-8fa0-746b23ecae7e",
    "SplitAmount": 6000,
    "FeesAmount": 60,
    "TransferDate": 1752439988,
    "Description": "Example description of the Split"
}