API Referencia
undefined

Webpay

Introducción E-learning

Webpay es la pasarela de pago de Transbank para realizar transacciones desde Internet con tarjetas bancarias de crédito y débito Redcompra de manera eficaz y segura.

Un flujo de pago en Webpay generalmente cuenta con los siguientes pasos:

  1. El tarjetahabiente selecciona los productos o servicios a pagar en el sitio del comercio.

  2. El tarjetahabiente elige pagar con Webpay en donde, dependiendo de los productos contratados por el comercio, se despliegan las alternativas de pago: Tarjeta de crédito, débito Redcompra y/o prepago.

  3. Durante el proceso de pago, el emisor de la tarjeta autentica al tarjetahabiente antes de realizar la transacción financiera, con el objetivo de validar que la tarjeta esté siendo utilizada por el titular.

  4. Una vez resuelta la autenticación se procede a autorizar el pago. Webpay entrega al sistema del comercio el resultado de la autorización.

Productos Webpay

A continuación se describen los productos que se ofrecen en los servicios web de Webpay.

Webpay Plus

Webpay Plus permite realizar una solicitud de autorización financiera de un pago con tarjetas de crédito, débito Redcompra o prepago en donde quién realiza el pago ingresa al sitio del comercio, selecciona productos o servicio, e indica los datos asociados a la tarjeta del medio de pago seleccionado anteriormente, esta acción lo realiza en forma segura en Webpay. El comercio que recibe pagos mediante Webpay Plus es identificado mediante un código de comercio.

Es el tipo de transacción mas común, usada para un pago puntual en una tienda simple. Se generará un único cobro para todos los productos o servicios adquiridos por el tarjetahabiente.

Webpay Plus Mall

Webpay Plus Mall permite realizar una solicitud de autorización financiera de un conjunto de pagos con tarjetas de crédito, débito o prepago, a través de una sola transacción unificada. Quién realiza el pago, ingresa al sitio del comercio, selecciona varios productos o servicios (pertenecientes a diferentes códigos de comercio), y selecciona Webpay Plus como medio de pago, realizando la transacción de forma segura en Webpay para el conjunto de pagos. Cada pago tendrá su propio resultado, autorizado o rechazado. El concepto de "mall" agrupa múltiples tiendas. Son dichas tiendas las que pueden generar transacciones. Tanto el mall como cada una de las tiendas asociadas son identificadas por un código de comercio diferente.

El tipo de transacción Mall es útil para proveedores de servicios tecnológicos (PST) que pueden realizar una única integración con Transbank y realizar cobros a nombre de los clientes de dichos servicios tecnológicos. Por ejemplo, una plataforma SaaS puede ser un mall y las empresas clientes de la plataforma pueden ser las tiendas de dicho mall. De esa manera, la recaudación que la plataforma realice irá directo al cliente a nombre del cual realizó cada cobro.

Oneclick Mall

Oneclick Mall permite agrupar pagos en una única transacción Oneclick hacia múltiples códigos de comercios (similar a una transacción Mall). En una transacción de este tipo, al igual que en Oneclick, el tarjetahabiente podrá realizar pagos sin la necesidad de ingresar la información de su tarjeta de crédito en cada uno de ellos. Este tipo de pago facilita la venta, centraliza los pagos, disminuye el tiempo de la transacción y reduce los riesgos de ingreso erróneo de los datos del medio de pago.

Oneclick Mall opera con tarjetas de crédito, prepago y débito Redcompra. El modelo de pago contempla el mismo proceso de enrolamiento que la transacción Oneclick.

De cara al comercio, Oneclick Mall combina dos grupos de beneficios:

  • Permite que un tarjetahabiente registre su tarjeta una única vez y pague frecuentemente en cualquiera de las tiendas del mall.

  • Permite que un proveedor de servicios tecnológicos (PST) realice una única integración y haga cobros a nombre de múltiples tiendas clientes.

Al no contar con sistema de autenticación bancaria en los cargos que se realizan después de la autorización, será el comercio el responsable de asumir el riesgo de fraude o desconocimientos de compra que realice un tarjetahabiente.

Webpay Transacción Completa

Este producto permite realizar transacciones con tarjetas de crédito sin utilizar el formulario standard de Webpay. La mayor diferencia con Webpay Plus Tradicional es que el ingreso de los datos de la tarjeta de crédito, se realiza dentro del mismo sitio web del comercio, lo que permite personalizar, a su criterio, la manera en como pide y valida los datos del cliente.

  • La modalidad de Transacción Completa solo funciona con tarjetas de crédito.

  • El comercio puede personalizar el formulario en el que solicita los datos del tarjetahabiente para procesar una transacción. El comercio que desee comenzar a operar con la modalidad de Transacción Completa, debe contar con la certificación de Normas PCI DSS (Payment Card Industry-Data Security Standard) y renovarlas anualmente, debido al manejo de data sensible que pueden procesar y que serán utilizados exclusivamente en su relación con Transbank.

Transacción Completa, le ofrece al comercio elegir una o ambas de las siguientes funcionalidades:

  • Autorización en línea y captura simultánea, en la que se realiza el cargo al tarjetahabiente de inmediato.
  • Autorización en línea y captura diferida, en la que se efectúa una reserva de crédito sobre un valor estimado del producto y/o servicio a adquirir por el tarjetahabiente, posteriormente el comercio define el monto de la transacción el cual será menor o igual al autorizado, en caso de ser superior la transacción será rechazada.

Por este motivo este producto no se encuentra dentro de la oferta publica de Transbank.

Tipos de Pago

Los tipos de pago disponibles actualmente a través de Webpay dependen del tipo de tarjeta usada por el tarjetahabiente y los que tenga activado el comercio.

Para tarjeta de crédito pueden ser los siguientes tipos de pago (con las abreviaciones entre paréntesis):

  • Venta Normal (VN): Pago en 1 cuota.
  • 2 Cuotas sin interés (S2): El comercio recibe el pago en 2 cuotas iguales sin interés.
  • 3 Cuotas sin interés (SI): El comercio recibe el pago en 3 cuotas iguales sin interés.
  • N Cuotas sin interés (NC): El comercio recibe el pago en un número de cuotas iguales y sin interés que el tarjetahabiente puede elegir de entre un rango de 2 y N (el valor N es definido por el comercio y no puede ser superior a 12)
  • Cuotas normales (VC): El emisor ofrece al tarjetahabiente entre 2 y 48 cuotas. El emisor define si son sin interés (si ha establecido un rango de cuotas en promoción) o con interés. El emisor también puede ofrecer de 1 hasta 3 meses de pago diferida. Todo esto sin impacto para el comercio que en esta modalidad de cuotas siempre recibe el pago en 48 horas hábiles.

Para tarjeta de débito Redcompra el tipo de pago siempre corresponde a:

  • Venta débito Redcompra (VD): Pago con tarjeta de débito Redcompra.

  • Venta Prepago (VP): Pago con tarjeta de débito Redcompra.

Códigos de respuesta de autorización

Cuando una transacción es rechazada, Transbank envía un código de respuesta al comercio indicando que esta no pudo efectuarse correctamente. Actualmente, los comercios tienen configurado el nivel 1, el cuál es el estandar para Webpay y entrega información del rechazo de carácter general, agrupando en el mismo distintos tipos de rechazo.

Puedes ver el detalle del nivel 1 a continuación:

Respuestas al
comercio
Descripción
-1 Rechazo - Posible error en el ingreso de datos de la transacción
-2 Rechazo - Se produjo fallo al procesar la transacción, este mensaje de rechazo se encuentra relacionado a parámetros de la tarjeta y/o su cuenta asociada
-3 Rechazo - Error en Transacción
-4 Rechazo - Rechazada por parte del emisor
-5 Rechazo - Transacción con riesgo de posible fraude

A partir del 01 de marzo de 2021, se encuentra disponible el nivel 2 de códigos de respuesta de autorización los cuales entregan información del rechazo de forma más específica.

Para la activación del nivel 2, debes enviar un correo a soporte@transbank.cl indicando el código de comercio al cual deseas realizar esta activación.

Serás informado oportunamente el día en el cual se realizará la activación.

Puedes ver el detalle del nivel 2 a continuación:

Respuestas al
comercio
Descripción
-1 Tarjeta inválida
-2 Error de conexión
-3 Excede monto máximo
-4 Fecha de expiración inválida
-5 Problema en autenticación
-6 Rechazo general
-7 Tarjeta bloqueada
-8 Tarjeta vencida
-9 Transacción no soportada
-10 Problema en la transacción
-11 Excede límite de reintentos de rechazos

El código -11 será retornado en caso de cumplir algunas de las condiciones de la marca.

1.- En el caso de MASTERCARD, se bloqueará todo reintento de transacción rechazada a partir del reintento número 8° (octavo) en adelante, dentro de 24 horas de realizada la transacción original. Los criterios que la marca utiliza para identificar un reintento es a través del código de comercio y el número de tarjeta.

2.- Para el caso de VISA, se bloqueará todo reintento de transacción rechazada a partir del reintento número 16° (decimosexto) en adelante, dentro de 30 días de realizada la transacción original. Los criterios que la marca utiliza para identificar un reintento es a través del código de comercio, el número de tarjeta y el monto de la transacción.

Autorización y Captura

Las transacciones Webpay cuentan con 2 fases: autorización y captura. La autorización se encarga de validar si es posible realizar el cargo a la cuenta asociada a la tarjeta de crédito realizando en el mismo acto la reserva de monto de la transacción. La captura hace efectiva la reserva hecha previamente o cargo en la cuenta de crédito asociada a la tarjeta del titular.

Para tarjetas de débito Redcompra y prepago, la autorización y captura es siempre simultánea. Para tarjetas de crédito, la autorización y captura puede ser simultánea o separada. En este último caso, se trata de una captura diferida.

Desde el punto de vista de la transacción, lo que ocurre es lo siguiente:

  • Autorización y captura simultánea: La transacción es validada en línea por Transbank. El cargo del pago se hace simultáneamente en la tarjeta de crédito o débito Redcompra del cliente.

  • Autorización y captura diferida (Sólo válida para tarjetas de crédito): Se retiene el valor de la compra del saldo de la tarjeta de crédito del cliente, reservando cupo pero sin realizar la transacción definitivamente hasta que el comercio confirma la compra (vía captura diferida) y lo comunique a Transbank. Existe un tiempo máximo de 7 días calendario para realizar la captura. Superado ese tiempo la retención de la tarjeta de crédito será reversada y el cupo liberado. La captura puede realizarse a través del portal Transbank o mediante el servicio web de captura diferida.

VCI

Al realizar la autorización de una transacción, el comercio recibe una respuesta por parte de Transbank informando el resultado. En esta respuesta, el campo VCI corresponde a la autenticación del tarjetahabiente y es información adicional suplementaria al responseCode. El comercio no debe validar este campo porque constantemente se agregan nuevos mecanismos de autenticación que se traducen en nuevos valores para este campo, que no están necesariamente documentados. (En el caso de tarjetas internacionales que no proveen 3D-Secure, la decisión del comercio de aceptarlas o no se realiza a nivel de configuración del comercio en Transbank y debe ser conversada con el ejecutivo del comercio)

Código de respuesta Descripción
TSY Autenticación Exitosa
TSN Autenticación Rechazada
NP No Participa, sin autenticación
U3 Falla conexión, Autenticación Rechazada
INV Datos Inválidos
A Intentó
CNP1 Comercio no participa
EOP Error operacional
BNA BIN no adherido
ENA Emisor no adherido

Para venta extranjera, estos son algunos de los códigos:

Código de respuesta Descripción
TSYS Autenticación exitosa Sin fricción. Resultado autenticación: Autenticación Existosa
TSAS (Intento, tarjeta no enrolada / emisor no disponible. Resultado autenticación: Autenticación Exitosa)
TSNS (Fallido, no autenticado, denegado / no permite intentos. Resultado autenticación: Autenticación denegada)
TSRS (Autenticación rechazada - sin fricción. Resultado autenticación: Autenticación rechazada)
TSUS (Autenticación no se pudo realizar por problema técnico u otro motivo. Resultado autenticación: Autenticación fallida)
TSCF (Autenticación con fricción (No aceptada por el comercio). Resultado autenticación: Autenticación incompleta)
TSYF (Autenticación exitosa con fricción. Resultado autenticación: Autenticación exitosa)
TSNF (No autenticado. Transacción denegada con fricción. Resultado autenticación: Autenticación denegada)
TSUF (Autenticación con fricción no se pudo realizar por problema técnico u otro. Resultado autenticación: Autenticación fallida)
NPC (Comercio no Participa. Resultado autenticación: Comercio/BIN no participa)
NPB (BIN no participa. Resultado autenticación: Comercio/BIN no participa)
NPCB (Comercio y BIN no participan. Resultado autenticación: Comercio/BIN no participa)
SPCB (Comercio y BIN sí participan. Resultado autenticación: Autorización incompleta)

Anulaciones y Reversas

Las transacciones de Webpay se pueden anular o reversar dadas algunas condiciones. Para cualquiera de éstas operaciones se utiliza el mismo servicio web que discernirá si se realizará una reversa o una anulación.

Para poder ejecutar una reversa ésta debe ser realizada antes de las 3 horas de efectuada la confirmación por el monto total y en compras con tarjeta de crédito, débito o prepago.

Una vez pasadas las tres horas, siempre se ejecutará una anulación.

  • En transacciones con tarjeta de débito o prepago solo es posible anular por el monto total.
  • En transacciones con tarjeta de crédito puedes anular por cualquier monto igual o menor al total de la compra.

En caso que la transacción haya sido abonada al comercio, la anulación generará una retención en los siguientes abonos por el monto previamente autorizado.

La anulación de transacciones realizadas con débito o prepago se encuentra disponibles a partir de la versión 1.2 del API de Transbank.

El comercio tiene un plazo de 90 días desde la fecha de venta para anular transacciones vía servicios web.

En el caso de los productos con modalidad mall es importante destacar que las anulaciones actúan individualmente sobre las transacciones de las tiendas de un mall. Por ende, la anulación es la operación correcta a utilizar para fines financieros, de manera de anular un cargo ya realizado.