Guía de integración Comisiones a terceros

Producto en versión beta 🔐👨‍

Estamos trabajando en nuestra versión beta. ¡Manténte atento a su lanzamiento oficial! También puedes contactar a tu gerente de cuenta para más información.

Habilita Comisiones a terceros en tu comercio

Para habilitar la modalidad de Comisiones a terceros en tu comercio, es necesario enviar una solicitud a través de nuestro centro de soporte con la siguiente información:

Correo electrónico

ID o Nombre de Comercio

¿Cómo podemos ayudarte? (Otro)

Impacto de negocio (Limitado)

Asunto (Habilitación de la modalidad Comisiones a terceros)

Descripción (Agregar información detallada de lo que se requiere)

País

Una vez enviado el formulario, es necesario esperar la confirmación de que la modalidad ha quedado correctamente habilitada.

Realiza la integración para aceptar Comisiones a terceros

En caso de que ya tengas lista tu integración con Kajita o Kushki.js, puedes omitir este paso.

Para hacer uso de la modalidad Comisiones a terceros, es necesario integrar nuestras soluciones de frontend (Kajita o Kushki.js) y enlazarlos a tu backend. Para ello, puedes revisar nuestra guía Acepta un pago con tarjeta.

Revisa tu configuración de Comisiones a terceros

Valida si tienes el servicio activo y obtén la información relacionada con el cargo de comisiones configurado en tu comercio con el método getCommissionConfiguration en Kushki.js y con el endpoint Get Commission Configuration de nuestra API. Es necesario integrar cualquiera de estas opciones de acuerdo al tipo de integración que realices para poder mostrar un desglose al usuario final con los montos a cobrar.

Método getCommissionConfiguration() en Kushki.js

Valida la información configurada en tu comercio y muestra un desglose para Comisiones a terceros consultando el método getCommissionConfiguration de Kushki.js en caso de que hayas implementado la librería kushki.js. A continuación podrás ver un ejemplo:

Solicitud

Parametros requeridos

totalAmount: Envía el monto del que quieres saber cuál será la comisión cobrada (por ejemplo $100)

currency: Envía la moneda configurada en tu comercio

Respuesta

Una vez consumido el método getCommissionConfiguration, se retornará una respuesta similar a la siguiente

{
    "commissionMerchantName": "Comercio comisiones",
    "parentMerchantName": "Fintech Global",
    "amount": {
        "currency": "USD",
        "iva": 0,
        "subtotalIva": 4,
        "subtotalIva0": 0
    },
    "merchantId": "20000000103814111000",
    "totalAmount": 4
}

Donde

commissionMerchantName: Es el nombre del comercio que recibirá la comisión

parentMerchantName: Es el nombre del comercio principal

amount: El objeto amount indica el monto de la comisión según las reglas configuradas en el comercio principal

merchantId: Corresponde al ID del comercio que recibirá la comisión

totalAmount: Es el monto total que se cobrará de comisión y el cuál se deberá sumar al monto original (en el ejemplo anterior 4 de comisión = $104)

Por ejemplo, si el comercio principal tiene una configuración del 4% por transacción, si se hace una transacción por 100 de la venta original mas 104 en total). Así, el comercio principal recibirá 4, que corresponde a la cantidad que nos regresa el campo totalAmount.

Endpoint Get Commission Configuration a través de API

Es necesario consumir el endpoint Get Commission Configuration de nuestra API Online payments para obtener la información configurada en tu comercio para Comisiones a terceros así como la comisión que se debe cobrar para mostrar el desglose al cliente final en la pantalla de pago. A continuación podrás ver un ejemplo:

Solicitud

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

Respuesta

{
    "commissionMerchantName": "Comercio comisiones",
    "parentMerchantName": "Fintech Global",
    "amount": {
        "currency": "USD",
        "iva": 0,
        "subtotalIva": 4,
        "subtotalIva0": 0
    },
    "merchantId": "20000000103814111000",
    "totalAmount": 4
}

Donde

commissionMerchantName: Es el nombre del comercio que recibirá la comisión

parentMerchantName: Es el nombre del comercio principal

amount: El objeto amount indica el monto de la comisión según las reglas configuradas en el comercio principal

merchantId: Corresponde al ID del comercio que recibirá la comisión

totalAmount: Es el monto total que se cobrará de comisión y el cuál deberás sumar al monto original (en el ejemplo anterior 4 de comisión = $104).

Consideraciones sobre voids en comisiones a terceros

Al usar la funcionalidad de comisiones (split payments), el comportamiento del void varía según el tipo de reverso que se realice:

Void total: Se reversa tanto el monto de la transacción como el valor de la comisión.

Void parcial: Solo se reversa el monto de la transacción. El valor de la comisión no se reversa.

Este comportamiento es importante para evitar inconsistencias contables o errores en la conciliación. Asegúrate de evaluar si el reverso debe incluir también la comisión y, de ser así, realiza un void total.

Guía de integración Comisiones a terceros

Habilita Comisiones a terceros en tu comercio#

Realiza la integración para aceptar Comisiones a terceros#

Revisa tu configuración de Comisiones a terceros#

Método getCommissionConfiguration() en Kushki.js#

Endpoint Get Commission Configuration a través de API#

Consideraciones sobre voids en comisiones a terceros#

Habilita Comisiones a terceros en tu comercio

Realiza la integración para aceptar Comisiones a terceros

Revisa tu configuración de Comisiones a terceros

Método getCommissionConfiguration() en Kushki.js

Endpoint Get Commission Configuration a través de API

Consideraciones sobre voids en comisiones a terceros