Indicador de iniciador de transacción

Para transacciones Mastercard, se envía un indicador a la red que identifica si la operación fue iniciada por el tarjetahabiente o por el comercio.

Orden de prioridad

Placetopay determina el indicador en este orden:

  1. Valor del comercio: si la solicitud de pago incluye un additional.initiatorIndicator válido, se utiliza sin modificaciones y tiene prioridad sobre la configuración del sitio.
  2. Configuración del sitio: si la solicitud omite el indicador o envía null, se utiliza el valor configurado en el sitio, cuando exista.
  3. Valor automático: si no envías un indicador ni tienes uno configurado en el sitio, Placetopay lo determina automáticamente.

Configurar un valor fijo por sitio

Utiliza data.integration.initiatorIndicator en los endpoints de Core para crear o actualizar sitios. El campo es opcional y admite cualquiera de los indicadores de la tabla siguiente. Los valores inválidos para el sitio se rechazan.

El siguiente fragmento configura un valor fijo al crear un sitio (/core/site/create) o actualizarlo (/core/site/update-all). Incluye los demás campos requeridos por el endpoint:

{
  "data": {
    "integration": {
      "initiatorIndicator": "MERCHANT_COF"
    }
  }
}

Al actualizar un sitio, omitir el campo conserva el valor actual. Envía null para quitar el valor fijo y volver al cálculo automático cuando el comercio no envíe el indicador:

{
  "data": {
    "integration": {
      "initiatorIndicator": null
    }
  }
}

Puedes consultar el valor configurado en integration.initiatorIndicator de la respuesta de búsqueda de sitios.

Por ejemplo, un sitio configurado con MERCHANT_COF utiliza CARDHOLDER_COF si la solicitud de pago envía explícitamente ese valor en additional.initiatorIndicator. Si lo omite, se utiliza el valor del sitio: MERCHANT_COF.

Valores admitidos

Indicador
Descripción
Ejemplo
CARDHOLDER_COF
El consumidor acepta almacenar la tarjeta en archivo con el comerciante para transacciones futuras o el consumidor elige utilizar una tarjeta previamente almacenada en archivo con el comerciante al realizar una compra.
El consumidor realiza una compra y el comerciante le solicita al consumidor almacenar la credencial en archivo para compras futuras iniciadas por el titular de la tarjeta.
CARDHOLDER_RECURRING_VARIABLE_AMOUNT
El consumidor acepta almacenar la tarjeta en archivo y realiza una primera transacción en una serie destinada a ser de monto variable y frecuencia fija.
La transacción inicial para almacenar la credencial en archivo para el pago mensual de servicios públicos.
CARDHOLDER_RECURRING_FIXED_AMOUNT
El consumidor acepta almacenar la credencial en archivo y realiza una primera transacción en una serie destinada a ser de un monto fijo y una frecuencia fija.
La transacción inicial para almacenar la credencial en archivo para un pago mensual.
CARDHOLDER_WITH_INSTALLMENTS
El consumidor acepta almacenar la credencial en archivo para establecer un plan de cuotas e inicia una primera transacción en una serie. El plan de cuotas debería reflejar la compra única de bienes/servicios con un monto conocido y una frecuencia establecida durante una duración especificada.
La transacción inicial para almacenar la credencial en archivo para una compra que se pagará a través de pagos a plazos financiada por el comercio. Para Colombia, debe ser enviado apenas en caso de financiamiento realizado por el propio comercio.
MERCHANT_COF
Una transacción realizada según un acuerdo entre un titular de tarjeta y un comerciante, mediante el cual el titular de la tarjeta autoriza al comerciante a almacenar y utilizar los datos de la cuenta del titular de la tarjeta para iniciar una o más transacciones futuras. La transacción puede ser de un monto fijo o variable, pero no ocurre en intervalos regulares en una fecha programada.
El consumidor acepta permitir a un comerciante realizar transacciones cuando el saldo en la cuenta del consumidor con el comerciante cae por debajo de un monto establecido (recarga automática).
MERCHANT_RECURRING_VARIABLE_AMOUNT
Una transacción realizada conforme a un acuerdo entre un titular de tarjeta y un comerciante, donde el comerciante utiliza los datos de la cuenta del titular de la tarjeta para una transacción que debe ocurrir en intervalos regularmente programados por un monto variable, según lo especificado en el acuerdo.
Pagos automaticos mensuales de servicios públicos.
MERCHANT_RECURRING_FIXED_AMOUNT
Una transacción realizada conforme a un acuerdo entre un titular de tarjeta y un comerciante, donde el comerciante utiliza los datos de la cuenta del titular de la tarjeta para una transacción que debe ocurrir en intervalos regularmente programados por un monto fijo, según lo especificado en el acuerdo. El acuerdo de suscripción puede incluir una disposición para precios introductorios o para que los cambios de precio ocurran de vez en cuando.
Pago mensual de suscripción o pago mensual por un servicio fijo.
MERCHANT_WITH_INSTALLMENTS
Una transacción en una serie de transacciones realizadas conforme a un acuerdo entre un titular de tarjeta y un comerciante, donde el titular de la tarjeta autoriza al comerciante a almacenar los datos de la cuenta del titular de la tarjeta para que el comerciante pueda iniciar una o más transacciones futuras por un monto conocido durante una duración especificada, basada en una sola compra.
Compra un televisor por 1,000 USD y paga en cuatro cuotas iguales de 250 USD cada una (la primera transacción el comercio envía CARDHOLDER_WITH_INSTALLMENTS y las tres transacciones restantes envía MERCHANT_WITH_INSTALLMENTS). Para Colombia, debe ser enviado apenas en caso de financiamiento realizado por el propio comercio.