Guía de integración Comisiones a terceros

18 diciembre 2024

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

var callback = function (response) {
  if(!response.code){
    console.log(response);
  } else {
    console.error('Error: ',response.error, 'Code: ', response.code, 'Message: ',response.message);
  }
};

  kushki.getCommissionConfiguration({
    totalAmount: 100, 
    currency:'USD'
  }, callback);

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 $100 de la venta + $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, la transacción deberá ser por $100 de la venta original mas $4 de la comisión ($104 en total). Así, el comercio principal recibirá $100 y el comercio destinatario de comisiones 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 $100 de la venta + $4 de comisión = $104).