Commissions - Kushki Developer Portal

La Commissions API te permite consultar la configuración de comisiones de tu cuenta de comercio en México 🇲🇽. Úsala para calcular el monto que se pagaría al comercio receptor de la comisión en una transacción determinada antes de iniciar el cargo.

Requiere Split Payment

Este endpoint solo funciona cuando el modo Split Payment está habilitado en tu cuenta. Split Payment permite dividir una sola transacción entre dos receptores: el comercio principal y el comercio receptor de la comisión. Contacta a Kushki para activarlo.

Cómo funciona

En el modo Split Payment, cada transacción se divide automáticamente:

Comercio principal — recibe el monto de la transacción menos la comisión

Comercio receptor de la comisión — recibe la parte de la comisión

Usa este endpoint para previsualizar el desglose de la comisión de un totalAmount determinado antes de enviar el cargo.

Consultar la configuración de comisiones

POST /commission/v1/configuration

Solicitud

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

Campo	Obligatorio	Descripción
`totalAmount`	✅	Monto total de la transacción en MXN
`currency`	✅	`MXN`

Respuesta

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

Campo	Descripción
`commissionMerchantName`	Nombre del comercio receptor de la comisión
`parentMerchantName`	Nombre del comercio principal
`merchantId`	Identificador Kushki del comercio receptor de la comisión
`totalAmount`	Monto total de la transacción
`amount.subtotalIva`	Subtotal de la comisión sujeto a IVA
`amount.subtotalIva0`	Subtotal de la comisión no sujeto a IVA
`amount.iva`	Monto de IVA aplicado a la comisión
`amount.currency`	`MXN`

Moneda

Moneda	Código	Notas
Peso mexicano	`MXN`	Dos decimales — los montos usan centavos (por ejemplo, `500.00`)

Autenticación

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Consultar la configuración de comisiones

Calcula el monto de la comisión para un total de transacción determinado. Requiere que el modo Split Payment esté habilitado.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Comisiones

Cómo funciona#

Consultar la configuración de comisiones#

Solicitud#

Respuesta#

Moneda#

Autenticación#

Uso de la API#

Endpoints disponibles#

Cómo funciona

Consultar la configuración de comisiones

Solicitud

Respuesta

Moneda

Autenticación

Uso de la API

Endpoints disponibles