Tipos de transacciones

Autorización

Una autorización hace referencia al proceso que se ejecuta luego de que el usuario ingresa la información solicitada y ésta es enviada a la red para realizar el cobro.

Pago Recurrente

Es un cobro periódico realizado por PlacetoPay para un mismo valor con un intervalo (diario, mensual, anual) según la indicación dada en la petición.

Para hacer uso de esta funcionalidad, en la estructura payment del Pago recurrente es necesario enviar en el objeto recurring los datos obligatorios para esta estructura.

Pre-autorización

La pre-autorización es una transacción utilizada para reservar (checkin) un monto de dinero en una tarjeta de crédito. Posteriormente, este monto puede ser debitado (checkout). Durante el proceso, el monto puede cambiar (reauthorization) según las necesidades del comercio o modificaciones en los servicios elegidos por el tarjetahabiente.

Nota: Si una transacción CHECKIN, REAUTHORIZATION o CHECKOUT falla por un estado anómalo, se cancelará y quedará rechazada, pero podrá ser reintentada. La transacción fallida quedará con estado VR.

Checkin

La transacción CHECKIN permite obtener una autorización del banco (proveedor). Se define como un débito en una tarjeta de crédito o débito que funciona como depósito de garantía por el uso de un bien o servicio.

Solicitud Checkin (Request)

Para facilitar la integración, las solicitudes de CHECKIN son similares a las del método processTransaction, con las siguientes diferencias:

• La "action" debe ser checkin.
• La referencia del pago se reutilizará en las operaciones de REAUTHORIZATION y CHECKOUT.
• La moneda del pago también se mantendrá en REAUTHORIZATION y CHECKOUT.
• No se considerarán detalles sobre dispersión (transacciones a múltiples recaudadores con la misma información del tarjetahabiente).
• No se incluirán detalles de recurrencia (cobros recurrentes desde una base de datos propietaria).

IMPORTANTE: El nodo preAuthorization contiene los datos que se usarán en las operaciones posteriores de REAUTHORIZATION y CHECKOUT. Además, refleja el estado general del proceso de pre-autorización.

Reautorización

No aplica a Puerto Rico

Para Transerver Retail, las reautorizaciones están limitadas únicamente a ajustes incrementales al monto previamente autorizado durante el proceso de CHECKIN o en una REAUTHORIZATION anterior.
Esto significa que no es posible reducir el valor autorizado. Si se intenta realizar una reautorización con un monto igual o menor al previamente autorizado, la transacción será fallida; en dado caso de requerir procesar un monto menor, se debe utilizar directamente un proceso de CHECKOUT.

La transacción REAUTHORIZATION permite modificar el monto definido como depósito de garantía en una transacción CHECKIN, solicitando una nueva autorización al banco (proveedor).

Solicitud Reautorización (Request)

Para procesar una REAUTHORIZATION es necesario haber realizado previamente un CHECKIN. Consideraciones:

• La referencia del pago se sobrescribe con la sesión CHECKIN original.
• La moneda del pago también se sobrescribe con la sesión CHECKIN original.
• Los valores de internalReference y authorization deben ser los entregados en la respuesta de CHECKIN dentro del nodo preAuthorization.
• Se pueden realizar varias REAUTHORIZATION antes del CHECKOUT.
• Las reautorizaciones deben ser por un monto mayor a 0.

Tras esta operación, la pre-autorización sigue en estado pendiente hasta que se realice un CHECKOUT.

Check-out

La transacción CHECKOUT confirma el monto del depósito de garantía separado previamente con un CHECKIN o REAUTHORIZATION. Formaliza la transacción (compra/asentamiento) en el proveedor.

Solicitud Check-out (Request)

Consideraciones importantes:

• Es posible hacer un CHECKOUT sin haber realizado una REAUTHORIZATION.
• La referencia del pago se sobrescribe con la sesión CHECKIN original.
• La moneda del pago se sobrescribe con la sesión CHECKIN original.
• Los valores de internalReference y authorization deben ser los entregados en la respuesta de CHECKIN dentro del nodo preAuthorization.
• Si el valor del CHECKOUT es 0, la pre-autorización se cancela y se libera el monto retenido en las peticiones previas.

IMPORTANTE: El estado de status, authorization y receipt dentro del nodo preAuthorization cambia tras un CHECKOUT exitoso. En solicitudes de REVERSE, se deben usar los nuevos valores generados.

Dispersión

Este tipo de transacción es utilizada para dividir el pago entre diferentes entidades además del sitio principal. Es decir, al realizar una transacción, parte del valor es direccionado al sitio autenticado en la transaccion, y otra parte es enviada a una aerolínea u otros sitios. Además, eso permite que cada parte de la transacción sea procesada por diferentes proveedores.

La transacción de dispersión está conformada por una sesión padre de tipo DISPERSION que contiene el valor total de la transacción y el estado general del proceso, y también por sesiones hijas de tipo AUTH_ONLY que contienen la información de cada una de las partes dispersadas. Los datos de autorización y recibo de la transacción padre serán los mismos de la primera transacción procesada.

En caso de que una transacción quede pendiente las demás transacciones pendientes no serán procesadas hasta que esta se resuelva, quedando con un estado de PENDING_PROCESS. La transacción padre mantendra su estado PENDING hasta que todas las sesiones hijas se resuelvan.

En caso de que una transacción falle o sea rechazada, las demás transacciones pendientes automáticamente también serán rechazadas, sin establecer contacto con la red. Si una transacción hija ya hubiese sido aprobada anteriormente, esta mantiene su estado y la transacción padre cambiará su estado a APPROVED_PARTIAL.

Las transacciones pueden ser reversadas juntas o separadas. Si se envía una reversión a una transacción hija, solo esta será reembolsada. Si se envía una reversión a la transacción padre, todas las transacciones serán reversadas.

Dispersión de aerolínea

Cuando una dispersión es realizada a una aerolínea, esta será priorizada y procesada primero. Si 3DS o crédito están configurados, esta configuración será utilizada solamente en el procesamiento de la transacción de la aerolínea.

Las dispersiones de aerolínea son limitadas a apenas 2 partes: una del comercio principal y otra de la aerolínea. También es posible realizar una dispersión en la que el valor total de la transacción es redireccionado a la aerolínea, al no enviar la dispersión del comercio o enviarla con valor cero.

Dispersión de comercios

Las dipersiones de comercios permiten realizar una transacción dividida en hasta 3 sitios, incluyendo el sitio autenticado. Las transacciones hijas serán procesadas en el orden enviado en la transacción.