Modificadores de transacción

Los modificadores de transacción son configuraciones a nivel de sitio que intervienen en el flujo de una transacción según el tipo de modificador definido. Actualmente, solo está disponible la opción "Tarifa".

Modificador tipo tarifa

Este tipo de modificador de transacción aplica una tarifa o comisión adicional al costo original de la transacción solicitada según las configuraciones definidas. Este modificador solo se aplica a medios de pago que soportan dispersión, ya que el cobro se efectúa mediante una dispersión al sitio o acuerdo configurado en el modificador de transacción.

Configuraciones del modificador de tipo tarifa

• Acuerdo: Identificador del sitio al que se enviará la comisión correspondiente al costo de la transacción.
• Monto Fijo: Valor fijo de la comisión que se añadirá al costo de la transacción original.
• Porcentaje del Monto: Porcentaje que se añadirá a la tarifa calculada en base de la transacción original.
• Aplica Impuesto: Define si el IVA será aplicado al costo adicional generado por la transacción.

¿Cómo se integra?

El modificador de transacción tipo tarifa es soportado a través de nuestra API Web Checkout, que permite integrar diversos medios de pago y tipos de pago compatibles con este modificador.

¿Cómo se calcula la tarifa de una transacción?

El cálculo de la tarifa se realiza considerando la moneda configurada en el sitio o sitios asociados al modificador de transacción tipo tarifa. Antes de realizar el cálculo, se validan las monedas de la petición y la del sitio configurado con el modificador. Por ejemplo, si la moneda del sitio es USD y no coincide con la moneda de la petición COP, se realizará la conversión del Monto Fijo configurado de USD a COP, utilizando la tasa de conversión vigente al momento de la petición.

Una vez validadas las monedas, se desglosa la comisión calculada en función del monto original de la transacción en los campos adicionales de la petición original enviada por el sitio. Estos campos incluyen Subtotal, Costo de la transacción, y, si el modificador de transacción tiene habilitada la opción Aplica Impuesto, también se añadirá IVA del costo de la transacción. Estas descripciones no soportan cambio de idioma y se crean en base al idioma enviado en la primera petición del sitio.

Ejemplos de aplicación del modificador de transacción tipo tarifa

Pagos Básicos
Los pagos básicos se modifican y se convierten en un pago con dispersión. La dispersión número uno contiene el monto original de la petición del sitio, mientras que la dispersión número dos incluye los costos de la transacción más el impuesto correspondiente del modificador de transacción configurado.

• Monto Fijo: 0.35
• Porcentaje Monto: 5%
• Aplica Impuesto: Sí (10% se obtiene del impuesto configurado en el sitio)

Petición original del sitio:

{
  ...
  "payment": {
      "reference": "test_basic_payment",
      "description": "basic_payment",
      "amount": { "currency": "USD", "total": 100 },
       ...
    },
  ...
}

Resultado de petición con la aplicación de un modificador de transacción:

{
  ...
  "payment": {
      "reference": "test_basic_payment",
      "description": "basic_payment",
      "amount": { "currency": "USD", "total": 105.89 },
      "dispersion": [ 
        {
          "agreement": 1 // identificador del sitio que realiza la petición.
          "agreementType": "MERCHANT",
          "amount": { "currency": "USD", "total": 100 }  
        },
        {
          "agreement": 14 // acuerdo configurado del sitio que realizó la solicitud.
          "agreementType": "MERCHANT",
          "amount": { "currency": "USD", "total": 5.89 }  
        }
      ],
      "fields": [
          {"value": "US$ 100,00", "keyword": "Subtotal", "displayOn": "both"},
          {"value": "US$ 5,35", "keyword": "Costo de la transacción'", "displayOn": "both"},
          {"value": "US$ 0,54", "keyword": "IVA del costo de la transacción", "displayOn": "both"},
        ]
       ...
    },
  ...
}

Pagos parciales
Los pagos parciales no soportan pagos con dispersión de forma directa. Para aplicar los modificadores de transacción, se deshabilita la opción de realizar pagos parciales y se emplea el mismo comportamiento utilizado previamente en los pagos básicos.

Pagos con dispersiones
Para los pagos con dispersión se agregará una dispersión adicional a las enviadas originalmente en la petición del sitio.

Cada dispersión está vinculada a un acuerdo (agreement) que contiene un modificador de transacción configurado. Este se aplicará al monto base de cada dispersión, y la suma total de estas comisiones se reflejará en la nueva dispersión de la transacción.

Para este caso todos los acuerdos(agreement) de las dispersiones tienen configurado las mismas propiedades.

• Monto Fijo: 0.35
• Porcentaje Monto: 5%
• Aplica Impuesto: Cuando (10% se obtiene del impuesto configurado en el sitio)

Petición original del sitio con dos dispersiones:

{
  ...
  "payment": {
      "reference": "test_dispersion_payment",
      "description": "disperion_payment",
      "amount": { "currency": "USD", "total": 100 },
      "dispersion": [ 
        {
          "agreement": 1,
          "agreementType": "MERCHANT",
          "amount": { "currency": "USD", "total": 50 }  
        },
        {
          "agreement": 2,
          "agreementType": "MERCHANT",
          "amount": {  "currency": "USD", "total": 25 }  
        },
        {
          "agreement": 3,
          "agreementType": "MERCHANT",
          "amount": {  "currency": "USD", "total": 25 }  
        }
      ]
    },
  ...
}

Resultado de petición con la aplicación de un modificador de transacción:

{
  ...
  "payment": {
      "reference": "test_dispersion_payment",
      "description": "disperion_payment",
      "amount": { "currency": "USD", "total":  113.15 },
      "dispersion": [ 
        {
          "agreement": 1
          "agreementType": "MERCHANT",
          "amount": { "currency": "USD", "total": 50 }  
        },
        {
          "agreement": 2
          "agreementType": "MERCHANT",
          "amount": {  "currency": "USD", "total": 25 }  
        },
        {
          "agreement": 3,
          "agreementType": "MERCHANT",
          "amount": {  "currency": "USD", "total": 25 }  
        }
        {
          "agreement": 14 // acuerdo configurado del sitio que realizó la solicitud.
          "agreementType": "MERCHANT",
          "amount": {  "currency": "USD", "total": 13.15 }  
        }
      ],
      "fields": [
          {"value": "US$ 100,00", "keyword": "Subtotal", "displayOn": "both"},
          {"value": "US$ 11,05", "keyword": "Costo de la transacción'", "displayOn": "both"},
          {"value": "US$ 2,10", "keyword": "IVA del costo de la transacción", "displayOn": "both"},
        ]
    },
  ...
}

FAQs