1. Online Payments
Español
  • English
  • Español
  • Docs para desarrolladores 🇪🇨
  • Online Payments
    • Notas de versión
    • Errores del API de Kushki
    • Card Payments
      • Solicitar un token de tarjeta
      • Hacer un cargo o cargo diferido
      • Reembolsar una transacción
      • Anular una transacción
      • Solicitar opciones de diferido
      • Validar OTP
      • Información de BIN V2
      • Información de BIN
    • One Click and Scheduled Payments
      • Solicitar un token de cargo recurrente
      • Crear un cargo recurrente
      • Actualizar los datos de la tarjeta del cargo recurrente
      • Hacer un pago One-click
      • Cancelar un cargo recurrente
      • Actualizar un cargo recurrente
      • Agregar un cargo o descuento temporal
      • Consultar información del cargo recurrente
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • Cash in
      • Solicitar un token de Cash In
      • Iniciar transacción
      • Actualizar una transacción de Cash In
      • Estado de la transacción
      • Eliminar una transacción de Cash In
    • Transfer in
      • Solicitar un token de Transfer In
      • Iniciar transacción
      • Consultar estado
    • Analytics
      • Consultar listado de transacciones v2
    • Smartlinks
      • Crear un Smartlink
      • Actualizar un Smartlink
      • Consultar un Smartlink
      • Eliminar un Smartlink
    • Status
      • Consultar estado del gateway
      • Consultar estado de la plataforma
    • Commissions
      • Consultar configuración de comisiones
    • Payment Credentials
      • Crear una credencial
      • Buscar credenciales
      • Activar o desactivar
      • Eliminar credencial
      • Actualizar credencial
      • Regenerar una credencial
      • Búsqueda avanzada
    • Payment Button
      • Crear un Payment Button
    • Settlement
      • Consultar liquidación
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • threeDomainSecure
    • Card-old
    • Channel
    • SubscriptionTransactionsResponse
    • Card Present (CP)
    • Amount-cash-in
    • webhooks
    • ChargebackListResponse
    • StatusComponent
    • SettlementDateRangeRequest
    • Card
    • networkToken
    • ChargebackItem
    • SettlementRecord
    • Card Not Present (CNP)
    • currency
    • ErrorResponse
    • SubscriptionTransaction
    • Subscription
    • Amount
    • ErrorResponse400
    • SettlementResponse
    • Country
    • Deferred
    • extraTaxes
    • ErrorResponse401
    • Language
    • ErrorResponse403
    • Metadata
    • payment_method
    • ErrorResponse500
    • ContactDetails
    • orderDetails
    • Shipping Address
    • Billing-Address
    • payment_submethod
    • SubscriptionUpdate
    • documentType
    • SubscriptionAdjustmentRequest
    • threeDomainSecure
    • webhooks
    • headers
    • webhooksChargeback
    • citMit
    • network
    • binInfo
    • messageFields
    • UnexpectedErrorResponse
    • ExternalReferenceId
    • product
    • transactionType
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
  1. Online Payments

Comisiones

Calcula el monto de la comisión que se pagaría a un comercio receptor en el modo de recaudo Split Payment.
¡Ten en cuenta!
Este endpoint solo funciona cuando el modo Split Payment está habilitado para tu comercio. Split Payment está disponible solo bajo demanda: contacta a Kushki para activarlo.

Cómo funciona#

El modo Split Payment permite dividir una sola transacción entre dos receptores: el comercio principal y un comercio receptor de la comisión. Usa este endpoint antes de hacer el cargo para calcular qué parte de un totalAmount dado se asignaría al receptor de la comisión.
Total transaction amount
        │
        ├──► Main merchant (remainder)
        └──► Commission Recipient Merchant (calculated commission)

Solicitud#

Requiere tu Public Merchant ID como cabecera.
{
  "totalAmount": 100.00,
  "currency": "USD"
}
CampoRequeridoDescripción
totalAmount✅Monto total de la transacción sobre el que se calcula la comisión
currency✅Siempre USD para Ecuador

Respuesta#

{
  "commissionMerchantName": "Macro Wase",
  "parentMerchantName": "Fintech Global",
  "merchantId": "20000000103814066000",
  "totalAmount": 1.12,
  "amount": {
    "currency": "USD",
    "subtotalIva": 1.00,
    "subtotalIva0": 0,
    "iva": 0.12
  }
}
CampoDescripción
commissionMerchantNameNombre del comercio receptor de la comisión
parentMerchantNameNombre del comercio principal
merchantIdIdentificador del comercio receptor de la comisión
totalAmountMonto total de la comisión (impuestos incluidos)
amount.subtotalIvaSubtotal de la comisión sujeto a IVA
amount.subtotalIva0Subtotal de la comisión no sujeto a IVA
amount.ivaMonto de IVA aplicado a la comisión
amount.currencySiempre USD para Ecuador

Códigos de error#

CódigoMensajeCausa
COM004Id de comercio no válidoPublic-Merchant-Id inválido o no autorizado

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 valor total de transacción dado en el modo Split Payment.

¿Tienes una sugerencia sobre esta documentación? Escríbenos.
Modified at 2026-09-11 14:47:32
Previous
Consultar estado de la plataforma
Next
Consultar configuración de comisiones
Built with