Commissions

The Commissions API lets you query the commission configuration for your merchant account in Mexico 🇲🇽. Use it to calculate the amount that would be paid to a Commission Recipient Merchant on a given transaction before initiating a charge.

Split Payment required

This endpoint only works when Split Payment mode is enabled on your account. Split Payment allows dividing one transaction between two recipients: the main merchant and the Commission Recipient Merchant. Contact Kushki to enable this feature.

How it works

In Split Payment mode, each transaction is automatically split:

Main merchant — receives the transaction amount minus the commission

Commission Recipient Merchant — receives the commission portion

Use this endpoint to preview the commission breakdown for a given totalAmount before submitting a charge.

Get commission configuration

POST /commission/v1/configuration

Request

{
  "totalAmount": 500,
  "currency": "MXN"
}

Field	Required	Description
`totalAmount`	✅	The total transaction amount in MXN
`currency`	✅	`MXN`

Response

{
  "commissionMerchantName": "Macro Wase",
  "parentMerchantName": "Mi Comercio México",
  "merchantId": "20000000103802320000",
  "totalAmount": 500,
  "amount": {
    "currency": "MXN",
    "subtotalIva": 1,
    "subtotalIva0": 0,
    "iva": 0.12
  }
}

Field	Description
`commissionMerchantName`	Name of the Commission Recipient Merchant
`parentMerchantName`	Name of the main merchant
`merchantId`	Kushki ID of the Commission Recipient Merchant
`totalAmount`	Total amount of the transaction
`amount.subtotalIva`	Commission subtotal subject to VAT
`amount.subtotalIva0`	Commission subtotal exempt from VAT
`amount.iva`	VAT amount on the commission
`amount.currency`	`MXN`

Currency

Currency	Code	Notes
Mexican Peso	`MXN`	Two decimal places — amounts use cents (e.g., `500.00`)

Authentication

Using the API

🟢 Production

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Available Endpoints

Get Commission Configuration

Calculate the commission amount for a given transaction total. Requires Split Payment mode to be enabled.

Got a suggestion on this documentation? Contact us.

How it works#

Get commission configuration#

Request#

Response#

Currency#

Authentication#

Using the API#

Available Endpoints#