Commission Update Endpoint

Learn how to update your commissions associated to your SubMerchants.

Update your Commission on a specific SubMerchant

PUT https://api-stg.directa24.com/v3/sub_merchant/{sub_merchant_id}/markup_fee

Path Parameters

Name	Type	Description
sub_merchant_id	int	ID of the SubMerchant

Request Body

Name	Type	Description
fee	decimal	New commission associated to the SubMerchant.

200: OK The commission was updated successfully.

400: Bad Request The commission update request was incorrectly requested.

{
    "code": 423,
    "description": "Invalid subMerchant {integer} for merchant {integer}",
    "type": "INVALID_SUBMERCHANT"
}

{
    "code": 424,
    "description": "Invalid fee value: {0}",
    "type": "INVALID_FEE_VALUE"
}

Our solution for Platforms allows to associate a different commission for each SubMerchant, called markup_fee. This endpoint allows Platforms to perform Commission updates for a specific SubMerchant.

The default value of the markup_fee will be set by your Account Manager.

You can also manually update your SubMerchant's markup_fee by logging into our Merchant Panel, going into the section Referred merchants, finding the desired SubMerchant and clicking on the ✏️ Edit button.

Example Request

With the Commission Update Endpoint you can request a markup_fee modification whenever you want.

JSON

{
    "markup_fee": 2.00
}

cURL

curl --location --request PUT 'https://api-stg.directa24.com/v3/sub_merchants/18703/markup_fee' \
--header 'X-Login: xxxxxxx' \
--header 'X-Date: 2020-06-24T17:13:21Z' \
--header 'Authorization: D24 e339247fb57b10c053159cf87d3a88415f9be567beb46a93f6839d9fc45d2c8a' \
--data-raw '{
    "markup_fee" : 2.00
    }'

Request fields

Fields	Format	Description
markup_fee	decimal	New Commission value that will be charged in transactions of the SubMerchant specified in the URL path.