Create a rule

post/merchants/{merchantId}/splitConfigurations/{splitConfigurationId}

Creates a rule in the split configuration specified in the path.

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/{splitConfigurationId}
Click to copy

Path Parameters

splitConfigurationIdstringRequired

The unique identifier of the split configuration.

merchantIdstringRequired

The unique identifier of the merchant account.

Request Parameters

currencystringRequired

The currency condition that defines whether the split logic applies. Its value must be a three-character ISO currency code.

fundingSourcestring

The funding source condition of the payment method (only for cards).

Possible values: credit, debit, or ANY.

paymentMethodstringRequired

The payment method condition that defines whether the split logic applies.

Possible values:

  • Payment method variant: Apply the split logic for a specific payment method.
  • ANY: Apply the split logic for all available payment methods.
shopperInteractionstringRequired

The sales channel condition that defines whether the split logic applies.

Possible values:

  • Ecommerce: Online transactions where the cardholder is present.
  • ContAuth: Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer).
  • Moto: Mail-order and telephone-order transactions where the customer is in contact with the merchant via email or telephone.
  • POS: Point-of-sale transactions where the customer is physically present to make a payment using a secure payment terminal.
  • ANY: All sales channels.
splitLogicobjectRequired

Contains the split logic that is applied if the rule conditions are met.

Response parameters

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.

    Show moreShow less
  • 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.

    Show moreShow less
  • 401 - Unauthorized

    Authentication required.

    Show moreShow less
  • 403 - Forbidden

    Insufficient permissions to process the request.

    Show moreShow less
  • 422 - Unprocessable Entity

    A request validation error.

    Show moreShow less
  • 500 - Internal Server Error

    The server could not process the request.

    Show moreShow less