Commissions

Calculate the commission amount that would be paid to a recipient merchant under the Split Payment collection mode.

Keep in mind!

This endpoint only works when Split Payment mode is enabled for your merchant. Split Payment is available on-demand only — contact Kushki to activate it.

How It Works

The Split Payment mode allows dividing a single transaction into two recipients: the main merchant and a Commission Recipient Merchant. Use this endpoint before charging to calculate how much of a given totalAmount would be allocated to the commission recipient.

Total transaction amount
        │
        ├──► Main merchant (remainder)
        └──► Commission Recipient Merchant (calculated commission)

Request

Requires your Public Merchant ID as a header.

{
  "totalAmount": 100.00,
  "currency": "USD"
}

Field	Required	Description
`totalAmount`	✅	Total transaction amount to calculate the commission from
`currency`	✅	Always `USD` for Ecuador

Response

{
  "commissionMerchantName": "Macro Wase",
  "parentMerchantName": "Fintech Global",
  "merchantId": "20000000103814066000",
  "totalAmount": 1.12,
  "amount": {
    "currency": "USD",
    "subtotalIva": 1.00,
    "subtotalIva0": 0,
    "iva": 0.12
  }
}

Field	Description
`commissionMerchantName`	Name of the Commission Recipient Merchant
`parentMerchantName`	Name of the main merchant
`merchantId`	Identifier of the Commission Recipient Merchant
`totalAmount`	Total commission amount (including taxes)
`amount.subtotalIva`	Commission subtotal subject to VAT
`amount.subtotalIva0`	Commission subtotal not subject to VAT
`amount.iva`	VAT amount applied to the commission
`amount.currency`	Always `USD` for Ecuador

Error Codes

Code	Message	Cause
`COM004`	Id de comercio no válido	Invalid or unauthorized `Public-Merchant-Id`

Using the API

🟢 Production

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Available Endpoints

Get Commission Configuration

Calculates the commission amount for a given total transaction value under Split Payment mode.

Got a suggestion on this documentation? Contact us.

How It Works#

Request#

Response#

Error Codes#

Using the API#

Available Endpoints#

How It Works

Request

Response

Error Codes

Using the API

Available Endpoints