Skip to main content

Create a split configuration profile

post/merchants/{merchantId}/splitConfigurations

Creates a split configuration profile to split payments automatically. After you associate it with a store in your merchant account, it splits the funds of all transactions processed through that store between your liable balance account and your user's balance account.

To make this request, your API credential must have the following role:

  • Management API - SplitConfiguration read and write
Endpoint destination URL
https://management-test.adyen.com/v3/merchants/{merchantId}/splitConfigurations
Click to copy
merchantIdstringRequired

The unique identifier of the merchant account.

descriptionstringRequired
Max length: 300

Your description for the split configuration.

rulesarray[object]Required

Array of rules that define the split configuration behavior.

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

  • 200 - OK

    The request has succeeded.

  • 204 - No Content

    The request has been successfully processed, but there is no additional content.

  • 400 - Bad Request

    A problem reading or understanding the request.

  • 401 - Unauthorized

    Authentication required.

  • 403 - Forbidden

    Insufficient permissions to process the request.

  • 422 - Unprocessable Entity

    A request validation error.

  • 500 - Internal Server Error

    The server could not process the request.