Manual de Integraci N Webpay v1 PDF

REFERENCIA API
SOAP WEBPAY
TRANSBANK S.A.
DOCUMENTO DE ESPECIFICACIONES (V 1.0)
CONTENIDO ÍNDICE INTERACTIVO
Haz click en número de capítulo o
de página para acceder directamente.
1 CONTROL DE CAMBIOS 5
2 PREFACIO 5
5 2.1 Acerca de esta guía
5 2.2 Audiencia
5 2.3 Feedback para esta documentación
3 SOBRE WEBPAY 6
6 3.1 Introducción a Webpay

6 3.2 Tipos de Transacciones Webpay
7 3.3 Autorización y captura de transacciones de crédito
7 3.4 Anulación de transacciones
8 3.5 Monedas soportadas
8 3.6 Autenticación del tarjetahabiente
8 3.7 Compatibilidad con navegadores Web
9 3.8 Tipos de pago (productos)
4 CONSIDERACIONES GENERALES 10
10 4.1 Comunicación
10 4.2 Seguridad
10 4.3 Deberes de los comercios
10 4.3.1 Validación de mensajes de solicitud y respuesta
10 4.3.2 Actualizaciones de plugins y SDK
5 API SOAP DE WEBPAY 11
11 5.1 Aspectos de Seguridad de API SOAP

11 5.1.1 Información general
11 5.1.2 Generación de llave y certificado auto-firmado
6 INTEGRACIÓN, VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN 12
12 6.1 Etapas de integración de Webpay

12 6.1.1 Etapa de integración
12 6.1.2 Etapa de validación de Integración
13 6.1.3 Etapa de puesta en producción
13 6.2 Ambientes
7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 14
14 7.1 Descripción de la Transacción de Autorización Normal

15 7.2 Secuencia de pago en una transacción normal
15 7.2.1 Diagrama
16 7.2.2 Descripción de la secuencia
REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 2

17 7.3 Flujo Alternativo: Secuencia de pago en una transacción normal anulada en formulario de pago
17 7.3.1 Diagrama
18 7.3.2 Descripción secuencia de pago para transacción anulada en formulario de pago
18 7.4 Flujo Alternativo: Secuencia de pago en una transacción normal con evento de timeout
18 7.4.1 Diagrama
19 7.4.2 Descripción de secuencia timeout en transacción normal
19 7.5 Descripción de métodos del Servicio Web de Transacción de Autorización Normal
19 7.5.1 Operación initTransaction
20 7.5.2 Operación getTransactionResult
22 7.5.3 Operación acknowledgeTransaction
8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 23
23 8.1 Descripción de la Transacción de Autorización Mall Normal

24 8.2 Secuencia de pago en una transacción de autorización Mall Normal
24 8.2.1 Diagrama
25 8.2.2 Descripción de la secuencia
26 8.3 Flujo Alternativo: Secuencia de pago en una transacción mall normal anulada en formulario de pago
27 8.3.1 Descripción de secuencia alternativa, anular
27 8.4 Flujo Alternativo: Secuencia de pago en una transacción mall normal con evento de timeout
27 8.4.1 Diagrama
28 8.4.2 Descripción de secuencia alternativa, timeout
28 8.5 Descripción de métodos del Servicio Web de Transacción de Autorización Mall Normal
28 8.5.1 Operación initTransaction
29 8.5.2 Operación getTransactionResult
31 8.5.3 Operación acknowledgeTransaction
9 TRANSACCIÓN ONECLICK 32
32 9.1 Descripción de la Transacción de OneClick

32 9.2 Resumen de los métodos del servicio Web
32 9.3 Inscripción en Oneclick
32 9.3.1 Descripción
33 9.3.2 Diagrama
34 9.3.3 Método initInscription
34 9.4 Eliminar registro de inscripción de usuario
34 9.5 Transacción de Pago Oneclick
35 9.6 Reversa de Pagos Autorizados
35 9.7 Definición detallada de métodos del Servicio Web
10 TRANSACCIÓN DE CAPTURA DIFERIDA 37
37 10.1 Descripción de la captura diferida

37 10.2 Descripción del método del servicio web de captura diferida
37 10.2.1 Operación capture
38 10.2.2 Códigos de error

11 TRANSACCIÓN DE ANULACIÓN 39
39 11.1 Descripción de la anulación

39 11.2 Descripción del método del servicio web de anulación de transacciones
39 11.2.1 Operación nullify
40 11.2.2 Códigos de error
12 ANEXOS 41
41 12.1 Anexo A: Creación de llaves y ambientes Webpay

41 12.1.1 Creación de llave privada y certificado público
42 12.1.2 Ambientes de Webpay
43 12.2 Anexo B: Requerimientos de páginas de transición y de página de fin de transacción
43 12.2.1 Requerimientos Página de Transición
43 12.2.2 Requerimientos Página final de éxito
43 12.2.3 Requerimientos Página final de fracaso
44 12.3 Anexo C: Excepciones SOAP API Webpay
47 12.4 Anexo D: Pruebas de validación efectuada por Transbank
47 12.4.1 Pruebas de validación para Transacción Normal, modalidad plugin
47 12.4.2 Pruebas de validación para Transacción Normal
47 12.4.3 Pruebas de validación para Transacción Normal captura diferida
47 12.4.4 Pruebas de validación para Transacción Mall
47 12.4.5 Pruebas de validación para Transacción OneClick
48 12.5 Anexo D: Referencias

1 CONTROL DE CAMBIOS 2 PREFACIO
1 CONTROL DE CAMBIOS
FECHA VERSIÓN DESCRIPCIÓN DEL CAMBIO

22-05-2017 1.0 Liberación inicial de documento de API SOAP de integración Webpay.
08-06-2017 1.1 Corrige largo de código de autorización.
2 PREFACIO
2.1 Acerca de esta guía 2.2 Audiencia

Esta guía describe los aspectos técnicos y operativos que deben Esta guía está dirigida a implementadores que realizan la
ser considerados en la integración con Webpay utilizando API integración de Webpay en comercios utilizando la API SOAP para
SOAP para los servicios web para Transacción de Autorización soportar en estos el pago con tarjetas bancarias.
Normal, Mall Normal, OneClick y Anulaciones. Se recomienda que quién realice la integración, al menos, posea
conocimiento técnico de al menos en los siguientes temas:
Antes de continuar, es necesario declarar que para tener una visión
general de los productos y modalidades asociadas a Webpay se • Servicios Web
recomienda leer el manual Operacional de Webpay. • WS-Security
• Generación y validación de firma digital en mensajes SOAP.
2.3 Feedback para esta documentación

Ayúdanos a mejorar esta información enviándonos comentarios a:
El presente manual se considera parte íntegra del contrato,
por lo que es importante prestar atención a las obligaciones, soporte@transbank.cl
sugerencias e indicaciones descritas en el presente
documento.

3 SOBRE WEBPAY
3 SOBRE WEBPAY
3.1 Introducción a Webpay dependiendo de los productos contratados por el comercio, se

Webpay es una pasarela de pago desarrollada por Transbank para despliegan las alternativas de pago de crédito con productos cuotas
realizar transacciones desde Internet con tarjetas bancarías de y/o débito Redcompra. Durante el proceso de pago se autentica
crédito y débito. Hoy en día Webpay constituye una herramienta al tarjetahabiente antes de realizar la transacción financiera, con
clave para el desarrollo de un comercio electrónico eficaz y seguro el objetivo de validar que la tarjeta este siendo utilizada por el
en Chile. titular. Una vez resuelta la autenticación se procede a autorizar el
pago. Webpay entrega al sistema del comercio el resultado de la
En general un flujo de pago en Webpay se inicia desde el comercio, autorización y si ésta es aprobada, Webpay emite un comprobante
en donde el tarjetahabiente selecciona los productos o servicios a electrónico del pago.
pagar. Una vez realizado esto, elige pagar con Webpay en donde,
Sitio del Webpay Autenticación Sitio del Webpay Sitio del

Comercio Formulario en Banco Comercio Comprobante Comercio
de Pago Emisor de pago
Dentro de los atributos más relevantes de Webpay se pueden comercio por eventuales fraudes o desconocimientos de
mencionar: compra.
• Permite realizar transacciones seguras y en línea a través de
Internet. • La seguridad es reforzada por medio de la utilización de
servidores seguros, protegidos con TLS 1.2
• En transacciones con Webpay Plus se solicita al tarjetahabiente
autenticarse con su emisor, protegiendo de esta forma al • Firma digital.
3.2 Tipos de Transacciones Webpay

Los tipos de transacciones disponibles a través de servicios Web son los siguientes:
Una transacción normal corresponde a una solicitud de autorización financiera de un pago con tarjetas de crédito o
Normal débito. El tarjetahabiente ingresa al sitio del comercio, selecciona productos o servicio, y el ingreso asociado a los datos
de la tarjeta de crédito o débito lo realiza en forma segura en Webpay.
Una transacción Mall corresponde a múltiples solicitudes de autorización financiera de distintos códigos de comercios
pertenecientes a un comercio padre. Cada transacción constituye un pago con tarjetas de crédito o débito en una
Mall
tienda en particular. El tarjetahabiente ingresa al sitio del comercio padre, selecciona productos o servicio de distintas
tiendas, y el ingreso asociado a los datos de la tarjeta de crédito o débito lo realiza en forma segura en Webpay.
Una transacción OneClick permite que el tarjetahabiente registre su tarjeta de crédito nacional una única vez y los
pagos los realice en un solo click en la tienda de comercio electrónico. El registro de la tarjeta queda almacenado en
One Click Webpay en forma segura y asociado al login de usuario de la tienda, de esta forma cada vez que un tarjetahabiente
realiza una compra en la tienda, basta con que inicie sesión en esta y presione pagar para enviar todos los datos
asociados a la transacción.

3 SOBRE WEBPAY
3.3 Autorización y captura de transacciones de crédito la cuenta de crédito asociada a la tarjeta del titular. Ambas fases
Las transacciones Webpay cuentan con 2 fases, autorización pueden ocurrir en el mismo instante o en forma desfasada. Estas
y captura. La autorización se encarga de validar si es posible modalidades, por separado, solo son válidas para tarjetas de
realizar el cargo a la cuenta asociada a la tarjeta de crédito crédito. En el caso de compras con tarjeta de débito siempre es
realizando en el mismo acto la reserva de monto de la transacción. en modalidad autorización y captura simultanea no siendo posible
La captura hace efectiva la reserva hecha previamente o cargo en separar ambos procesos.
Autorización
Es la utilizada cuando la transacción es validada en línea por Transbank. El cargo del pago se hace simultáneamente
y captura
simultanea en la tarjeta de crédito o débito del cliente.
Es utilizada cuando el comercio por diversas razones, ejemplo: verificación de stock, no puede realizar la transacción
en tiempo real, aquí lo que se hace es retener el valor de la compra del saldo de la tarjeta de crédito del cliente sin
consumir definitivamente el cupo de la tarjeta de crédito hasta que el comercio confirma la compra, vía captura, y lo
comunique a Transbank.
Existe un tiempo máximo de 7 días para realizar esto último, de no ser así la retención de la tarjeta de crédito del cliente
será reversada.
Mecanismos para realizar la captura en forma diferida:

Autorización y
captura diferida
• A través de portal de Transbank www.transbank.cl
• Transacción de captura diferida, soportada a través de servicios Web.
Esta modalidad sólo está disponible para pagos de crédito y no así para pagos con tarjetas de débito.
Los tipos de pago soportados para esta modalidad son solo los siguientes:
- Venta Normal
- 2 cuotas sin interés
- 3 cuotas sin interés
- N Cuotas
3.4 Anulación de transacciones querer hacerlo se debe entregar el dinero en efectivo al cliente.
Webpay permite, por medio de servicios Web, anular una
transacción de crédito que fue autorizada. Las transacciones crédito se pueden anular bajo el siguiente criterio:
Esta operación contempla anular total o parcialmente una Producto Código Anulación Anulación
Total Parcial
transacción. Para ello se deberá indicar los datos asociados a la
transacción de autorización o captura en línea sobre los cuales se Venta Normal VN
desea realizar la anulación y los montos requeridos para anular.

2 cuotas sin interés S2
En caso de que la transacción haya sido abonada al comercio, la
anulación generará una retención en los siguientes abonos por el 3 cuotas sin interés SI
monto previamente autorizado, con esto es posible revertir el cargo
en la cuenta del tarjetahabiente. El comercio tiene un plazo de 30 Nº Cuotas NC
días para anular transacciones, a partir de la fecha de la venta.
Cuotas Normales VC
Esta funcionalidad solo es válida para transacciones crédito.

Venta débito VD
Las transacciones débito no pueden ser anuladas y en caso de

3 SOBRE WEBPAY
El comercio conoce el producto aplicado en una transacción al Para que la transacción sea autenticada, el comercio debe tener
obtener la respuesta de autorización original desde Transbank. habilitado Webpay Plus o 3D Secure.
Este dato debe ser almacenado por el comercio para poder
aplicar la lógica de anulación parcial y/o total. 3.7 Compatibilidad con navegadores Web
Transbank garantiza el correcto funcionamiento de Webpay bajo
Las anulaciones no pueden ser aplicadas, por ahora, en los siguientes dispositivos y navegadores:
comercios OneClick.
Clientes PC:
3.5 Monedas soportadas • Internet Explorer 9 o superior
Actualmente Webpay soporta los siguientes tipos de monedas: • Microsoft Edge
• Pesos Chilenos (CLP) • Mozilla Firefox 48 o superior
• Dólares norteamericanos (USD) • Chrome 52 o superior
• Safari 7 o superior
3.6 Autenticación del tarjetahabiente
Webpay permite autenticar al tarjetahabiente durante el proceso de Smartphone / Dispositivos móviles:
pago, agregando mayor seguridad y evitando desconocimientos • Blackberry 9900, 9700
de compra. Las modalidades de autenticación existentes son los • iPhone e iPod en cualquiera de sus versiones
siguientes: • Android en cualquiera de sus versiones
• Webpay Plus, permite autenticar a tarjetahabientes cuyas

tarjetas de crédito y débito han sido emitidas en Chile y que
Es de responsabilidad del comercio
realizan compras en comercios Webpay. garantizar la compatibilidad de su sitio Web con navegadores
Web, como también tomar todas las medidas necesarias de
• 3D Secure, corresponden a los programas internacionales seguridad para garantizar una compra segura.
implementados por VISA (Verified By Visa) y MASTERCARD
Se sugiere uso de certificados digitales y no hacer uso de
(Mastercard Secure Code), los cuales permiten autenticar
pop-up emergente para evitar problemas de bloqueo con
durante el proceso de compra a tarjetahabientes cuyas tarjetas últimas versiones de navegadores Web. Para el despliegue
de crédito han sido emitidas en el extranjero. de la capa mobile, Webpay utiliza el user-agent que llega vía
el browser del tarjetahabiente e identifica si este corresponde
El resultado de la autenticación, es entregado junto con el a los soportados detallados anteriormente.
resultado de la autorización financiera de la transacción Webpay.

3 SOBRE WEBPAY
3.8 Tipos de pago (productos) tenga activado el comercio, en general se soportan los siguientes
Los tipos de pago disponibles actualmente a través de Webpay tipos de pago:
dependen del tipo de tarjeta usada por el tarjetahabiente y los que
Abreviación
Tipo de Pago Descripción
tipo de pago
VENTA NORMAL Corresponde al pago de un producto o servicio en 1 cuota. VN

2 CUOTAS Corresponde al pago de un producto o servicio en 2 cuotas iguales sin interés para el
S2
SIN INTERÉS TH.
3 CUOTAS Corresponde al pago de un producto o servicio en 3 cuotas iguales sin interés para el
SI
SIN INTERÉS TH.
VENTA CUOTAS
N CUOTAS Corresponde al pago de un producto o servicio en N cuotas iguales sin interés para
CRÉDITO (SIN el TH. El número de cuotas puede ir de 2 hasta "N" cuotas. Con "N" máximo 12, y NC
INTERÉS) definido por el Comercio.
CUOTAS SIN Corresponde al pago de un producto o servicio en N cuotas iguales sin interés para el
INTERÉS DEL TH. Esto es una promoción del emisor de la tarjeta. Puede ir de 2 hasta 48 cuotas. El VC
EMISOR Emisor escoge el rango en promoción.
Cuotas normales o cuotas fijas van de 2 hasta 48 y se les aplica el interés definido por
CUOTAS
cada Emisor. Si éste se encuentra adherido a diferimiento puede ofrecer desde 1 hasta VC
NORMALES
3 meses de diferido (sin impacto para el Comercio).
DÉBITO REDCOMPRA Pago a través de tarjeta de débito Redcompra VD
Nota: Para dudas con respecto a los abonos para el comercio, dirigirse al Manual de Comercios de Webpay.

4 CONSIDERACIONES GENERALES
4 CONSIDERACIONES GENERALES
4.1 Comunicación DEBE velar por la seguridad de las transacciones, bajo el

La comunicación e información oficial que entrega Transbank para esquema del servicio ofertado por Transbank.
las integraciones de Webpay, en todas sus modalidades, sólo se
realiza a través de los siguientes canales: Webpay expone una API, y es obligación del comercio consumir
en tiempo y forma los servicios expuestos, por lo que dado los
Portal de Transbank: www.transbank.cl protocolos SOAP 1.1 y WS-Security que utilizan los Webservices
de Webpay, cada solicitud del comercio y cada respuesta de
Portal de desarrolladores: www.transbankdevelopers.cl Webpay deben ir firmadas, y es OBLIGACIÓN de ambas partes
validar dicha firma.
En el portal de Transbank, el comercio podrá encontrar información
general asociado al producto Webpay, mientras que en el portal En el caso de las solicitudes (request) de los comercios, Webpay
de desarrolladores, los comercios podrán encontrar información valida que la firma del mensaje SOAP corresponda al comercio
específica como manuales, SDK, plugins, que son herramientas que consume el servicio, mediante el certificado público
de código abierto que tienen como único propósito facilitar la autofirmado que tiene cargado en sus sistemas. A su vez,
integración de comercios y proveer el entendimiento de los cuando el comercio recibe una respuesta a la solicitud, Webpay
servicios web para que operen con Webpay Plus, por lo no puede firma dicha respuesta (response) y es deber del comercio validar
utilizar ni permitir que las herramientas disponibles sean utilizadas que dicha firma efectivamente provenga de Webpay utilizando
para cualquier otro propósito. el certificado público que Transbank le compartió.
Dado lo anterior es que, al utilizar cualquier software distribuido Cabe recordar que Webpay posee 2 ambientes: integración/
por Transbank, asume que el comercio acepta esta y otras testing y producción. En ambos casos, Webpay posee un
consideraciones publicadas en certificado distinto para cada ambiente, por lo que debe procurar
www.transbankdevelopers.cl no confundir el escenario en que se encuentra el comercio.
4.2 Seguridad
Los servicios Web de Webpay están protegidos para garantizar 4.3.2 Actualizaciones de plugins y SDK
que solamente miembros autorizados por Transbank hagan uso Si el comercio está utilizando una solución basada en Plugins
de las operaciones disponibles. El mecanismo de seguridad o SDK, debe atento a las actualizaciones que periódicamente
implementado está basado en un canal de comunicación seguro Transbank realizarán, los que pueden responder a mantener
TLS 1.2 y WS-Security, los cuales proporcionan autenticación, compatibilidad con los CMS o Shoppping Cart para su
confidencialidad e integridad a los Servicios Web. Con lo anterior, compatibilidad, modificaciones por seguridad, adición de
la seguridad se encuentra basada en: propiedades o funciones, o correcciones a las comunicaciones.
• Canal seguro a través de TLS 1.2 para la comunicación del La comunicación oficial siempre se realizará a través del sitio
cliente con Webpay.
www.transbankdevelopers.cl
• Mensajes requerimientos y respuestas firmados digitalmente.
Los plugins y SDK para Webpay que distribuye Transbank ya

están construidos con las librerías necesarias para realizar las
Transbank asegura compatibilidad del plugin
validaciones requeridas, pero es deber del comercio asegurarse
con una(s) versión(es) específica(s) del CMS o Shopping
que la solución o desarrollo de medio de pago que utilice, cumpla Cart y los SDK con configuraciones y requisitos indicados en
con los protocolos de seguridad. transbankdevelopers.cl. Tenga especial cuidado si actualiza
su plataforma de solución de pago a una versión que no
4.3 Deberes de los comercios se ha asegurado compatibilidad, porque podría dejar de
4.3.1 Validación de mensajes de solicitud y respuesta funcionar la comunicación entre su comercio y Webpay.
Todo comercio que utiliza Webpay mediante Webservices,

5 API SOAP DE WEBPAY
5 API SOAP DE WEBPAY
La API SOAP de Webpay está basada en el estándar conocido El comercio debe generar un certificado digital, el cual puede ser
*1 como Servicios Web*1, el que incluye el protocolo SOAP (Simple auto-firmado, teniendo especial cuidado de usar el common name
Object Access Protocol) 1.1, WSDL (Web Services Definition (CN) igual al código de comercio entregado por Transbank,
Language), proporcionando un alto grado de interoperabilidad, ejemplo: cn = 597029124456.|
un protocolo estándar para invocación de servicios remotos e
independencia de la plataforma y el lenguaje de desarrollo. El comercio debe enviar a Transbank el certificado digital (parte
pública) que utilizará para validar que el requerimiento viene
El tipo de transacción, la posibilidad de permitir el pago con crédito realmente desde el comercio. No se requiere la llave privada de
y débito, y los productos cuotas, dependerán del tipo de producto este y siempre debe ser custodiada por el comercio.
contratado por el comercio y del emisor de la tarjeta utilizada en
la compra. En los siguientes capítulos se entrega información Transbank entregará su certificado a los comercios en el
específica para cada tipo de transacción. proceso de integración, de testing y de puesta en producción,
de forma independiente para que puedan realizar la validación
5.1 Aspectos de Seguridad de API SOAP de la firma en la respuesta.
5.1.1 Información general
Los servicios Web de Webpay están protegidos para garantizar Todos los métodos, en su requerimiento y respuesta van con
que solamente miembros autorizados por Transbank hagan uso firma digital (WS-Security) del cuerpo del mensaje ({http://
de las operaciones disponibles. El mecanismo de seguridad schemas.xmlsoap.org/soap/envelope/}Body). El comercio
implementado está basado en un canal de comunicación seguro firma con su certificado el requerimiento y valida la respuesta
TLS 1.2 y WS-Security, los cuales proporcionan autenticación, con el certificado de Transbank.
confidencialidad e integridad a los Servicios Web. Con lo
anterior, la seguridad se encuentra basada en: 5.1.2 Generación de llave y certificado auto-firmado
• Canal seguro a través de TLS 1.2 para la comunicación del 1. Crear llave privada
cliente con Webpay.
openssl genrsa -out 597029124456.key 2048
• Mensajes requerimientos y respuestas firmados digitalmente.
2. Crear requerimiento de certificado
REQUERIMIENTO
openssl req -new -key 597029124456.key -out 597029124456.csr

SSL
Country Name (2 letter code) []:CL
Valida firma con llave
pública de comercio
State or Province Name (full name) []:
Locality Name (eg, city) []:SANTIAGO
Mensaje firmado con llave Organization Name (eg, company) []:
privada de comercio Organizational Unit Name (eg, section) []:
Aplicación Common Name (eg, your name or your server’s hostname)
Servicios
Cliente del []:597029124456
Webpay
Comercio Email Address []:
Please enter the following ‘extra’ attributes
RESPUESTA to be sent with your certificate request
A challenge password []:
Valida firma con llave
pública de Webpay An optional company name []:
3. Crear certificado autofirmado
Mensaje firmado con llave

openssl x509 -req -days 1460 -in 597029124456.csr
privada de Webpay
-signkey 597029124456.key -out 597029124456.crt
El comercio debe enviar a Transbank el certificado público

(597029124456.crt) y quedarse con su llave privada con la
*1 Anexo D: REF 03
cual deberá transaccionar.

6 INTEGRACIÓN, VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN
6.1 Etapas de integración de Webpay ambiente de integración, ya vienen preinstalados, por lo que
Para que el comercio incorpore Webpay como medio de pago, es no requiere de una configuración adicional.
necesario que realice las siguientes etapas:
• Etapa de Integración Cabe destacar, las tienda de pruebas soporta los medios
• Etapa de Validación de Integración de pago débito y crédito en transacción normal y captura
• Etapa de Puesta en producción simultánea, en moneda pesos chilenos, que es el producto
Webpay más utilizado en el mercado.
Cada una de las etapas es necesaria para que el comercio realice
una correcta implementación de Webpay, priorizando la seguridad Cualquier duda con este aspecto, o algún requerimiento
e integridad transaccional. en particular respecto de la tienda de integración,
contacte a la mesa de soporte al 800 44 11 44 o al correo
6.1.1 Etapa de integración
soporte@transbank.cl
La etapa de integración corresponde al proceso en que el
comercio desarrolla su solución de medio de pago, consumiendo 6.1.1.2 Datos de prueba para el ambiente de integración
los servicios de la API Webpay. Para utilizar el ambiente de integración, necesitará tarjetas
de pruebas, las que se encuentran predefinidas para los
En este caso, el comercio utiliza un código de comercio escenarios de éxito y fracaso.
de integración que provee Transbank, junto con todas las
credenciales necesarias para realizar la conexión y el correcto En ambos casos, y tanto para débito y crédito, las
consumo de servicios. transacciones son autenticadas, por lo que deben utilizarse
los siguientes datos.
En el caso que el comercio desee utilizar los plugins o los SDK
que provee Transbank, éstos ya incorporan dichas credenciales. Para el caso de pruebas con tarjetas de crédito, se tiene lo
Si el comercio desea desarrollar su propia solución, entonces siguiente:
debe utilizar las credenciales correspondientes que las puede
obtener desde transbankdevelopers.cl o solicitándolas a Marca VISA MASTERCARD
Nº de Tarjeta 4051885600446623 5186059559590568
soporte@transbank.cl
Año Expiración Cualquiera Cualquiera
6.1.1.1 Credenciales Mes Expiración Cualquiera Cualquiera
Para comenzar el proceso de integración, visite CVV 123 123
www.transbankdevelopers.cl Resultado APROBADO RECHAZADO
y descargue el plugin correspondiente a su Shopping Cart o Para el caso de transacciones con tarjeta de débito:
CMS, el SDK de su preferencia, o el package con credenciales
APRUEBA RECHAZA
correspondientes si desea utilizar desarrollo propio.
TARJETA 4051885600446620 5186059559590560
Procure cumplir con los requisitos técnicos que allí se RUT 11.111.111-1 11.111.111-1
especifican y seguir las instrucciones de instalación PASSWORD 123 123
detalladas para cada caso.
6.1.2 Etapa de validación de Integración
Cada plugin viene de la forma ‘listo para usar’ en ambiente de Durante la validación de la integración se pretende verificar que
integración / validación, cumpliendo con los requerimientos el comercio transacciona de manera segura y sin problemas,
técnicos, de seguridad y de despliegue de información por lo que se solicitarán una serie de pruebas y su posterior
requeridos por Webpay, por lo que no debería modificar nada. envío de evidencias para validar la integración.
La tienda de pruebas que viene por defecto con los plugins
tiene el código de comercio 597020000541, y su llave privada, Esta validación es requisito necesario para dejar al comercio
certificado público y el certificado público de Webpay, para el en producción y no se permitirá que un comercio utilice

productivamente el servicio Webpay sin poseer una validación. Estos pasos incluyen cambio en el ambiente sobre el que
transacciones, pasando de integración a producción, además
Por otro lado, Transbank no validará ninguna integración a de las instrucciones de creación de llave privada productiva y
algún comercio que no posea código de comercio productivo. certificado público autofirmado asociado a dicha llave, como
Para obtenerlo, siga las instrucciones en cómo hacerse asimismo el cambio en el certificado público de transbank del
cliente en el portal ambiente productivo.
www.transbank.cl
o contacte a su ejecutivo comercial. Para dudas sobre las llaves y certificados, ver anexo “Creación
de llaves y ambiente de integración”
En esta etapa, el comercio envía las evidencias a
soporte@transbank.cl Durante el paso a producción se le exigirá realizar, al menos,
una transacción de prueba, con la que finalizará oficialmente la
mediante el formulario correspondiente, indicando claramente puesta en producción.
las órdenes de compra, fecha y hora de las transacciones.
Soporte validará que los casos de prueba sean consistentes

con los registrados en los sistemas de Webpay y, de estar todo
Es responsabilidad del comercio considerar
correcto, se le notificará al comercio la conformidad para pasar que el certificado público que Transbank comparte con los
a producción, recibiendo las instrucciones para ello. De no comercios tiene una fecha de caducidad, como asimismo
estar consistentes las pruebas, se le hará alcances al comercio el certificado que el comercio genera y que comparte con
respecto de su integración, para que realice las correcciones Transbank para realizar las transacciones sobre Webpay.
correspondientes y vuelva a enviar las evidencias una vez
El comercio es responsable por resguardar su llave
terminadas dichas correcciones.
privada y su certificado público, como asimismo es
responsable por reemplazar estos cuando caduquen.
6.1.3 Etapa de puesta en producción
Corresponde a las actividades técnico-administrativas en que
ambas partes, comercio y Transbank, realizan para habilitar
la solución de medio de pago en producción, permitiéndole al 6.2 Ambientes
comercio operar con Webpay y toda su gama de tarjetas. Para el proceso de integración, validación y paso a producción,
Transbank pone a disposición 2 ambientes:
Una vez que la validación de integración es aprobada, el
comercio recibirá instrucciones desde soporte, que incluyen 1) Ambiente de Integración y Validación: En este ambiente el
cambio a endpoints productivos, certificado público productivo comercio realiza la integración a Webpay y testea su solución
de Webpay e instrucciones para la creación de llave privada y de medio pago. Asimismo, en éste ambiente es que se valida la
certificado público productivo del comercio, entre otros. integración del comercio.
Como Webpay utiliza WS_Security, es que es en esta etapa 2) Ambiente de producción: Este ambiente es en el cual
en que se intercambian, comercio y Transbank, los certificados finalmente operará productivamente el comercio. En este
públicos productivos, manteniendo ambas partes sus ambiente puede hacer pruebas con tarjetas de crédito o débito
respectivas llaves privadas. De esta manera, es que ambas reales. Las credenciales de este ambiente son entregadas al
partes firman sus comunicaciones y la contraparte validará las momento que se coordina el paso a producción.
firmas con los certificados ya intercambiados.
Cada uno de estos ambientes maneja distintas URLs (endpoints),
Una vez que soporte le comunique formalmente que la distintos códigos de comercios, distintas tarjetas de prueba y
integración está aprobada, deberá seguir los pasos que le indican distintos certificados, por lo que es importante tener la claridad
para pasar a producción y poder comenzar a transaccionar de que, al realizar el cambio de ambiente un ambiente a otro, se
manera real. consideren los puntos anteriores.

7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL
7.1 Descripción de la Transacción de Autorización Normal ingreso asociado a los datos de la tarjeta de crédito o débito lo
Una transacción de autorización normal (o transacción normal), realiza en forma segura en Webpay.
corresponde a una solicitud de autorización financiera de un pago
con tarjetas de crédito o débito, en donde quién realiza el pago El flujo de páginas para la transacción es el siguiente:
ingresa al sitio del comercio, selecciona productos o servicio, y el

Resumen de los métodos del servicio Web de Transacción Normal
MÉTODO DESCRIPCIÓN GENERAL

Permite inicializar una transacción en Webpay. Como respuesta a la invocación se genera un token que representa
en forma única una transacción.
initTransaction
Es importante considerar que una vez invocado este método, el token que es entregado tiene un periodo
reducido de vida de 5 minutos, posterior a esto el token es caducado y no podrá ser utilizado en un pago.
getTransactionResult Permite obtener el resultado de la transacción una vez que Webpay ha resuelto su autorización financiera.
Indica a Webpay que se ha recibido conforme el resultado de la transacción.
El método acknowledgeTransaction debe ser invocado siempre, independientemente del resultado

acknowledgeTransaction
entregado por el método getTransactionResult. Si la invocación no se realiza en un período de 30 segundos,
Webpay reversará la transacción, asumiendo que el comercio no pudo informar de su resultado, evitando así el
cobro al tarjetahabiente.

7.2 Secuencia de pago en una transacción normal

7.2.1 Diagrama
El siguiente diagrama ilustra la secuencia de pago y cómo participan los distintos actores en una transacción normal.
sd Secuencia Flujo Webpay Transacción Normal
TARJETAHABIENTE COMERCIO WEBPAY WS
1 Pagar con Webpay()
2 initTransaction()
3 Response() :token, urfFormOfPayment
4 Redirect(token...)
5 Request(token)
6 Formulario Webpay()
7 Pagar()
8 Autoriza()
9 Redirect()
10 Request(token)
11 getTransactionResult(token...)
12 Response()
13 acknowledge Transaction(token)
14 Redirection(token)
15 Request(token)
16 Comprobante Webpay()
17 Request(token)
18 Pagina final()
Ilustración 1: Diagrama de secuencia de Transacción Normal

7.2.2 Descripción de la secuencia autorización sea persistida en los sistemas del comercio, ya que
1. Una vez seleccionado los bienes o servicios, tarjetahabiente este método se puede invocar una única vez por transacción.
decide pagar a través de Webpay.
12. Comercio recibe el resultado de la invocación del método
2. El comercio inicia una transacción en Webpay, invocando el getTransactionResult().
método initTransaction(…).
13. Para que el comercio informe a Webpay que el
3. Webpay procesa el requerimiento y entrega como resultado de la transacción se ha recibido sin problemas,
resultado de la operación el token de la transacción y el sistema del comercio debe consumir el tercer método
URL de redireccionamiento a la cual se deberá redirigir al acknowledgeTransaction(). Si esto fue ejecutado
tarjetahabiente. correctamente el producto puede ser liberado al cliente.
4. Comercio redirecciona al tarjetahabiente hacia Webpay, con

el token de la transacción a la URL indicada en punto 3. La
redirección se realiza enviando por método POST el token en
De no ser consumido o demorar más de 30
variable token_ws. segundos en su consumo, Webpay realizará la reversa
de la transacción, asumiendo que existieron problemas
5. El navegador Web del tarjetahabiente realiza una petición de comunicación. En este caso el método retorna una
HTTPS a Webpay, en base al redireccionamiento generado Excepción indicando la situación. Esta excepción debe
por el comercio en el punto 4. ser manejada para no entregar el producto o servicio en
caso que ocurra.
6. Webpay responde al requerimiento desplegando el formulario
de pago de Webpay. Desde este punto la comunicación es
entre Webpay y el tarjetahabiente, sin interferir el comercio. El 14. Una vez recibido el resultado de la transacción e informado
formulario de pago de Webpay despliega, entre otras cosas, el a Webpay su correcta recepción, el sitio del comercio debe
monto de la transacción, información del comercio como nombre redirigir al tarjetahabiente nuevamente a Webpay, con la
y logotipo, las opciones de pago a través de crédito o débito. finalidad de desplegar el comprobante de pago. Es importante
realizar este punto para que el tarjetahabiente entienda que
7. Tarjetahabiente ingresa los datos de la tarjeta, hace clic en el proceso de pago fue exitoso, y que involucrará un cargo a
pagar en formulario Webpay. su tarjeta bancaria. El redirecionamiento a Webpay se hace
utilizando como destino la URL informada por el método
8. Webpay procesa la solicitud de autorización (primero getTransactionResult() enviando por método POST el
autenticación bancaria y luego la autorización de la transacción). token de la transacción en la variable token_ws.
9. Una vez resuelta la autorización, Webpay retorna el control 15. Webpay recibe un requerimiento con la variable token_ws
al comercio, realizando un redireccionamiento HTTP/HTTPS
hacia la página de transición del comercio, en donde se envía por 16. Webpay identifica la transacción y despliega el comprobante
método POST el token de la transacción en la variable token_ws. de pago al tarjetahabiente.
El comercio debe implementar la recepción de esta variable.
17. Una vez visualizado el comprobante de pago por un
10. El navegador Web del tarjetahabiente realiza una petición periodo acotado de tiempo, el tarjetahabiente es redirigido de
HTTP/HTTPS al sitio del comercio, en base a la redirección vuelta al sitio del comercio, por medio de redireccionamiento
generada por Webpay en el punto 9. con el token en la variable token_ws enviada por método
POST hacia la página final informada por el comercio en el
11. El sitio del comercio recibe la variable token_ws e invoca el método initTransaction.
segundo método Web, getTransactionResult () (mientras
*2 se despliega la página de transición*2), para obtener el resultado 18. Sitio del comercio despliega página final de pago*3. *3
de la autorización. Se recomienda que el resultado de la
*2 El detalle de la página de transición se encuentra descrito en Anexo A, *3 El detalle de la página de final se encuentra descrito en Anexo A,
del documento de descripción general de la API SOAP. 12.1.2 del documento de descripción general de la API SOAP.

7.3 Flujo Alternativo: Secuencia de pago en una transacción

normal anulada en formulario de pago
7.3.1 Diagrama
El siguiente diagrama ilustra la secuencia de una transacción
normal donde el TH anula la transacción en el formulario de
pago de Webpay y cómo participan los distintos actores en
esta situación.
Ilustración 2: Botón anular formulario de pago en Webpay
sd Secuencia Flujo Webpay Transacción Anulada
2 initTransaction()
5 Request(token)
7 Anular()
8 Redirect()
9 Request(token)
10 Pagina final()
Ilustración 3: Diagrama de secuencia de pago en una transacción normal anulada en formulario de pago

7.3.2 Descripción secuencia de pago para transacción anulada resultado de la autorización. En este caso debe obtener una
en formulario de pago: excepción, pues el pago fue abortado.
1. Pasos de 1 a 6 son idénticos a la secuencia normal.
10. El comercio debe informar al tarjeta habiente que su pago
7. Tarjetahabiente hace clic en “anular”, en formulario Webpay. no se completó, según anexo glosa transacción no autorizada.
8. Webpay retorna el control al comercio, realizando un 7.4 Flujo Alternativo: Secuencia de pago en una transacción
redireccionamiento HTTP/HTTPS hacia la página de final del normal con evento de timeout
comercio, en donde se envía por método POST el token de la
transacción en la variable TBK_TOKEN. 7.4.1 Diagrama
El siguiente diagrama ilustra la secuencia de pago y cómo
9. El comercio con la variable TBK_TOKEN debe, invocar el participan los distintos actores en una transacción normal con
segundo método Web, getTransactionResult () (mientras evento de timeout.
*4 se despliega la página de transición*4), para obtener el
sd Secuencia Flujo Webpay Webservice Transacción
2 initTransaction()
5 Request(token)
7 Timeout()
8 Error() : Página de error
Ilustración 4: Diagrama de secuencia de timeout en transacción normal
*4 El detalle de la página de transición se encuentra descrito en Anexo

A, 12.1.1, del documento de descripción general de la API SOAP.

7.4.2 Descripción de secuencia alternativa, timeout: 7.5 Descripción de métodos del Servicio Web de Transacción
1. Pasos de 1 a 6 son idénticos a la secuencia normal. de Autorización Normal
7. Tarjetahabiente se encuentra en formulario Webpay, pero no A continuación se describen cada uno de las operaciones que
presiona pagar durante 10 minutos. Esto causa un timeout en deben ser utilizadas en una Transacción Normal.
dicho formulario.
7.5.1 Operación initTransaction
8. Webpay genera un error de timeout, se presenta una pantalla Método que permite iniciar una transacción de pago Webpay.
*5 indicando que ocurrió un error*5. Se regresa automáticamente
al comercio. 7.5.1.1 Parámetro de entrada
NOMBRE DESCRIPCIÓN
tns:wsTransactionType
WSTransactionType
Indica el tipo de transacción, su valor debe ser siempre TR_NORMAL_WS
xs:string
sessionId (Opcional) Identificador de sesión, uso interno de comercio, este valor es devuelto al final de la transacción.
Largo máximo: 61
xs:anyURI
returnURL (Obligatorio) URL del comercio, a la cual Webpay redireccionará posterior al proceso de autorización
Largo máximo: 256
xs:anyURI
finalURL (Obligatorio) URL del comercio a la cual Webpay redireccionará posterior al voucher de éxito de Webpay.
Largo máximo 256
tns:wsTransactionDetail
(Obligatorio) Lista de objetos del tipo wsTransactionDetail, el cual contiene datos de la transacción. Máxima
transactionDetails
cantidad de repeticiones es de 1 para este tipo de transacción.
wsTransactionDetail está descrito más adelante.
tns:wPMDetail
wPMDetail
(No se utiliza para Transacción Normal) Este campo contiene la transacción webpay mensual.
xs:string
(Opcional)Es el código único de identificación del comercio entregado por Transbank. Es obligatorio para
commerceId
transacción MALL.
Largo: 12
xs:string
buyOrder (Opcional) Es el código único de la orden de compra generada por el comercio. Es obligatorio para transacción
MALL.


TYPE WSTRANSACTIONDETAIL
Descripción: Tipo de dato contiene detalles de la transacción
CAMPO DESCRIPCIÓN
xs:decimal
amount Monto de la transacción. Máximo 2 decimales para USD.
Largo máximo: 10
xs:string
Orden de compra de la tienda.*6
buyOrder
Largo máximo: 26
La orden de compra puede tener: Números, letras, mayúsculas y minúsculas, y los signos |_=&%.,~:/?[+!@()>-
xs:string
commerceCode Código comercio de la tienda entregado por Transbank.
Largo: 12
sharesAmount Campo no utilizado
sharesNumber Campo no utilizado
7.5.1.2 Parámetros de salida:TypewsInitTransactionOutput 7.5.2 Operación getTransactionResult

Método que permite obtener el resultado de la transacción y
CAMPO DESCRIPCIÓN los datos de la misma.
xs:string 7.5.2.1 Parámetros de entrada
token Token de la transacción.
Largo: 64 CAMPO DESCRIPCIÓN
xs:string xs:string
url URL de formulario de pago Webpay tokenInput Token de la transacción.
Largo máximo: 256 Largo: 64
*6 Debe cumplir con caracteres permitidos.

7.5.2.2 Parámetros de salida: TypeTransactionResultOutput
CAMPO DESCRIPCIÓN
xs:string
buyOrder Orden de compra de la tienda.
Largo máximo: 26
xs:string
sessionId
Identificador de sesión, uso interno de comercio, este valor es devuelto al final de la transacción. Largo máximo: 61
Tns:carddetails
cardDetails
Objeto que representa los datos de la tarjeta de crédito del tarjeta habiente. cardDetails descrito más adelante.
xs:string
accoutingDate Fecha de la autorización.
Largo: 4, formato MMDD
xs:string
transactionDate Fecha y hora de la autorización.
Largo: 6, formato: MMDDHHmm
xs:string
Resultado de la autenticación para comercios Webpay Plus y/o 3D Secure, los valores posibles son los siguientes:
• TSY : Autenticación exitosa
• TSN : Autenticación fallida.
VCI • TO*7 : Tiempo máximo excedido para autenticación.
• ABO : Autenticación abortada por tarjetahabiente.
• U3 : Error interno en la autenticación.
• Puede ser vacío si la transacción no se autenticó.
Largo máximo: 3
xs:string
urlRedirection URL de redirección para visualización de voucher.
Largo máximo: 256
tns:wsTransactionDetailOutput
detailsOutput
detailsOutput Objeto que contiene el detalle de la transacción financiera. Descrito más adelante
TYPECARDDETAIL
Descripción: Tipo de dato contiene detalles de la tarjeta de crédito.
CAMPO DESCRIPCIÓN
xs:string
4 últimos números de la tarjeta de crédito del tarjeta habiente.
cardNumber
Solo para comercios autorizados por Transbank se envía el número completo.
Largo máximo: 16
xs:string
(Opcional) Fecha de expiración de la tarjeta de crédito del tarjetahabiente. Formato YYMM
cardExpirationDate
Solo para comercios autorizados por Transbank.
Largo máximo: 4
*7 VCI=TO indica que se produjo un time-out en el proceso de autenticación bancaria. Esta transacción no será autorizada y seguirá el flujo normal de eventos.

TYPEWSTRANSACTIONDETAILOUTPUT
Descripción: Tipo de dato contiene el detalle del resultado de la transacción.
CAMPO DESCRIPCIÓN
xs:string
authorizationCode Código de autorización de la transacción
Largo máximo: 6
xs:string
Tipo de pago de la transacción.
VD = Venta Débito
VN = Venta Normal
paymentTypeCode
VC = Venta en cuotas
SI = 3 cuotas sin interés
S2 = 2 cuotas sin interés
NC = N Cuotas sin interés
xs:string
Código de respuesta de la autorización. Valores posibles:
0 Transacción aprobada
-1 Rechazo de transacción
-2 Transacción debe reintentarse
responseCode -3 Error en transacción
-5 Rechazo por error de tasa
-6 Excede cupo máximo mensual
-7 Excede límite diario por transacción
-8 Rubro no autorizado
xs:decimal
Amount Monto de la transacción
Largo máximo: 10
xs:int
sharesNumber Cantidad de cuotas
Largo máximo: 2
xs:string
commerceCode Código comercio de la tienda
Largo: 12
xs:string
buyOrder Orden de compra de la tienda.
Largo máximo: 26
7.5.3 Operación acknowledgeTransaction

Método que permite informar a Webpay la correcta recepción
del resultado de la transacción.
En caso de llamar al método acknowledgeTransaction
7.5.3.1 Parámetros de entrada: acknowledgeTransaction después de 30 segundos de ocurrida la autorización, se informará
la excepción descrita más abajo y el comercio no debe entregar
CAMPO DESCRIPCIÓN producto o servicio, ya que la transacción ha sido reversada por
Webpay:
xs:string
token Token de la transacción. Timeout error (Transactions REVERSED) con código 277.
Largo: 64

8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL
8.1 Descripción de la Transacción de Autorización Mall

Normal Tienda
Pago
virtual
Una transacción Mall Normal corresponde a una solicitud de $1.000
1
autorización financiera de un conjunto de pagos con tarjetas de
crédito o débito, en donde quién realiza el pago ingresa al sitio del
comercio, selecciona productos o servicios, y el ingreso asociado Tienda
Tienda Pago
a los datos de la tarjeta de crédito o débito lo realiza una única vez virtual
mall $2.000
2
en forma segura en Webpay para el conjunto de pagos. Cada pago
tendrá su propio resultado, autorizado o rechazado.
Tienda
El Mall Webpay agrupa múltiples tiendas, son estas últimas las Pago
virtual
$3.000
que pueden generar transacciones. Tanto el mall como las tiendas N
asociadas son identificadas a través de un número denominado
código de comercio. El flujo de páginas para la transacción es el siguiente:

Resumen de los métodos del servicio Web de Transacción Mall Normal

Permite inicializar una transacción en Webpay. Como respuesta a la invocación se genera un token que representa
en forma única una transacción.
initTransaction
Es importante considerar que una vez invocado este método, el token que es entregado tiene un periodo
reducido de vida de 5 minutos, posterior a esto el token es caducado y no podrá ser utilizado en un pago.
getTransactionResult Permite obtener el resultado de la transacción una vez Webpay ha resuelto su autorización financiera.
Indica a Webpay que se ha recibido conforme el resultado de la transacción.
El método acknowledgeTransaction debe ser invocado siempre, independientemente del resultado

acknowledgeTransaction
entregado por el método getTransactionResult. Si la invocación no se realiza en un período de 30segundos,
Webpay reversará la transacción, asumiendo que el comercio no pudo informarse de su resultado, evitando así el
cobro al tarjetahabiente.

8.2 Secuencia de pago en una transacción de autorización Mall Normal

8.2.1 Diagrama
El siguiente diagrama ilustra la secuencia de pago y cómo participan los distintos actores en una transacción Mall Normal.
sd Secuencia Flujo Webpay Transacción Mall Normal
2 initTransaction()
5 Request(token)
7 Pagar()
8 Autoriza()
9 Redirect()
10 Request(token)
11 getTransactionResult(token...)
12 Response()
13 acknowledge Transaction(token)
14 Redirection(token)
15 Request(token)
16 Comprobante Webpay()
17 Request(token)
18 Pagina final()
Ilustración 5: Diagrama de secuencia de Transacción Mall Normal

8.2.2 Descripción de la secuencia 29. El sitio del comercio recibe la variable token_ws e invoca el
19. Una vez seleccionado los bienes o servicios, tarjetahabiente segundo método Web, getTransactionResult () (mientras
decide pagar a través de Webpay. se despliega la página de transición*8), para obtener el *8
resultado de la autorización. Se recomienda que el resultado
20. El comercio inicia una transacción en Webpay, invocando de la autorización sea persistida en los sistemas del comercio,
el método initTransaction(…). ya que este método se puede invocar una única vez por
transacción.
21. Webpay procesa el requerimiento y entrega como
resultado de la operación el token de la transacción y 30. Webpay responde el resultado de la invocación del método
URL de redireccionamiento a la cual se deberá redirigir al getTransactionResult().
tarjetahabiente.
31. Para informar a Webpay que el resultado de la transacción
22. Comercio redirecciona al tarjetahabiente hacia Webpay, se ha recibido sin problemas, el sistema del comercio consume
con el token de la transacción a la URL indicada en punto 3. La el tercer método acknowledgeTransaction().
redirección se realiza enviando por método POST el token en
variable token_ws. NOTA: De no ser consumido ó demorar más de 30 segundos
en su consumo, Webpay realizará la reversa de la transacción,
23. El navegador Web del tarjetahabiente realiza una petición asumiendo que existieron problemas de comunicación.
HTTPS a Webpay, en base al redireccionamiento generado
por el comercio en el punto 4. 32. Una vez recibido el resultado de la transacción e informado
a Webpay su correcta recepción, el sitio del comercio debe
24. Webpay responde al requerimiento desplegando redirigir al tarjetahabiente nuevamente a Webpay, con la
el formulario de pago de Webpay. Desde este punto la finalidad de desplegar el comprobante de pago. Es importante
comunicación es entre Webpay y el tarjetahabiente, sin interferir realizar este punto para que el tarjetahabiente entienda que
el comercio. El formulario de pago de Webpay despliega, entre el proceso de pago fue exitoso, y que involucrará un cargo a
otras cosas, el monto de la transacción, información del mall su tarjeta bancaria. El redirecionamiento a Webpay se hace
como nombre y logotipo,nombre y monto por cada tienda, las utilizando como destino la URL informada por el método
opciones de pago a través de crédito o débito. getTransactionResult() enviando por método POST el
token de la transacción en la variable token_ws.
25. Tarjetahabiente ingresa los datos de la tarjeta, hace clic en
pagar en formulario Webpay. 33. Webpay recibe un requerimiento con el token en la variable
token_ws valida que la transacción se encuentre aprobada.
26. Webpay procesa la solicitud de autorización para cada uno
de los pagos de las tiendas. 34. Webpay identifica la transacción y despliega el comprobante
de pago al tarjetahabiente.
27. Una vez resuelta la autorización de cada pago, Webpay
retorna el control al comercio, realizando un redireccionamiento 35. Una vez visualizado el comprobante de pago, el
HTTP/HTTPS hacia el sitio del comercio, en donde se envía tarjetahabiente es redirigido de vuelta al sitio del comercio,
por método POST el token de la transacción en la variable por medio de redireccionamiento con el token en la variable
token_ws. token_ws enviada por método POS, hacia la página final
informada por el comercio en el método initTransaction().
28. El navegador Web del tarjetahabiente realiza una petición
HTTP/HTTPS al sitio del comercio, en base a la redirección 36. Sitio del comercio despliega página final de pago*9. *9
generada por Webpay en el punto 9.
*8 El detalle de la página de transición se encuentra descrito en

*9 Anexo A, del documento de descripción general de la API SOAP.

8.3 Flujo Alternativo: Secuencia de pago en una transacción

mall normal anulada en formulario de pago
El siguiente diagrama ilustra la secuencia de una transacción

normal donde el TH anula la transacción en el formulario de pago
de Webpay y cómo participan los distintos actores en esta situación.
Ilustración 6. Botón anular formulario de pago en Webpay
sd Secuencia Flujo Webpay Transacción Anulada
2 initTransaction()
5 Request(token)
7 Anular()
8 Redirect()
9 Request(token)
10 Pagina final()
Ilustración 7: Diagrama de secuencia de pago en una transacción mall normal anulada en formulario de pago

8.3.1 Descripción de secuencia alternativa, anular: despliega la página de transición*10), para obtener el resultado *10
2. Pasos de 1 a 6 son idénticos a la secuencia normal. de la autorización. En este caso debe obtener una excepción,
pues el pago fue abortado.
11. Tarjetahabiente hace clic en “anular”, en formulario Webpay.
14. El comercio debe informar al tarjeta habiente que su pago
12. Webpay retorna el control al comercio, realizando un no se completó, según anexo glosa transacción no autorizada.
redireccionamiento HTTP/HTTPS hacia la página de final del
comercio, en donde se envía por método POST el token de la 8.4 Flujo Alternativo: Secuencia de pago en una transacción
transacción en la variable TBK_TOKEN. mall normal con evento de timeout
13. El comercio con la variable TBK_TOKEN debe, invocar 8.4.1 Diagrama

el segundo método Web, getTransactionResult()(mientras se
sd Secuencia Flujo Webpay Webservice Transacción
2 initTransaction()
5 Request(token)
7 Timeout()
8 Error() : Página de error
Ilustración 8: Diagrama de secuencia de Transacción con Timeout en Formulario


8.4.2 Descripción de secuencia alternativa, timeout: 8.5 Descripción de métodos del Servicio Web de Transacción
2. Pasos de 1 a 6 son idénticos a la secuencia normal. de Autorización Mall Normal
9. Tarjetahabiente está en formulario Webpay, pero no presiona A continuación, se describen cada uno de las operaciones que
pagar durante 10 minutos. Esto causa un timeout en dicho deben ser utilizadas en una Transacción Mall Normal.
formulario.
8.5.1 Operación initTransaction
10. Webpay genera un error de timeout, se presenta una Método que permite iniciar una transacción de pago Webpay.
pantalla indicando que ocurrió un error. No se regresa
automáticamente al comercio. 8.5.1.1 Parámetro de entrada
NOMBRE DESCRIPCIÓN
tns:wsTransactionType
WSTransactionType
Indica el tipo de transacción, su valor debe ser siempre TR_NORMAL_WS
xs:string
sessionId (Opcional) Identificador de sesión, uso interno de comercio, este valor es devuelto al final de la transacción.
Largo máximo: 61
xs:anyURI
returnURL (Obligatorio) URL del comercio, a la cual Webpayredireccionará posterior al proceso de autorización.
Largo máximo: 256
xs:anyURI
finalURL (Obligatorio) URL del comercio a la cual Webpayredireccionará posterior al voucher de éxito de Webpay.
Largo máximo 256
tns:wsTransactionDetail
(Obligatorio) Lista de objetos del tipo wsTransactionDetail, el cual contiene datos de la transacción. Máxima
transactionDetails
cantidad de repeticiones es de 1 para este tipo de transacción.
wsTransactionDetail está descrito más adelante.
tns:wPMDetail
wPMDetail
(No se utiliza para Transacción Normal) Este campo contiene la transacción webpay mensual.
xs:string
(Obligatorio)Es el código único de identificación del comercio entregado por Transbank.
commerceId En este caso el commerceID corresponde al código asignado al PST (o código mall), y que agrupa los códigos de
comercio que recibirán los pagos.
Largo: 12
xs:string
buyOrder
(Obligatorio)Es el código único de la orden de compra generada por el comercio mall.

TYPE WSTRANSACTIONDETAIL
Descripción: Tipo de dato contiene detalles de la transacción
CAMPO DESCRIPCIÓN
xs:decimal
amount Monto de la transacción. Máximo 2 decimales para USD.
Largo máximo: 10
xs:string
Orden de compra de la tienda.*11
buyOrder
Largo máximo: 26
La orden de compra puede tener: Números, letras, mayúsculas y minúsculas, y los signos |_=&%.,~:/?[+!@()>-
xs:string
commerceCode Código comercio de la tienda entregado por Transbank.
Largo: 12
sharesAmount Campo no utilizado
sharesNumber Campo no utilizado
8.5.1.2 Parámetros de salida:TypewsInitTransactionOutput 8.5.2 Operación getTransactionResult

Método que permite obtener el resultado de la transacción y
CAMPO DESCRIPCIÓN los datos de la misma.
xs:string 8.5.2.1 Parámetros de entrada
token Token de la transacción.
Largo: 64 CAMPO DESCRIPCIÓN
xs:string xs:string
url URL de formulario de pago Webpay tokenInput Token de la transacción.
Largo máximo: 256 Largo: 64
*11 Debe cumplir con el formato de caracteres permitidos

8.5.2.2 Parámetros de salida: TypeTransactionResultOutput
CAMPO DESCRIPCIÓN
xs:string
buyOrder Orden de compra del mall.
Largo máximo: 26
xs:string
sessionId
Identificador de sesión, uso interno de comercio, este valor es devuelto al final de la transacción. Largo máximo: 61
Tns:carddetails
cardDetails
Objeto que representa los datos de la tarjeta de crédito del tarjetahabiente. cardDetails descrito más adelante.
xs:string
accoutingDate Fecha de la autorización.
Largo: 4, formato MMDD
xs:string
transactionDate Fecha y hora de la autorización.
Largo: 6, formato: MMDDHHmm
xs:string
Resultado de la autenticación para comercios Webpay Plus y/o 3D Secure, los valores posibles son los siguientes:
• TSY : Autenticación exitosa
• TSN : Autenticación fallida.
VCI • TO*12 : Tiempo máximo excedido para autenticación.
• ABO : Autenticación abortada por tarjetahabiente.
• U3 : Error interno en la autenticación.
• Puede ser vacío si la transacción no se autenticó.
Largo máximo: 3
xs:string
urlRedirection URL de redirección para visualización de voucher.
Largo máximo: 256
tns:wsTransactionDetailOutput
detailsOutput
detailsOutput Objeto que contiene el detalle de la transacción financiera. Descrito más adelante
TYPECARDDETAIL
Descripción: Tipo de dato contiene detalles de la tarjeta de crédito.
CAMPO DESCRIPCIÓN
xs:string
4 últimos números de la tarjeta de crédito del tarjeta habiente.
cardNumber
Solo para comercios autorizados por Transbank se envía el número completo. La fecha de expiración llegara nula.
Largo máximo: 16
xs:string
(Opcional) Fecha de expiración de la tarjeta de crédito del tarjetahabiente. Formato YYMM
cardExpirationDate
Solo para comercios autorizados por Transbank.
Largo máximo: 4
*12 VCI=TO indica que se produjo un time-out en el proceso de autenticación bancaria. Esta transacción no será autorizada y seguirá el flujo normal de eventos.

TYPEWSTRANSACTIONDETAILOUTPUT
Descripción: Tipo de dato contiene el detalle del resultado de la transacción.
CAMPO DESCRIPCIÓN
xs:string
authorizationCode Código de autorización de la transacción
Largo máximo: 6
xs:string
Tipo de pago de la transacción.
VD = Venta Débito
VN = Venta Normal
paymentTypeCode
VC = Venta en cuotas
SI = 3 cuotas sin interés
S2 = 2 cuotas sin interés
NC = N Cuotas sin interés
xs:string
Código de respuesta de la autorización. Valores posibles:
0 Transacción aprobada
-2 Transacción debe reintentarse
responseCode -3 Error en transacción
-5 Rechazo por error de tasa
-6 Excede cupo máximo mensual
-7 Excede límite diario por transacción
-8 Rubro no autorizado
xs:decimal
Amount Monto de la transacción
Largo máximo: 10
xs:int
sharesNumber Cantidad de cuotas
Largo máximo: 2
xs:string
commerceCode Código comercio de la tienda
Largo: 12
xs:string
buyOrder Orden de compra del mall.
Largo máximo: 26
8.5.3 Operación acknowledgeTransaction

Método que permite informar a Webpay la correcta recepción
del resultado de la transacción.
En caso de llamar al método acknowledgeTransaction
8.5.3.1 Parámetros de entrada: acknowledgeTransaction después de 30 segundos de ocurrida la autorización, se informará
la excepción descrita más abajo y el comercio no debe entregar
CAMPO DESCRIPCIÓN producto o servicio, ya que la transacción ha sido reversada por
Webpay:
xs:string
token Token de la transacción. Timeout error (Transactions REVERSED) con código 277.
Largo: 64

9 TRANSACCIÓN ONECLICK
9.1 Descripción de la Transacción de OneClick

La modalidad de pago OneClick permite al tarjetahabiente realizar El proceso de integración con Webpay OneClick consiste en
pagos en el comercio sin la necesidad de ingresar cada vez desarrollar por parte del comercio las llamadas a los servicios web
información de la tarjeta de crédito al momento de realizar la compra. dispuestos por Transbank para la inscripción de los tarjetahabientes,
El modelo de pago contempla un proceso previo de inscripción o así como para la realización de los pagos.
enrolamiento del tarjetahabiente, a través del comercio, que desee
utilizar el servicio. Este tipo de pago facilita la venta, disminuye el 9.2 Resumen de los métodos del servicio Web
tiempo de la transacción y reduce los riesgos de ingreso erróneo de
los datos del medio de pago.

Permite realizar la inscripción del tarjetahabiente e información de su tarjeta de crédito. Retorna como respuesta
un token que representa la transacción de inscripción y una URL (UrlWebpay), que corresponde a la URL de
inscripción de OneClick.
initInscription
Una vez que se llama a este servicio Web, el usuario debe ser redireccionado vía POST a urlWebpay con parámetro
TBK_TOKEN igual al token obtenido.
Permite finalizar el proceso de inscripción del tarjetahabiente en OneClick.
Retorna el identificador del usuario en OneClick, el cual será utilizado para realizar las transacciones de pago.
finishInscription
Una vez terminado el flujo de inscripción en Transbank el usuario es enviado a la URL de fin de inscripción que
definió el comercio. En ese instante el comercio debe llamar a finishInscription.
Permite realizar transacciones de pago. Retorna el resultado de la autorización. Este método que debe ser
authorize
ejecutado, cada vez que el usuario selecciona pagar con OneClick.
Permite reversar una transacción de venta autorizada con anterioridad. Este método retorna como respuesta un
codeReverseOneClick
identificador único de la transacción de reversa.
9.3 Inscripción en Oneclick • El comercio envía el browser del cliente a la URL obtenida y
9.3.1 Descripción pasa por parámetro el token (método POST).
La inscripción es el proceso en el cual el tarjetahabiente registra
los datos de su tarjeta en Webpay OneClick para usarlo en • Webpay presenta el formulario de inscripción, este es similar al
compras futuras. Estos datos son almacenados de forma segura formulario de pago actual de Webpay Plus, para que el cliente
en Transbank, y nunca son conocidos por el comercio. ingrese los datos de su tarjeta.
Este proceso debe ser iniciado por la tienda del comercio y es • El cliente será autenticado por su banco emisor, de forma similar
requisito que el cliente esté autenticado en la página del comercio al flujo normal de pago. En este punto se realiza una transacción
antes de iniciar la inscripción. de $1 peso, la cual no se captura (no se verá reflejada en su
estado de cuenta).
Proceso:
• El cliente se conecta y autentica en la página del comercio, • Finalizada la inscripción, Webpay envía el browser del
mediante su nombre de usuario y clave. cliente a la URL entregada por el comercio, pasando por
parámetro el token.
• El cliente selecciona la opción de inscripción, la cual debe estar
explicada en la página del comercio. • El comercio debe consumir otro servicio web de Transbank,
con el token, para obtener el resultado de la inscripción y el
• El comercio consume un servicio web publicado por Transbank, identificador de usuario, que debe utilizar en el futuro para
donde entrega los datos del cliente y la URL de término; obtiene realizar los pagos.
un token y URL de Webpay.
• El comercio presenta al cliente el resultado de la inscripción.

9.3.2 Diagrama
Inscripción
CLIENTE COMERCIO WEBPAY BANCO

Login comercio
Selecciona
Inscripción Login comercio
username/email
Token initInscription
Token
Pantalla
ingreso de
datos tarjeta Datos tarjeta
Token banco
Pantalla
autenticación
del banco username y password
Token banco
Token
Token
finishInscription
user_tbk_id
Comercio
presenta
resultado
Ilustración 9: Diagrama de flujo proceso de inscripción

9.3.3 Método initInscription 9.5 Transacción de Pago Oneclick

El pago es el proceso donde el comercio solicita el cargo de una
Método Web Service compra a la tarjeta de crédito de un usuario inscrito anteriormente,
Permite gatillar el inicio del proceso de usando el identificador entregado por Transbank al momento de
initInscription
inscripción la inscripción.
{username}, {id usuario Transbank}
Recibe Los pagos en esta modalidad no requieren necesariamente la
Username : String (255)
intervención del usuario.
Id usuario Transbank : String (255)
{ booleano que indica si la inscripción fue dada
de baja correctamente) El monto del pago debe estar dentro de los límites establecidos
Retorna
para este tipo de transacciones, el proceso interno es similar a un
Return: boolean (true/false) cargo normal de Webpay.
Proceso:
• El cliente se conecta y autentica en la página o aplicación del
comercio mediante su nombre de usuario y clave.
Una vez que se llama a este webservice el usuario debe ser
redireccionado vía POST a urlWebpay con parámetro TBK_TOKEN
igual al token. • El cliente selecciona la opción de pagar con Webpay Oneclick.
• El comercio usa el servicio web de pago, publicado por

9.4 Eliminar registro de inscripción de usuario Transbank, entregando el identificador de usuario (que se obtuvo
En el caso que el comercio requiera eliminar la inscripción de en la inscripción), el monto del pago y la orden de compra.
un usuario en Webpay OneClick ya sea por la eliminación de un Obtiene la respuesta con el código de autorización.
cliente en su sistema o por la solicitud de este para no operar
con esta forma de pago, el comercio deberá consumir un servicio • El comercio presenta el resultado del pago al cliente.
web de Transbank con el identificador de usuario entregado en
la inscripción.
Pago
Método Web Service
Permite eliminar una inscripción de usuario en
removeUser
Transbank
{username}, {id usuario Transbank} CLIENTE COMERCIO WEBPAY
Login
Recibe
Username : String (255)
Id usuario Transbank : String (255)
{ booleano que indica si la inscripción fue dada Selecciona
de baja correctamente) producto
Retorna y pagar Pagar
id_user_tbk, monto
Return: boolean (true/false)
cod_autor, id_trx
Resultado
Ilustración 10: Diagrama de Flujo de Pago Oneclick.

Método Web Service El comercio, en caso de requerir reversar un pago, debe consumir
un servicio web publicado por Transbank con el identificador del
authorize Permite autorizar un pago.
pago entregado en la respuesta de la autorización de la transacción.
{username}, {id usuario Transbank}, {monto},
{orden de compra}.
String (255) Método Web Service
Recibe
String (255) Permite reversar una venta y se obtiene
Number (19,2) codeReverseOneClick el resultado de la reversa y un código de
String (255) reversa en caso que esta sea exitosa.
{código de respuesta}, {código de autorización}, {orden de compra}
}, {marca de tarjeta}, Recibe
Retorna Orden de compra: Long
{últimos 4 dígitos}, {id de la transacción}
Codigo de respuesta : Number (10,0) {reverseCode} {reversed}
Retorna reverseCode: Long
reversed: boolean (true/false)
9.6 Reversa de pagos autorizados
Este proceso permite reversar una venta cuando esta no pudo
El código regresado por este método, es un identificador único de
concretarse, dentro del mismo día contable, con la finalidad de
la transacción de reversa.
anular un cargo realizado al cliente.
9.7 Definición detallada de métodos del Servicio Web
finishInscription
INPUT
token Identificador del proceso de inscripción, entregado por Webpay en el método initInscription
OUTPUT
responseCode Código de retorno del proceso de inscripción, donde 0 (cero) es aprobado.
authCode Código que identifica la autorización de la inscripción.
creditCardType Indica el tipo de tarjeta que fue inscrita por el cliente ( Visa, AmericanExpress, MasterCard, Diners, Magna).
last4CardDigits Los últimos 4 dígitos de la tarjeta ingresada por el cliente en la inscripción.
tbkUser Identificador único de la inscripción del cliente, este debe ser usado para realizar pagos, o borrar la inscripción.

authorize
INPUT
amount Monto del pago en pesos.

tbkUser Identificador único de la inscripción del cliente.
username Nombre de usuario, del cliente, en el sistema del comercio.
Identificador único de la compra generado por el comercio. Debe ser timestamp [yyyymmddhhMMss] + un
correlativo de tres dígitos.
buyOrder
Ej: Para la tercera transacción realizada el día 15 de julio de 2011 a las 11:55:50 la orden de compra sería:
20110715115550003.
OUTPUT
Código de retorno del proceso de pago, donde:
0 (cero) es aprobado.
-1 Rechazo
-2 Rechazo
-3 Rechazo
-4 Rechazo
responseCode -5 Rechazo
-6 Rechazo
-7 Rechazo
-8 Rechazo
-97 Límites Oneclick, máximo monto diario de pago excedido
-98 Límites Oneclick, máximo monto de pago excedido
-99 Límites Oneclick, máxima cantidad de pagos diarios excedido
authCode Código de autorización de la transacción de pago.
last4CardDigits Indica el tipo de tarjeta que fue inscrita por el cliente (Visa, AmericanExpress, MasterCard, Diners, Magna).
creditCardType Los últimos 4 dígitos de la tarjeta ingresada por el cliente en la inscripción.
transactionId Identificador único de la transacción de pago, se utiliza para la reversa, si fuera necesario
removeUser
INPUT
tbkUser Identificador único de la inscripción del cliente

username Nombre de usuario, del cliente, en el sistema del comercio.
OUTPUT
booleano Retorno verdadero, si fue posible eliminar la inscripción. Falso de lo contrario.
El proceso de integración con Webpay Oneclick consiste en

desarrollar por parte del comercio las llamadas a los servicios
web dispuestos por Transbank para la inscripción de los
tarjetahabientes, así como para la realización de los pagos.
Resumen de los métodos del servicio Web

10 TRANSACCIÓN DE CAPTURA DIFERIDA
10 TRANSACC IÓN DE CAPTURA DIFERIDA
10.1 Descripción de la captura diferida con autorización sin captura y el monto requerido para capturar el
Este método permite a todo comercio habilitado realizar capturas de cual debe ser menor o igual al monto originalmente autorizado.
una transacción autorizada sin captura en plataforma Webpay 3G.
El método contempla una única captura por cada autorización. Para Las ejecuciones con errores entregarán un SoapFault de acuerdo
ello se deberá indicar los datos asociados a la transacción de venta a la codificación de errores definida.
Resumen del método del servicio web de captura diferida

Permite solicitar a Webpay la captura diferida de una transacción con autorización y sin captura simultánea.
capture
El método capture debe ser invocado siempre indicando el código del comercio que realizó la transacción.
En el caso de comercios MALL, el código debe ser el código de la tienda virtual.
10.2 Descripción del método del servicio web de captura diferida

10.2.1 Operación capture
Método que permite realizar la captura de una transacción.
PARÁMETROS DE ENTRADA
CAMPO DESCRIPCIÓN
xs:string
authorizationCode Código de autorización de la transacción que se requiere capturar
Largo máximo: 6
xs:string
buyOrder Orden de compra de la transacción que se requiere capturar
Largo máximo: 26
xs:long
commerceId Código de comercio o tienda mall que realizó la transacción
Largo: 12
xs:decimal
captureAmount Monto que se desea capturar
Largo máximo: 10
PARÁMETROS DE SALIDA
CAMPO DESCRIPCIÓN
xs:string
token
Token de la transacción
xs:string
authorizationCode
Código de autorización de la captura diferida
xs:dateTime
authorizationDate
Fecha y hora de la autorización
xs:decimal
captureAmount
Monto capturado

10 TRANSACCIÓN DE CAPTURA DIFERIDA
10.2.2 Códigos de error

Los siguientes son códigos de error exclusivos del método Capture
CÓDIGO DESCRIPCIÓN
304 Validación de campos de entrada nulos
245 Código de comercio no existe
22 El comercio no se encuentra activo
316 El comercio indicado no corresponde al certificado o no es hijo del comercio MALL en caso de transacciones MALL
308 Operación no permitida
274 Transacción no encontrada
16 La transacción no es de captura diferida
292 La transacción no está autorizada
284 Periodo de captura excedido
310 Transacción reversada previamente
309 Transacción capturada previamente
311 Monto a capturar excede el monto autorizado
315 Error del autorizador

11 TRANSACCIÓN DE ANULACIÓN
11.1 Descripción de la anulación autorizado en la venta en línea.

Este método permite a todo comercio habilitado anular una
transacción que fue generada en plataforma Webpay 3G. El método Webpay soporta una sola anulación parcial para la transacción de
contempla anular total o parcialmente una transacción. Para ello venta en línea. En caso de enviar una segunda anulación parcial se
se deberá indicar los datos asociados a la transacción de venta en retornará una Exception.
línea que se desea anular y los montos requeridos para anular. Se
considera totalmente anulada una transacción cuando el monto Las ejecuciones con errores entregarán un SoapFault de acuerdo a
anulado o el monto total de anulaciones cursadas alcancen el monto la codificación de errores definida.
Resumen del método del servicio web de anulación de transacciones

Permite solicitar a Webpay la anulación de una transacción realizada previamente y que se encuentra vigente.
Nullify
El método nullify debe ser invocado siempre indicando el código del comercio que realizó la transacción.
En el caso de comercios MALL, el código debe ser el código de la tienda virtual.
11.2 Descripción del método del servicio web de anulación de 10.2.1 Operación nullify
transacciones Método que permite anular una transacción de pago Webpay.
PARÁMETROS DE ENTRADA
CAMPO DESCRIPCIÓN
xs:string
Código de autorización de la transacción que se requiere anular. Para el caso que se esté anulando una transacción
authorizationCode
de captura en línea, este código corresponde al código de autorización de la captura.
Largo máximo: 6
xs:decimal
Monto autorizado de la transacción que se requiere anular. Para el caso que se esté anulando una transacción de
authorizedAmount
captura en línea, este monto corresponde al monto de la captura.
Largo máximo: 10
xs:string
buyOrder Orden de compra de la transacción que se requiere anular
Largo máximo: 26
xs:long
commerceId Código de comercio o tienda mall que realizó la transacción
Largo: 12
xs:decimal
ullifyAmount Monto que se desea anular de la transacción
Largo máximo: 10
PARÁMETROS DE SALIDA
CAMPO DESCRIPCIÓN
xs:string
token
Token de la transacción
xs:string
authorizationCode
Código de autorización de la anulación
xs:dateTime
authorizationDate
Fecha y hora de la autorización
xs:decimal
Balance
Saldo actualizado de la transacción (considera la venta menos el monto anulado)
xs:decimal
nullifiedAmount
Monto anulado

11.2.2 Códigos de error

Los siguientes códigos de error son los más comunes asociados al método de anulación
CÓDIGO DESCRIPCIÓN
304 Validación de campos de entrada nulos
245 Código de comercio no existe
22 El comercio no se encuentra activo
316 El comercio indicado no corresponde al certificado o no es hijo del comercio MALL en caso de transacciones MALL
308 Operación no permitida
274 Transacción no encontrada
16 La transacción no permite anulación
292 La transacción no está autorizada
284 Periodo de anulación excedido
310 Transacción anulada previamente
311 Monto a anular excede el saldo disponible para anular
312 Error genérico para anulaciones
315 Error del autorizador

12 ANEXOS
12 ANEXOS
12.1 Anexo A: Creación de llaves y ambientes Webpay

12.1.1 Creación de llave privada y certificado público 1. Crear llave privada
Este es un ejemplo para crear la llave privada, el CSR y el En un terminal o consola, utilizando openSSL, cree la llave
certificado público productivo de un comercio cuyo código de utilizando el siguiente comando
comercio productivo es 12345678
openssl genrsa -out 597012345678.key 2048
2. Crear requerimiento de certificado siguiente comando deberá crear el requerimiento de certificado

Manteniendo en el mismo directorio la llave privada, utilizando el (archivo csr)
openssl req -new -key 597012345678.key -out 597012345678.csr
Le solicitará ingresar los siguientes datos, teniendo especial Lo que generará un archivo llamado 59702012345678.csr
cuidado en ingresar el código de comercio productivo, ya
entregado por Transbank, en el campo Common Name (CN)
como sigue:
Country Name (2 letter code) []:CL

State or Province Name (full name) []: Ingrese_su_provincia
Locality Name (eg, city) []:Ingrese_su_ciudad
Organization Name (eg, company) []: Ingrese_el_nombre_de_su_organizacion
_el Organizational Unit Name (eg, section) []: Ingrese_un_nombre_opcional
Common Name (eg, your name or your server’s hostname) []:597012345678
Email Address []:
Please enter the following ‘extra’ attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:
3. Crear certificado autofirmado público utilizando el siguiente comando, procurando indicar 1460
on la llave privada y el CSR creados, debe crear el certificado días o más, para la duración de la validez del certificado
openssl x509 -req -days 1460 -in 597029124456.csr -signkey 597029124456.key -out 597012345678.crt
Con todos los pasos, obtendrá 3 archivos:

• 59702012345678.key
• 59702012345678.csr
El comercio es responsable por resguardar su llave privada y
• 59702012345678.crt
su certificado público, como asimismo es responsable por reemplazar
estos cuando caduquen.
Y es éste último (crt) es el que el comercio comparte con
Transbank para la habilitación de su comercio en producción.

12 ANEXOS
12.1.2 Ambientes de Webpay

Endpoint integración / Validación
https://webpay3gint.transbank.cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl

Certificado público Webpay integración
-----BEGIN CERTIFICATE-----
MIIDKTCCAhECBFZl7uIwDQYJKoZIhvcNAQEFBQAwWTELMAkGA1UEBhMCQ0wxDjAMBgNVBAgMBUNo
aWxlMREwDwYDVQQHDAhTYW50aWFnbzEMMAoGA1UECgwDa2R1MQwwCgYDVQQLDANrZHUxCzAJBgNV
BAMMAjEwMB4XDTE1MTIwNzIwNDEwNloXDTE4MDkwMjIwNDEwNlowWTELMAkGA1UEBhMCQ0wxDjAM
BgNVBAgMBUNoaWxlMREwDwYDVQQHDAhTYW50aWFnbzEMMAoGA1UECgwDa2R1MQwwCgYDVQQLDANr
ZHUxCzAJBgNVBAMMAjEwMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAizJUWTDC7nfP
3jmZpWXFdG9oKyBrU0Bdl6fKif9a1GrwevThsU5Dq3wiRfYvomStNjFDYFXOs9pRIxqX2AWDybjA
X/+bdDTVbM+xXllA9stJY8s7hxAvwwO7IEuOmYDpmLKP7J+4KkNH7yxsKZyLL9trG3iSjV6Y6SO5
EEhUsdxoJFAow/h7qizJW0kOaWRcljf7kpqJAL3AadIuqV+hlf+Ts/64aMsfSJJA6xdbdp9ddgVF
oqUl1M8vpmd4glxlSrYmEkbYwdI9uF2d6bAeaneBPJFZr6KQqlbbrVyeJZqmMlEPy0qPco1TIxrd
EHlXgIFJLyyMRAyjX9i4l70xjwIDAQABMA0GCSqGSIb3DQEBBQUAA4IBAQBn3tUPS6e2USgMrPKp
sxU4OTfW64+mfD6QrVeBOh81f6aGHa67sMJn8FE/cG6jrUmX/FP1/Cpbpvkm5UUlFKpgaFfHv+Kg
CpEvgcRIv/OeIi6Jbuu3NrPdGPwzYkzlOQnmgio5RGb6GSs+OQ0mUWZ9J1+YtdZc+xTga0x7nsCT
5xNcUXsZKhyjoKhXtxJm3eyB3ysLNyuL/RHy/EyNEWiUhvt1SIePnW+Y4/cjQWYwNqSqMzTSW9TP
2QR2bX/W2H6ktRcLsgBK9mq7lE36p3q6c9DtZJE+xfA4NGCYWM9hd8pbusnoNO7AFxJZOuuvLZI7
JvD7YLhPvCYKry7N6x3l
-----END CERTIFICATE-----
Endpoint Producción
https://webpay3g.transbank.cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl
Certificado público productivo de Webpay
-----BEGIN CERTIFICATE-----
MIIDNDCCAhwCCQCJEQxY1moacjANBgkqhkiG9w0BAQsFADBcMQswCQYDVQQGEwJD
TDELMAkGA1UECBMCUk0xETAPBgNVBAcTCFNhbnRpYWdvMRIwEAYDVQQKEwl0cmFu
c2JhbmsxDDAKBgNVBAsTA1BSRDELMAkGA1UEAxMCMTAwHhcNMTQwNTA4MjEwNjIy
WhcNMTgwNTA4MjEwNjIyWjBcMQswCQYDVQQGEwJDTDELMAkGA1UECBMCUk0xETAP
BgNVBAcTCFNhbnRpYWdvMRIwEAYDVQQKEwl0cmFuc2JhbmsxDDAKBgNVBAsTA1BS
RDELMAkGA1UEAxMCMTAwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCk
ag5P6b/BnlpxGk1YX8OeX04ZqmxWThxHP1J+6FVj/hMYw9JGf2gMDCWd3fYaWwRM
X7Y6MidAGCiVwNgsixsUad9C2qQWtpTHoc3T+rQuZ6wmGwxc/K/Gcjf4nuJQUPBo
3zjat+HC0HzPrTscms4A2EZ2VQ/bbznKiOWxcBSqqZ/8jK/RMmu4E6Pzj8Ms+vbA
BfDCq9GDfeNZ+gtQna86enEX7XY/N55SO+VHv/6zGIof7kGIobeF1hYwALrKDhvy
FVQgh4VUBhP0adtnQBfCc1mGVgnviAjioxMxGT4wwaj6IfTvtHhkxVcJ9qmX9oki
wygTooWtcMM6U4oiVd+vAgMBAAEwDQYJKoZIhvcNAQELBQADggEBAEqW5DtWdAUP
iSBpExhPgSnm+X6eiDmM3q0S8gWls3hnZCQ9RfhVROj93OS4Zaqg82RLGiU3GsWF
pj4YRw0flCC7bCxo7Mt4Lvv6ihQYdsWxA97HN55HQOVv853kQAu6/vnCxoTtMt6W
+zuiQY7hhabLhOCNJcrFpabj0wCO62IrWv65AZlikcsNKLAwQrstY7Y1VU5DOcXy
FfE5niUGxH0mARXMxq1Z3CBqJ3GKKMmngqCMxX8ZFjIvz0z0VsOJQheX4Hl8prAR
ZlVlkH02xlKKLIO2tcnXik1eW5VCpzuF6z9W3WqcvpaltfspJPx3kN3k5NHATNgk
IypDl0jmq2w=
-----END CERTIFICATE-----

12 ANEXOS
12.2 Anexo B: Requerimientos de páginas de transición y de • Monto y moneda de la transacción

página de fin de transacción • Código de autorización de la transacción
12.2.1 Requerimientos Página de Transición • Fecha de la transacción
La página de transición de comercio, es la página que muestra • Tipo de pago realizado (Débito o Crédito)
el comercio cuando Webpay le entrega el control, después del • Tipo de cuota
proceso de autorización y previo a redirigir al tarjeta habiente al • Cantidad de cuotas
comprobante de éxito de la transacción. Aplica para todos los • 4 últimos dígitos de la tarjeta bancaria
tipos de transacciones. • Descripción de los bienes y/o servicios
Es recomendable que en esta página muestre la imagen de 12.2.3 Requerimientos Página final de fracaso
background del formulario de pago, que se encuentra en la URL Cuando la transacción no sea autorizada, se recomienda
informar al tarjetahabiente al respecto. Puede presentar un texto
https://webpay3g.transbank.cl/ explicativo como:
webpayserver/imagenes/background.gif
Orden de Compra XXXXXXX

12.2.2 Requerimientos Página final de éxito
Una vez finalizada a transacción, el comercio debe presentar una Las posibles causas de este rechazo son:
página al tarjetahabiente para que este se informe del resultado
- Error en el ingreso de los datos de su tarjeta de Crédito
de la transacción. La información a presentar dependerá de si la
o Débito (fecha y/o código de seguridad).
transacción fue autorizada o no.
- Su tarjeta de Crédito o Débito no cuenta con saldo
Se recomienda, como mínimo, que posea suficiente.
• Número de orden de Pedido - Tarjeta aun no habilitada en el sistema financiero.
• Nombre del comercio (Tienda de Mall)

12 ANEXOS
12.2 Anexo C: Excepciones SOAP API Webpay

Las excepciones más comunes que pueden ser presentadas en cualquier integración Webpay en su modalidad SOAP, son las siguientes.
# ERROR # ERROR
1 ERR_LECTURA_INPUT 40 ERR_CONF_TIENDA
2 ERR_LECTURA_PARAMETROS 41 ERR_URL_RESULTADO
3 ERR_PARAM_CODIGO_COMERCIO 42 ERR_CONECTA_SERVIDOR
4 ERR_PARAM_URL_CGI_COMERCIO 43 ERR_SOCKET_LECTURA
5 ERR_PARAM_SERVIDOR_COMERCIO 44 ERR_SOCKET_ESCRITURA
6 ERR_PARAM_PUERTO_COMERCIO 45 ERR_TIMEOUT_ACK
7 ERR_PARAM_URL_CGI_TRANSBANK 46 ERR_OBTENER_ACK
8 ERR_PARAM_SERVIDOR_TRANSBANK 47 ERR_ORDEN_TIENDA
9 ERR_PARAM_PUERTO_TRANSBANK 48 ERR_NUMERO_TARJETA
10 ERR_MEM_MENSAJE 49 ERR_NUMERO_CUOTAS
11 ERR_MAC 50 ERR_MES_VENCIMIENTO
12 ERR_VERSION_KCC 51 ERR_ANO_VENCIMIENTO
13 ERR_MSG_OLDKCC 52 ERR_TARJETA
14 ERR_CODIGO_COMERCIO 53 ERR_TIPO_PAGO
15 ERR_DATOS_COMERCIO 54 ERR_RESPUESTA_BASE24
16 ERR_TIPO_TRANSACCION 55 ERR_ACK
17 ERR_URL_CGI_COMERCIO 57 ERR_TIENDA_EN_NULO
18 ERR_SERVIDOR_COMERCIO 58 ERR_PARAM_PREF_CONF_TR
19 ERR_PUERTO_COMERCIO 59 ERR_PARAM_URL_CONF_TR
20 ERR_CVV 60 ERR_PARAM_PUERTO_CONF_TR
21 ERR_DUPLICADO 61 ERR_PARAM_SERVIDOR_CONF_TR
22 ERR_ESTADO_COMERCIO 62 ERR_FECHA_TRANSACCION
23 ERR_TEMPLATE_COMPRA 63 ERR_ABRIR_BITACORA
24 ERR_TEMPLATE_COMPRA_DET 64 ERR_FALLO_CUOTA_NORMAL
25 ERR_FECHA_EXPIRACION 65 ERR_FALLO_CUOTA_C3C
26 ERR_MONEDA_INVALIDA 66 ERR_MONEDA_DESCONOCIDA
27 ERR_TEMPLATE_REINTENTO 67 ERR_TIENDA_NOENCONTRADA
28 ERR_EDITA_MONTO 68 ERR_TIENDA_NOASOCIADA
29 ERR_ORDEN_COMPRA 69 ERR_TIENDA_DIF_MONEDA
30 ERR_ID_TRANSACCION 70 ERR_SINMEMORIA
31 ERR_URL_EXITO 71 ERR_MONTO_DESCUADRADO
32 ERR_URL_FRACASO 72 ERR_TRX_DESCUADRADAS
33 ERR_MONTO 73 ERR_TEMPLATE_ONECLICK
34 ERR_REFERER 74 ERR_TIENDA_TIPO_PAGO
35 ERR_NUM_TRX 75 ERR_ID_USUARIO
36 ERR_MAX_TIENDA 76 ERR_USUARIO_YA_REGISTRADO
37 ERR_CODIGO_TIENDA 77 ERR_INSERTAR_ONECLICK
38 ERR_TIENDA_NO_SOCIADA 78 ERR_USUARIO_NO_REGISTRADO
39 ERR_MONTO_TIENDA 79 ERR_LEER_ONECLICK

12 ANEXOS
# ERROR # ERROR
80 ERR_TEMPLATE_TRANSICION 121 ERR_LARGO_TIPO_TBK_PUERTO_COMERCIO
81 ERR_LOGO_WEBPAY 122 ERR_LEN_TBK_VERSION_KCC
82 ERR_TEMPLATE_LOGO_WEBPAY 123 ERR_LEN_TBK_MAC
83 ERR_ACTUALIZAR_ONECLICK 124 ERR_LEN_TBK_MONTO
84 ERR_ELIMINAR_ONECLICK 125 ERR_LEN_TBK_ORDEN_COMPRA
85 ERR_TEMPLATE_MENSAJE 126 ERR_LEN_TBK_ID_SESION
86 ERR_NUMERO_TARJET_ANTIGUA 127 ERR_LEN_TBK_URL_EXITO
87 ERR_ONECLICK_DESHABILITADO 128 ERR_LEN_TBK_URL_FRACASO
88 ERR_TR_COMPLETA_DESHABILITADA 129 ERR_LEN_TBK_TARJETA
89 ERR_CAMBIO_MULTICODE 130 ERR_LEN_TBK_TIPO_PAGO
90 ERR_RESPUESTA 131 ERR_LEN_TBK_NUMERO_CUOTAS
91 ERR_LARGO_TIENDA 132 ERR_LEN_TBK_NUMERO_TARJETA
92 ERR_CORRESPONDENCIA_CUOTAS 133 ERR_LEN_TBK_MES_VENCIMIENTO
93 ERR_TIPO_PAGO_DESHABILITADO 134 ERR_LEN_TBK_ANO_VENCIMIENTO
94 ERR_ENVIO_REG_ONECLICK 135 ERR_LEN_TBK_CVV
95 ERR_ID_SESION 136 ERR_TIPO_TBK_URL_RESULTADO
96 ERR_TIPO_TBK_TIPO_TRANSACCION 137 ERR_TIPO_TBK_NUM_TRX
97 ERR_TIPO_TBK_CODIGO_COMERCIO 138 ERR_TIPO_TBK_CODIGO_TIENDA
98 ERR_TIPO_TBK_ID_TRANSACCION 139 ERR_TIPO_TBK_ORDEN_TIENDA
99 ERR_TIPO_TBK_URL_CGI_COMERCIO 140 ERR_TIPO_TBK_MONTO_TIENDA
100 ERR_TIPO_TBK_SERVIDOR_COMERCIO 141 ERR_TIPO_TBK_ID_USUARIO
101 ERR_TIPO_TBK_PUERTO_COMERCIO 142 ERR_LEN_TBK_URL_RESULTADO
102 ERR_TIPO_TBK_VERSION_KCC 143 ERR_LARGO_TIPO_TBK_NUM_TRX
103 ERR_TIPO_TBK_MAC 144 ERR_LARGO_TIPO_TBK_CODIGO_TIENDA
104 ERR_TIPO_TBK_MONTO 145 ERR_LARGO_TIPO_TBK_ORDEN_TIENDA
105 ERR_TIPO_TBK_ORDEN_COMPRA 146 ERR_LARGO_TIPO_TBK_MONTO_TIENDA
106 ERR_TIPO_TBK_ID_SESION 147 ERR_LARGO_TIPO_TBK_ID_USUARIO
107 ERR_TIPO_TBK_URL_EXITO 148 ERR_LEN_PARAM_TR_NORMAL
108 ERR_TIPO_TBK_URL_FRACASO 149 ERR_LEN_PARAM_TR_MALL
109 ERR_TIPO_TBK_TARJETA 150 ERR_LEN_PARAM_TR_COMPLETA
110 ERR_TIPO_TBK_TIPO_PAGO 151 ERR_LEN_PARAM_TR_ONECLICK
111 ERR_TIPO_TBK_NUMERO_CUOTAS 152 ERR_LEN_PARAM_TR_INGRESO_ONECLICK
112 ERR_TIPO_TBK_NUMERO_TARJETA 153 ERR_LEN_PARAM_TR_ELIMINACION_ONECLICK
113 ERR_TIPO_TBK_MES_VENCIMIENTO 154 ERR_LEN_PARAM_TR_MODIFICACION_ONECLICK
114 ERR_TIPO_TBK_ANO_VENCIMIENTO 155 ERR_LEN_PARAM_TR_MALL_COMPLETA
115 ERR_TIPO_TBK_CVV 156 ERR_LEN_PARAM_TR_MALL_ONECLICK
116 ERR_LEN_TBK_TIPO_TRANSACCION 157 ERR_LEN_PARAM_TR_LOGO_WEBPAY
117 ERR_LEN_TBK_CODIGO_COMERCIO 158 ERR_CANT_PARAM_TR_NORMAL
118 ERR_LEN_TBK_ID_TRANSACCION 159 ERR_CANT_PARAM_TR_MALL
119 ERR_LEN_TBK_URL_CGI_COMERCIO 160 ERR_CANT_PARAM_TR_COMPLETA
120 ERR_LEN_TBK_SERVIDOR_COMERCIO 161 ERR_CANCOMERCIOT_PARAM_TR_ONECLICK

12 ANEXOS
# ERROR # ERROR
162 ERR_CANT_PARAM_TR_INGRESO_ONECLICK 264 ERR_TOKEN_INVFOR
163 ERR_CANT_PARAM_TR_ELIMINACION_ONECLICK 265 ERR_BUFF_OVERFLOW
164 ERR_CANT_PARAM_TR_MODIFICACION_ONECLICK 266 ERR_TRANSACCION_DEBITO_NO_PERMITIDA
165 ERR_CANT_PARAM_TR_MALL_COMPLETA 267 ERR_TRANSACCION_NECESITA_AUTENTICAR
166 ERR_CANT_PARAM_TR_MALL_ONECLICK 268 ERR_TRANSACCION_DEBITO_FALTA_PARAMETRO
167 ERR_CANT_PARAM_TR_LOGO_WEBPAY 269 ERR_CORRESPONDENCIA_TRANSACCION_DEBITO
170 ERR_TIPO_TBK_FECHA_EXPIRACION 270 ERR_CANT_PARAM_COMUNES
171 ERR_LEN_TBK_FECHA_EXPIRACION 271 ERR_FALTA_PARAM
172 ERR_TIPO_TBK_URL_COMERCIO 272 ERR_TIMEOUT
173 ERR_LEN_TIPO_TBK_URL_COMERCIO 273 ERR_MONTO_CERO
174 ERR_TIPO_TBK_MONTO_CUOTA 274 ERR_TRANSACCION_NO_ENCONTRADA
175 ERR_LEN_TBK_MONTO_CUOTA 275 ERR_INSTRUMENTO_DE_PAGO
176 ERR_MONTO_CUOTA 276 ERR_IR_PAGINA_FALLO
177 ERR_TR_TASA_INTERES_DESHABILITADA 277 ERR_TIPO_CONEXION_COMERCIO
178 ERR_LEN_PARAM_TR_TASA_INTERES_MAX 278 ERR_MALL_NO_IGUAL_TIENDA
179 ERR_CANT_PARAM_TR_TASA_INTERES_MAX 279 ERR_MALL_SIN_TIENDA
180 ERR_CONSISTENCIA_CIC 280 ERR_HTTP
181 ERR_FALLO_CUOTA_CIC 281 ERR_FILE_POPULATOR
241 ERR_TBK_TOKEN_NO_ENCONTRADO 282 ERR_FORMAT_PARAM
242 ERR_RESPUESTA_AUTH 283 ERR_ENCRIPTATION
243 ERR_EMISOR_NO_ENCONTRADO 284 ERR_EXPIRED_TIME
244 ERR_ARCHIVO_EMISOR 285 ERR_RUT
245 ERR_COMERCIO_NO_ENCONTRADO 286 ERR_SET_STATUS
246 ERR_ARCHIVO_COMERCIO 287 ERR_PARAM_LEN
247 ERR_BIN_NO_ENCONTRADO 288 ERR_DOUBLE_SUBMIT
248 ERR_ARCHIVO_BINES 289 ERR_INCONSISTENT_BIN_INFO
249 ERR_EMISOR_NO_PARTICIPA 290 ERR_VCI_DECISION_TABLE
250 ERR_COMERCIO_NO_PARTICIPA 291 ERR_NOT_FOUND_PARAM
251 ERR_TRANSACCION_NO_PARTICPA 292 ERR_INVALID_STATUS
252 ERR_NO_SE_PUEDE_GENERAR_TOKEN 293 ERR_INVOCATION_METHOD
253 ERR_BIN_NO_PARTICIPA 294 ERR_ANOTHER_TRANSACCION
254 ERR_VVR 295 ERR_SEND_MAIL
255 ERR_TOKEN_STATUS 296 ERR_UNKNOWN
256 ERR_GEN_TOKENCOM 300 ERR_INVALID_TOKEN
257 ERR_SIN_VALIDACION 301 ERR_MALL_COMMERCES_MAX
258 ERR_TBK_PARAM 302 ERR_BUTTON_COMMERCE_NOT_FOUND
259 ERR_SSL_CONEXION 303 ERR_COMMERCE_NOT_WPM
260 ERR_SSL_ESCRITURA 304 ERR_INVALID_INPUT_DATA
261 ERR_SSL_REINTENTAR 305 ERR_COMMERCE_WPM
262 ERR_SSL_LECTURA 306 ERR_COMMERCE_SIGNATURE_MATCH
263 ERR_PUB_KEY 307 ERR_COMMERCE_NOT_FOUND

12 ANEXOS
# ERROR # ERROR
308 ERR_OPERATION_NOT_ALLOWED 319 ERR_CAPTURE_GENERIC
309 ERR_TRANSACTION_ALREADY_CAPTURED 320 ERR_COMMERCES_UNRELATED
310 ERR_TRANSACTION_NULLIFIED 321 ERR_DETAIL_NOT_FOUND
311 ERR_EXCEEDED_REQUIRED_BALANCE 322 ERR_PAYMENT_TYPE_NUMBER
312 ERR_NULLIFY_GENERIC 323 ERR_UF_SERVICE_ERROR
313 ERR_COMMERCE_NOT_INTELLIGENT ERR_DEFERRED_CAPTURE_NOT_ALLOWED_
324
314 ERR_PAYMENT_TYPE_NOT_FOUND TRANSACTION_TYPE
315 ERR_DEFERRED_PERIOD_NOT_FOUND 325 ERR_ONECLICK_HABILITADO

316 ERR_QUERY_SHARE_NOT_FOUND 326 ERR_INVALID_KEY
317 ERR_INCOMPATIBLE_PAYMENT_TYPE 327 ERR_COMMERCE_WSCT_WITH_ONLINE_CAPTURE
318 ERR_GRACE_FLAG_NOT_ENABLED 328 ONE_CLICK_REVERSE_TIMEOUT
12.4 Anexo D: Pruebas de validación efectuada por Transbank

12.4.1 Pruebas de validación para Transacción Normal, 12.4.3 Pruebas de validación para Transacción Normal
modalidad plugin captura diferida
• Pago crédito exitoso sin cuotas • Pago crédito exitoso sin cuotas
• Pago crédito exitoso con cuotas • Pago crédito exitoso con cuotas
• Pago crédito denegado • Pago crédito denegado
• Pago débito exitoso • Pago cancelado (abortado en formulario Webpay)
• Pago débito denegado • Anulación parcial (solo si integra el método)
• Pago cancelado (abortado en formulario Webpay) • Anulación total (solo si integra el método)
12.4.2 Pruebas de validación para Transacción Normal 12.4.4 Pruebas de validación para Transacción Mall
• Pago crédito exitoso sin cuotas • Pago crédito exitoso sin cuotas
• Pago crédito exitoso con cuotas • Pago crédito exitoso con cuotas
• Pago crédito denegado • Pago crédito denegado
• Pago débito exitoso • Pago débito exitoso
• Pago débito denegado • Pago débito denegado
• Anulación parcial (solo si integra el método) • Anulación parcial (solo si integra el método)
• Anulación total (solo si integra el método) • Anulación total (solo si integra el método)
• Pago cancelado (abortado en formulario Webpay) • Pago cancelado (abortado en formulario Webpay)

12.4.5 Pruebas de validación para Transacción OneClick
• Inscripción rechazada
• Inscripción exitosa
• Autorización
• Reversa

• Remover usuario

12 ANEXOS
12.5 Anexo D: Referencias
https://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-os-SOAPMessageSecurity.pdf

Manual de Integraci N Webpay v1 PDF

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual de Integraci N Webpay v1 PDF

Cargado por

Copyright:

Formatos disponibles

REFERENCIA API

6 3.1 Introducción a Webpay

5 API SOAP DE WEBPAY 11

11 5.1 Aspectos de Seguridad de API SOAP

6 INTEGRACIÓN, VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN 12

12 6.1 Etapas de integración de Webpay

7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 14

14 7.1 Descripción de la Transacción de Autorización Normal

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 2

8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 23

23 8.1 Descripción de la Transacción de Autorización Mall Normal

32 9.1 Descripción de la Transacción de OneClick

10 TRANSACCIÓN DE CAPTURA DIFERIDA 37

37 10.1 Descripción de la captura diferida

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 3

39 11.1 Descripción de la anulación

41 12.1 Anexo A: Creación de llaves y ambientes Webpay

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 4

FECHA VERSIÓN DESCRIPCIÓN DEL CAMBIO

2.1 Acerca de esta guía 2.2 Audiencia

2.3 Feedback para esta documentación

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 5

3.1 Introducción a Webpay dependiendo de los productos contratados por el comercio, se

Sitio del Webpay Autenticación Sitio del Webpay Sitio del

3.2 Tipos de Transacciones Webpay

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 6

Mecanismos para realizar la captura en forma diferida:

• Transacción de captura diferida, soportada a través de servicios Web.

desea realizar la anulación y los montos requeridos para anular.

Esta funcionalidad solo es válida para transacciones crédito.

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 7

• Webpay Plus, permite autenticar a tarjetahabientes cuyas

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 8

VENTA NORMAL Corresponde al pago de un producto o servicio en 1 cuota. VN

DÉBITO REDCOMPRA Pago a través de tarjeta de débito Redcompra VD

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 9

4.1 Comunicación DEBE velar por la seguridad de las transacciones, bajo el

Los plugins y SDK para Webpay que distribuye Transbank ya

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 10

5 API SOAP DE WEBPAY

openssl req -new -key 597029124456.key -out 597029124456.csr

3. Crear certificado autofirmado

Mensaje firmado con llave

El comercio debe enviar a Transbank el certificado público

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 11

6 INTEGRACIÓN, VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN

www.transbankdevelopers.cl Resultado APROBADO RECHAZADO

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 12

Soporte validará que los casos de prueba sean consistentes

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 13

7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL

Sitio del Webpay Autenticación Sitio del Webpay Sitio del

Resumen de los métodos del servicio Web de Transacción Normal

MÉTODO DESCRIPCIÓN GENERAL

El método acknowledgeTransaction debe ser invocado siempre, independientemente del resultado

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 14

7.2 Secuencia de pago en una transacción normal

sd Secuencia Flujo Webpay Transacción Normal

TARJETAHABIENTE COMERCIO WEBPAY WS

1 Pagar con Webpay()

3 Response() :token, urfFormOfPayment

Ilustración 1: Diagrama de secuencia de Transacción Normal

REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 15