Vous êtes sur la page 1sur 48

REFERENCIA API

SOAP WEBPAY
TRANSBANK S.A.
DOCUMENTO DE ESPECIFICACIONES (V 1.0)
CONTENIDO NDICE INTERACTIVO
Haz click en nmero de captulo o
de pgina para acceder directamente.

1 CONTROL DE CAMBIOS 5

2 PREFACIO 5
5 2.1 Acerca de esta gua
5 2.2 Audiencia
5 2.3 Feedback para esta documentacin

3 SOBRE WEBPAY 6

6 3.1 Introduccin a Webpay


6 3.2 Tipos de Transacciones Webpay
7 3.3 Autorizacin y captura de transacciones de crdito
7 3.4 Anulacin de transacciones
8 3.5 Monedas soportadas
8 3.6 Autenticacin del tarjetahabiente
8 3.7 Compatibilidad con navegadores Web
9 3.8 Tipos de pago (productos)

4 CONSIDERACIONES GENERALES 10

10 4.1 Comunicacin
10 4.2 Seguridad
10 4.3 Deberes de los comercios
10 4.3.1 Validacin 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 Informacin general
11 5.1.2 Generacin de llave y certificado auto-firmado

6 INTEGRACIN, VALIDACIN DE INTEGRACIN Y PASO A PRODUCCIN 12

12 6.1 Etapas de integracin de Webpay


12 6.1.1 Etapa de integracin
12 6.1.2 Etapa de validacin de Integracin
13 6.1.3 Etapa de puesta en produccin
13 6.2 Ambientes

7 TRANSACCIN DE AUTORIZACIN NORMAL 14

14 7.1 Descripcin de la Transaccin de Autorizacin Normal


15 7.2 Secuencia de pago en una transaccin normal
15 7.2.1 Diagrama
16 7.2.2 Descripcin 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 transaccin normal anulada en formulario de pago
17 7.3.1 Diagrama
18 7.3.2 Descripcin secuencia de pago para transaccin anulada en formulario de pago
18 7.4 Flujo Alternativo: Secuencia de pago en una transaccin normal con evento de timeout
18 7.4.1 Diagrama
19 7.4.2 Descripcin de secuencia timeout en transaccin normal
19 7.5 Descripcin de mtodos del Servicio Web de Transaccin de Autorizacin Normal
19 7.5.1 Operacin initTransaction
20 7.5.2 Operacin getTransactionResult
22 7.5.3 Operacin acknowledgeTransaction

8 TRANSACCIN DE AUTORIZACIN MALL NORMAL 23

23 8.1 Descripcin de la Transaccin de Autorizacin Mall Normal


24 8.2 Secuencia de pago en una transaccin de autorizacin Mall Normal
24 8.2.1 Diagrama
25 8.2.2 Descripcin de la secuencia
26 8.3 Flujo Alternativo: Secuencia de pago en una transaccin mall normal anulada en formulario de pago
27 8.3.1 Descripcin de secuencia alternativa, anular
27 8.4 Flujo Alternativo: Secuencia de pago en una transaccin mall normal con evento de timeout
27 8.4.1 Diagrama
28 8.4.2 Descripcin de secuencia alternativa, timeout
28 8.5 Descripcin de mtodos del Servicio Web de Transaccin de Autorizacin Mall Normal
28 8.5.1 Operacin initTransaction
29 8.5.2 Operacin getTransactionResult
31 8.5.3 Operacin acknowledgeTransaction

9 TRANSACCIN ONECLICK 32

32 9.1 Descripcin de la Transaccin de OneClick


32 9.2 Resumen de los mtodos del servicio Web
32 9.3 Inscripcin en Oneclick
32 9.3.1 Descripcin
33 9.3.2 Diagrama
34 9.3.3 Mtodo initInscription
34 9.4 Eliminar registro de inscripcin de usuario
34 9.5 Transaccin de Pago Oneclick
35 9.6 Reversa de Pagos Autorizados
35 9.7 Definicin detallada de mtodos del Servicio Web

10 TRANSACCIN DE CAPTURA DIFERIDA 37

37 10.1 Descripcin de la captura diferida


37 10.2 Descripcin del mtodo del servicio web de captura diferida
37 10.2.1 Operacin capture
38 10.2.2 Cdigos de error

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


11 TRANSACCIN DE ANULACIN 39

39 11.1 Descripcin de la anulacin


39 11.2 Descripcin del mtodo del servicio web de anulacin de transacciones
39 11.2.1 Operacin nullify
40 11.2.2 Cdigos de error

12 ANEXOS 41

41 12.1 Anexo A: Creacin de llaves y ambientes Webpay


41 12.1.1 Creacin de llave privada y certificado pblico
42 12.1.2 Ambientes de Webpay
43 12.2 Anexo B: Requerimientos de pginas de transicin y de pgina de fin de transaccin
43 12.2.1 Requerimientos Pgina de Transicin
43 12.2.2 Requerimientos Pgina final de xito
43 12.2.3 Requerimientos Pgina final de fracaso
44 12.3 Anexo C: Excepciones SOAP API Webpay
47 12.4 Anexo D: Pruebas de validacin efectuada por Transbank
47 12.4.1 Pruebas de validacin para Transaccin Normal, modalidad plugin
47 12.4.2 Pruebas de validacin para Transaccin Normal
47 12.4.3 Pruebas de validacin para Transaccin Normal captura diferida
47 12.4.4 Pruebas de validacin para Transaccin Mall
47 12.4.5 Pruebas de validacin para Transaccin OneClick
48 12.5 Anexo D: Referencias

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


1 CONTROL DE CAMBIOS 2 PREFACIO

1 CONTROL DE CAMBIOS

FECHA VERSIN DESCRIPCIN DEL CAMBIO


22-05-2017 1.0 Liberacin inicial de documento de API SOAP de integracin Webpay.
08-06-2017 1.1 Corrige largo de cdigo de autorizacin.

2 PREFACIO

2.1 Acerca de esta gua 2.2 Audiencia


Esta gua describe los aspectos tcnicos y operativos que deben Esta gua est dirigida a implementadores que realizan la
ser considerados en la integracin con Webpay utilizando API integracin de Webpay en comercios utilizando la API SOAP para
SOAP para los servicios web para Transaccin de Autorizacin soportar en estos el pago con tarjetas bancarias.
Normal, Mall Normal, OneClick y Anulaciones. Se recomienda que quin realice la integracin, al menos, posea
conocimiento tcnico de al menos en los siguientes temas:
Antes de continuar, es necesario declarar que para tener una visin
general de los productos y modalidades asociadas a Webpay se Servicios Web
recomienda leer el manual Operacional de Webpay. WS-Security
Generacin y validacin de firma digital en mensajes SOAP.

2.3 Feedback para esta documentacin


Aydanos a mejorar esta informacin envindonos comentarios a:
El presente manual se considera parte ntegra del contrato,
por lo que es importante prestar atencin a las obligaciones, soporte@transbank.cl
sugerencias e indicaciones descritas en el presente
documento.

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


3 SOBRE WEBPAY

3 SOBRE WEBPAY

3.1 Introduccin 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 crdito con productos cuotas
realizar transacciones desde Internet con tarjetas bancaras de y/o dbito Redcompra. Durante el proceso de pago se autentica
crdito y dbito. Hoy en da Webpay constituye una herramienta al tarjetahabiente antes de realizar la transaccin financiera, con
clave para el desarrollo de un comercio electrnico eficaz y seguro el objetivo de validar que la tarjeta este siendo utilizada por el
en Chile. titular. Una vez resuelta la autenticacin 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, autorizacin y si sta es aprobada, Webpay emite un comprobante
en donde el tarjetahabiente selecciona los productos o servicios a electrnico del pago.
pagar. Una vez realizado esto, elige pagar con Webpay en donde,

Sitio del Webpay Autenticacin Sitio del Webpay Sitio del


Comercio Formulario en Banco Comercio Comprobante Comercio
de Pago Emisor de pago

Dentro de los atributos ms relevantes de Webpay se pueden comercio por eventuales fraudes o desconocimientos de
mencionar: compra.
Permite realizar transacciones seguras y en lnea a travs de
Internet. La seguridad es reforzada por medio de la utilizacin 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 travs de servicios Web son los siguientes:

Una transaccin normal corresponde a una solicitud de autorizacin financiera de un pago con tarjetas de crdito o
Normal dbito. El tarjetahabiente ingresa al sitio del comercio, selecciona productos o servicio, y el ingreso asociado a los datos
de la tarjeta de crdito o dbito lo realiza en forma segura en Webpay.

Una transaccin Mall corresponde a mltiples solicitudes de autorizacin financiera de distintos cdigos de comercios
pertenecientes a un comercio padre. Cada transaccin constituye un pago con tarjetas de crdito o dbito 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 crdito o dbito lo realiza en forma segura en Webpay.

Una transaccin OneClick permite que el tarjetahabiente registre su tarjeta de crdito nacional una nica vez y los
pagos los realice en un solo click en la tienda de comercio electrnico. 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 sesin en esta y presione pagar para enviar todos los datos
asociados a la transaccin.

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


3 SOBRE WEBPAY

3.3 Autorizacin y captura de transacciones de crdito la cuenta de crdito asociada a la tarjeta del titular. Ambas fases
Las transacciones Webpay cuentan con 2 fases, autorizacin pueden ocurrir en el mismo instante o en forma desfasada. Estas
y captura. La autorizacin se encarga de validar si es posible modalidades, por separado, solo son vlidas para tarjetas de
realizar el cargo a la cuenta asociada a la tarjeta de crdito crdito. En el caso de compras con tarjeta de dbito siempre es
realizando en el mismo acto la reserva de monto de la transaccin. en modalidad autorizacin y captura simultanea no siendo posible
La captura hace efectiva la reserva hecha previamente o cargo en separar ambos procesos.

Autorizacin
Es la utilizada cuando la transaccin es validada en lnea por Transbank. El cargo del pago se hace simultneamente
y captura
simultanea en la tarjeta de crdito o dbito del cliente.

Es utilizada cuando el comercio por diversas razones, ejemplo: verificacin de stock, no puede realizar la transaccin
en tiempo real, aqu lo que se hace es retener el valor de la compra del saldo de la tarjeta de crdito del cliente sin
consumir definitivamente el cupo de la tarjeta de crdito hasta que el comercio confirma la compra, va captura, y lo
comunique a Transbank.

Existe un tiempo mximo de 7 das para realizar esto ltimo, de no ser as la retencin de la tarjeta de crdito del cliente
ser reversada.

Mecanismos para realizar la captura en forma diferida:


Autorizacin y
captura diferida
A travs de portal de Transbank www.transbank.cl

Transaccin de captura diferida, soportada a travs de servicios Web.

Esta modalidad slo est disponible para pagos de crdito y no as para pagos con tarjetas de dbito.

Los tipos de pago soportados para esta modalidad son solo los siguientes:
- Venta Normal
- 2 cuotas sin inters
- 3 cuotas sin inters
- N Cuotas

3.4 Anulacin de transacciones querer hacerlo se debe entregar el dinero en efectivo al cliente.
Webpay permite, por medio de servicios Web, anular una
transaccin de crdito que fue autorizada. Las transacciones crdito se pueden anular bajo el siguiente criterio:

Esta operacin contempla anular total o parcialmente una Producto Cdigo Anulacin Anulacin
Total Parcial
transaccin. Para ello se deber indicar los datos asociados a la
transaccin de autorizacin o captura en lnea sobre los cuales se Venta Normal VN

desea realizar la anulacin y los montos requeridos para anular.


2 cuotas sin inters S2
En caso de que la transaccin haya sido abonada al comercio, la
anulacin generar una retencin en los siguientes abonos por el 3 cuotas sin inters 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
das para anular transacciones, a partir de la fecha de la venta.
Cuotas Normales VC

Esta funcionalidad solo es vlida para transacciones crdito.


Venta dbito VD
Las transacciones dbito no pueden ser anuladas y en caso de

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


3 SOBRE WEBPAY

El comercio conoce el producto aplicado en una transaccin al Para que la transaccin sea autenticada, el comercio debe tener
obtener la respuesta de autorizacin original desde Transbank. habilitado Webpay Plus o 3D Secure.
Este dato debe ser almacenado por el comercio para poder
aplicar la lgica de anulacin 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
Dlares norteamericanos (USD) Chrome 52 o superior
Safari 7 o superior
3.6 Autenticacin del tarjetahabiente
Webpay permite autenticar al tarjetahabiente durante el proceso de Smartphone / Dispositivos mviles:
pago, agregando mayor seguridad y evitando desconocimientos Blackberry 9900, 9700
de compra. Las modalidades de autenticacin 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 crdito y dbito 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 tambin 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 crdito han sido emitidas en el extranjero. de la capa mobile, Webpay utiliza el user-agent que llega va
el browser del tarjetahabiente e identifica si este corresponde
El resultado de la autenticacin, es entregado junto con el a los soportados detallados anteriormente.
resultado de la autorizacin financiera de la transaccin Webpay.

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


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 travs de Webpay tipos de pago:
dependen del tipo de tarjeta usada por el tarjetahabiente y los que

Abreviacin
Tipo de Pago Descripcin
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 inters para el
S2
SIN INTERS TH.
3 CUOTAS Corresponde al pago de un producto o servicio en 3 cuotas iguales sin inters para el
SI
SIN INTERS TH.
VENTA CUOTAS

N CUOTAS Corresponde al pago de un producto o servicio en N cuotas iguales sin inters para
CRDITO (SIN el TH. El nmero de cuotas puede ir de 2 hasta "N" cuotas. Con "N" mximo 12, y NC
INTERS) definido por el Comercio.
CUOTAS SIN Corresponde al pago de un producto o servicio en N cuotas iguales sin inters para el
INTERS DEL TH. Esto es una promocin del emisor de la tarjeta. Puede ir de 2 hasta 48 cuotas. El VC
EMISOR Emisor escoge el rango en promocin.
Cuotas normales o cuotas fijas van de 2 hasta 48 y se les aplica el inters 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).

DBITO REDCOMPRA Pago a travs de tarjeta de dbito Redcompra VD

Nota: Para dudas con respecto a los abonos para el comercio, dirigirse al Manual de Comercios de Webpay.

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


4 CONSIDERACIONES GENERALES

4 CONSIDERACIONES GENERALES

4.1 Comunicacin DEBE velar por la seguridad de las transacciones, bajo el


La comunicacin e informacin oficial que entrega Transbank para esquema del servicio ofertado por Transbank.
las integraciones de Webpay, en todas sus modalidades, slo se
realiza a travs de los siguientes canales: Webpay expone una API, y es obligacin 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 OBLIGACIN de ambas partes
validar dicha firma.
En el portal de Transbank, el comercio podr encontrar informacin
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 podrn encontrar informacin valida que la firma del mensaje SOAP corresponda al comercio
especfica como manuales, SDK, plugins, que son herramientas que consume el servicio, mediante el certificado pblico
de cdigo abierto que tienen como nico propsito facilitar la autofirmado que tiene cargado en sus sistemas. A su vez,
integracin 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 propsito. el certificado pblico que Transbank le comparti.

Dado lo anterior es que, al utilizar cualquier software distribuido Cabe recordar que Webpay posee 2 ambientes: integracin/
por Transbank, asume que el comercio acepta esta y otras testing y produccin. 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 estn 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 solucin basada en Plugins
de las operaciones disponibles. El mecanismo de seguridad o SDK, debe atento a las actualizaciones que peridicamente
implementado est basado en un canal de comunicacin seguro Transbank realizarn, los que pueden responder a mantener
TLS 1.2 y WS-Security, los cuales proporcionan autenticacin, compatibilidad con los CMS o Shoppping Cart para su
confidencialidad e integridad a los Servicios Web. Con lo anterior, compatibilidad, modificaciones por seguridad, adicin de
la seguridad se encuentra basada en: propiedades o funciones, o correcciones a las comunicaciones.
Canal seguro a travs de TLS 1.2 para la comunicacin del La comunicacin oficial siempre se realizar a travs del sitio
cliente con Webpay.
www.transbankdevelopers.cl
Mensajes requerimientos y respuestas firmados digitalmente.

Los plugins y SDK para Webpay que distribuye Transbank ya


estn construidos con las libreras necesarias para realizar las
Transbank asegura compatibilidad del plugin
validaciones requeridas, pero es deber del comercio asegurarse
con una(s) versin(es) especfica(s) del CMS o Shopping
que la solucin 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 solucin de pago a una versin que no
4.3 Deberes de los comercios se ha asegurado compatibilidad, porque podra dejar de
4.3.1 Validacin de mensajes de solicitud y respuesta funcionar la comunicacin entre su comercio y Webpay.
Todo comercio que utiliza Webpay mediante Webservices,

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


5 API SOAP DE WEBPAY

5 API SOAP DE WEBPAY

La API SOAP de Webpay est basada en el estndar 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 cdigo de comercio entregado por Transbank,
Language), proporcionando un alto grado de interoperabilidad, ejemplo: cn = 597029124456.|
un protocolo estndar para invocacin de servicios remotos e
independencia de la plataforma y el lenguaje de desarrollo. El comercio debe enviar a Transbank el certificado digital (parte
pblica) que utilizar para validar que el requerimiento viene
El tipo de transaccin, la posibilidad de permitir el pago con crdito realmente desde el comercio. No se requiere la llave privada de
y dbito, y los productos cuotas, dependern 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 captulos se entrega informacin Transbank entregar su certificado a los comercios en el
especfica para cada tipo de transaccin. proceso de integracin, de testing y de puesta en produccin,
de forma independiente para que puedan realizar la validacin
5.1 Aspectos de Seguridad de API SOAP de la firma en la respuesta.
5.1.1 Informacin general
Los servicios Web de Webpay estn protegidos para garantizar Todos los mtodos, 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 comunicacin seguro firma con su certificado el requerimiento y valida la respuesta
TLS 1.2 y WS-Security, los cuales proporcionan autenticacin, con el certificado de Transbank.
confidencialidad e integridad a los Servicios Web. Con lo
anterior, la seguridad se encuentra basada en: 5.1.2 Generacin de llave y certificado auto-firmado
Canal seguro a travs de TLS 1.2 para la comunicacin 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
pblica 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) []:
Aplicacin Common Name (eg, your name or your servers 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
pblica 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 pblico


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

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


6 INTEGRACIN, VALIDACIN DE INTEGRACIN Y PASO A PRODUCCIN

6 INTEGRACIN, VALIDACIN DE INTEGRACIN Y PASO A PRODUCCIN

6.1 Etapas de integracin de Webpay ambiente de integracin, ya vienen preinstalados, por lo que
Para que el comercio incorpore Webpay como medio de pago, es no requiere de una configuracin adicional.
necesario que realice las siguientes etapas:
Etapa de Integracin Cabe destacar, las tienda de pruebas soporta los medios
Etapa de Validacin de Integracin de pago dbito y crdito en transaccin normal y captura
Etapa de Puesta en produccin simultnea, en moneda pesos chilenos, que es el producto
Webpay ms utilizado en el mercado.
Cada una de las etapas es necesaria para que el comercio realice
una correcta implementacin de Webpay, priorizando la seguridad Cualquier duda con este aspecto, o algn requerimiento
e integridad transaccional. en particular respecto de la tienda de integracin,
contacte a la mesa de soporte al 800 44 11 44 o al correo
6.1.1 Etapa de integracin
soporte@transbank.cl
La etapa de integracin corresponde al proceso en que el
comercio desarrolla su solucin de medio de pago, consumiendo 6.1.1.2 Datos de prueba para el ambiente de integracin
los servicios de la API Webpay. Para utilizar el ambiente de integracin, necesitar tarjetas
de pruebas, las que se encuentran predefinidas para los
En este caso, el comercio utiliza un cdigo de comercio escenarios de xito y fracaso.
de integracin que provee Transbank, junto con todas las
credenciales necesarias para realizar la conexin y el correcto En ambos casos, y tanto para dbito y crdito, 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 crdito, se tiene lo
Si el comercio desea desarrollar su propia solucin, entonces siguiente:
debe utilizar las credenciales correspondientes que las puede
obtener desde transbankdevelopers.cl o solicitndolas a Marca VISA MASTERCARD
N de Tarjeta 4051885600446623 5186059559590568
soporte@transbank.cl
Ao Expiracin Cualquiera Cualquiera
6.1.1.1 Credenciales Mes Expiracin Cualquiera Cualquiera
Para comenzar el proceso de integracin, 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 dbito:
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 tcnicos que all se RUT 11.111.111-1 11.111.111-1
especifican y seguir las instrucciones de instalacin PASSWORD 123 123
detalladas para cada caso.
6.1.2 Etapa de validacin de Integracin
Cada plugin viene de la forma listo para usar en ambiente de Durante la validacin de la integracin se pretende verificar que
integracin / validacin, cumpliendo con los requerimientos el comercio transacciona de manera segura y sin problemas,
tcnicos, de seguridad y de despliegue de informacin por lo que se solicitarn una serie de pruebas y su posterior
requeridos por Webpay, por lo que no debera modificar nada. envo de evidencias para validar la integracin.
La tienda de pruebas que viene por defecto con los plugins
tiene el cdigo de comercio 597020000541, y su llave privada, Esta validacin es requisito necesario para dejar al comercio
certificado pblico y el certificado pblico de Webpay, para el en produccin y no se permitir que un comercio utilice

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


6 INTEGRACIN, VALIDACIN DE INTEGRACIN Y PASO A PRODUCCIN

productivamente el servicio Webpay sin poseer una validacin. Estos pasos incluyen cambio en el ambiente sobre el que
transacciones, pasando de integracin a produccin, adems
Por otro lado, Transbank no validar ninguna integracin a de las instrucciones de creacin de llave privada productiva y
algn comercio que no posea cdigo de comercio productivo. certificado pblico autofirmado asociado a dicha llave, como
Para obtenerlo, siga las instrucciones en cmo hacerse asimismo el cambio en el certificado pblico 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 Creacin
de llaves y ambiente de integracin
En esta etapa, el comercio enva las evidencias a
soporte@transbank.cl Durante el paso a produccin se le exigir realizar, al menos,
una transaccin de prueba, con la que finalizar oficialmente la
mediante el formulario correspondiente, indicando claramente puesta en produccin.
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 pblico que Transbank comparte con los
a produccin, 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 integracin, 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 pblico, como asimismo es
responsable por reemplazar estos cuando caduquen.
6.1.3 Etapa de puesta en produccin
Corresponde a las actividades tcnico-administrativas en que
ambas partes, comercio y Transbank, realizan para habilitar
la solucin de medio de pago en produccin, permitindole al 6.2 Ambientes
comercio operar con Webpay y toda su gama de tarjetas. Para el proceso de integracin, validacin y paso a produccin,
Transbank pone a disposicin 2 ambientes:
Una vez que la validacin de integracin es aprobada, el
comercio recibir instrucciones desde soporte, que incluyen 1) Ambiente de Integracin y Validacin: En este ambiente el
cambio a endpoints productivos, certificado pblico productivo comercio realiza la integracin a Webpay y testea su solucin
de Webpay e instrucciones para la creacin de llave privada y de medio pago. Asimismo, en ste ambiente es que se valida la
certificado pblico productivo del comercio, entre otros. integracin del comercio.

Como Webpay utiliza WS_Security, es que es en esta etapa 2) Ambiente de produccin: Este ambiente es en el cual
en que se intercambian, comercio y Transbank, los certificados finalmente operar productivamente el comercio. En este
pblicos productivos, manteniendo ambas partes sus ambiente puede hacer pruebas con tarjetas de crdito o dbito
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 produccin.
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 cdigos de comercios, distintas tarjetas de prueba y
integracin est aprobada, deber seguir los pasos que le indican distintos certificados, por lo que es importante tener la claridad
para pasar a produccin y poder comenzar a transaccionar de que, al realizar el cambio de ambiente un ambiente a otro, se
manera real. consideren los puntos anteriores.

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

7 TRANSACCIN DE AUTORIZACIN NORMAL

7.1 Descripcin de la Transaccin de Autorizacin Normal ingreso asociado a los datos de la tarjeta de crdito o dbito lo
Una transaccin de autorizacin normal (o transaccin normal), realiza en forma segura en Webpay.
corresponde a una solicitud de autorizacin financiera de un pago
con tarjetas de crdito o dbito, en donde quin realiza el pago El flujo de pginas para la transaccin es el siguiente:
ingresa al sitio del comercio, selecciona productos o servicio, y el

Sitio del Webpay Autenticacin Sitio del Webpay Sitio del


Comercio Formulario en Banco Comercio Comprobante Comercio
de Pago Emisor de pago

Resumen de los mtodos del servicio Web de Transaccin Normal

MTODO DESCRIPCIN GENERAL


Permite inicializar una transaccin en Webpay. Como respuesta a la invocacin se genera un token que representa
en forma nica una transaccin.
initTransaction
Es importante considerar que una vez invocado este mtodo, 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 transaccin una vez que Webpay ha resuelto su autorizacin financiera.
Indica a Webpay que se ha recibido conforme el resultado de la transaccin.

El mtodo acknowledgeTransaction debe ser invocado siempre, independientemente del resultado


acknowledgeTransaction
entregado por el mtodo getTransactionResult. Si la invocacin no se realiza en un perodo de 30 segundos,
Webpay reversar la transaccin, asumiendo que el comercio no pudo informar de su resultado, evitando as el
cobro al tarjetahabiente.

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

7.2 Secuencia de pago en una transaccin normal


7.2.1 Diagrama
El siguiente diagrama ilustra la secuencia de pago y cmo participan los distintos actores en una transaccin normal.

sd Secuencia Flujo Webpay Transaccin 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()

Ilustracin 1: Diagrama de secuencia de Transaccin Normal

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

7.2.2 Descripcin de la secuencia autorizacin sea persistida en los sistemas del comercio, ya que
1. Una vez seleccionado los bienes o servicios, tarjetahabiente este mtodo se puede invocar una nica vez por transaccin.
decide pagar a travs de Webpay.
12. Comercio recibe el resultado de la invocacin del mtodo
2. El comercio inicia una transaccin en Webpay, invocando el getTransactionResult().
mtodo initTransaction().
13. Para que el comercio informe a Webpay que el
3. Webpay procesa el requerimiento y entrega como resultado de la transaccin se ha recibido sin problemas,
resultado de la operacin el token de la transaccin y el sistema del comercio debe consumir el tercer mtodo
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 transaccin a la URL indicada en punto 3. La
redireccin se realiza enviando por mtodo POST el token en
De no ser consumido o demorar ms de 30
variable token_ws. segundos en su consumo, Webpay realizar la reversa
de la transaccin, asumiendo que existieron problemas
5. El navegador Web del tarjetahabiente realiza una peticin de comunicacin. En este caso el mtodo retorna una
HTTPS a Webpay, en base al redireccionamiento generado Excepcin indicando la situacin. Esta excepcin 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 comunicacin es
entre Webpay y el tarjetahabiente, sin interferir el comercio. El 14. Una vez recibido el resultado de la transaccin e informado
formulario de pago de Webpay despliega, entre otras cosas, el a Webpay su correcta recepcin, el sitio del comercio debe
monto de la transaccin, informacin del comercio como nombre redirigir al tarjetahabiente nuevamente a Webpay, con la
y logotipo, las opciones de pago a travs de crdito o dbito. 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 mtodo
8. Webpay procesa la solicitud de autorizacin (primero getTransactionResult() enviando por mtodo POST el
autenticacin bancaria y luego la autorizacin de la transaccin). token de la transaccin en la variable token_ws.

9. Una vez resuelta la autorizacin, Webpay retorna el control 15. Webpay recibe un requerimiento con la variable token_ws
al comercio, realizando un redireccionamiento HTTP/HTTPS
hacia la pgina de transicin del comercio, en donde se enva por 16. Webpay identifica la transaccin y despliega el comprobante
mtodo POST el token de la transaccin en la variable token_ws. de pago al tarjetahabiente.
El comercio debe implementar la recepcin de esta variable.
17. Una vez visualizado el comprobante de pago por un
10. El navegador Web del tarjetahabiente realiza una peticin periodo acotado de tiempo, el tarjetahabiente es redirigido de
HTTP/HTTPS al sitio del comercio, en base a la redireccin 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 mtodo
POST hacia la pgina final informada por el comercio en el
11. El sitio del comercio recibe la variable token_ws e invoca el mtodo initTransaction.
segundo mtodo Web, getTransactionResult () (mientras
*2 se despliega la pgina de transicin*2), para obtener el resultado 18. Sitio del comercio despliega pgina final de pago*3. *3

de la autorizacin. Se recomienda que el resultado de la

*2 El detalle de la pgina de transicin se encuentra descrito en Anexo A, *3 El detalle de la pgina de final se encuentra descrito en Anexo A,
del documento de descripcin general de la API SOAP. 12.1.2 del documento de descripcin general de la API SOAP.

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

7.3 Flujo Alternativo: Secuencia de pago en una transaccin


normal anulada en formulario de pago

7.3.1 Diagrama
El siguiente diagrama ilustra la secuencia de una transaccin
normal donde el TH anula la transaccin en el formulario de
pago de Webpay y cmo participan los distintos actores en
esta situacin.

Ilustracin 2: Botn anular formulario de pago en Webpay

sd Secuencia Flujo Webpay Transaccin Anulada

TARJETAHABIENTE COMERCIO WEBPAY WS

1 Pagar con Webpay()

2 initTransaction()

3 Response() :token, urfFormOfPayment

4 Redirect(token...)

5 Request(token)

6 Formulario Webpay()

7 Anular()

8 Redirect()

9 Request(token)

10 Pagina final()

Ilustracin 3: Diagrama de secuencia de pago en una transaccin normal anulada en formulario de pago

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

7.3.2 Descripcin secuencia de pago para transaccin anulada resultado de la autorizacin. En este caso debe obtener una
en formulario de pago: excepcin, pues el pago fue abortado.
1. Pasos de 1 a 6 son idnticos 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, segn anexo glosa transaccin no autorizada.

8. Webpay retorna el control al comercio, realizando un 7.4 Flujo Alternativo: Secuencia de pago en una transaccin
redireccionamiento HTTP/HTTPS hacia la pgina de final del normal con evento de timeout
comercio, en donde se enva por mtodo POST el token de la
transaccin en la variable TBK_TOKEN. 7.4.1 Diagrama
El siguiente diagrama ilustra la secuencia de pago y cmo
9. El comercio con la variable TBK_TOKEN debe, invocar el participan los distintos actores en una transaccin normal con
segundo mtodo Web, getTransactionResult () (mientras evento de timeout.
*4 se despliega la pgina de transicin*4), para obtener el

sd Secuencia Flujo Webpay Webservice Transaccin

TARJETAHABIENTE COMERCIO WEBPAY WS

1 Pagar con Webpay()

2 initTransaction()

3 Response() :token, urfFormOfPayment

4 Redirect(token...)

5 Request(token)

6 Formulario Webpay()

7 Timeout()

8 Error() : Pgina de error

Ilustracin 4: Diagrama de secuencia de timeout en transaccin normal

*4 El detalle de la pgina de transicin se encuentra descrito en Anexo


A, 12.1.1, del documento de descripcin general de la API SOAP.

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

7.4.2 Descripcin de secuencia alternativa, timeout: 7.5 Descripcin de mtodos del Servicio Web de Transaccin
1. Pasos de 1 a 6 son idnticos a la secuencia normal. de Autorizacin Normal

7. Tarjetahabiente se encuentra en formulario Webpay, pero no A continuacin se describen cada uno de las operaciones que
presiona pagar durante 10 minutos. Esto causa un timeout en deben ser utilizadas en una Transaccin Normal.
dicho formulario.
7.5.1 Operacin initTransaction
8. Webpay genera un error de timeout, se presenta una pantalla Mtodo que permite iniciar una transaccin de pago Webpay.
*5 indicando que ocurri un error*5. Se regresa automticamente
al comercio. 7.5.1.1 Parmetro de entrada

NOMBRE DESCRIPCIN
tns:wsTransactionType
WSTransactionType
Indica el tipo de transaccin, su valor debe ser siempre TR_NORMAL_WS
xs:string
sessionId (Opcional) Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin.
Largo mximo: 61
xs:anyURI
returnURL (Obligatorio) URL del comercio, a la cual Webpay redireccionar posterior al proceso de autorizacin
Largo mximo: 256
xs:anyURI
finalURL (Obligatorio) URL del comercio a la cual Webpay redireccionar posterior al voucher de xito de Webpay.
Largo mximo 256
tns:wsTransactionDetail
(Obligatorio) Lista de objetos del tipo wsTransactionDetail, el cual contiene datos de la transaccin. Mxima
transactionDetails
cantidad de repeticiones es de 1 para este tipo de transaccin.
wsTransactionDetail est descrito ms adelante.
tns:wPMDetail
wPMDetail
(No se utiliza para Transaccin Normal) Este campo contiene la transaccin webpay mensual.
xs:string
(Opcional)Es el cdigo nico de identificacin del comercio entregado por Transbank. Es obligatorio para
commerceId
transaccin MALL.
Largo: 12
xs:string
buyOrder (Opcional) Es el cdigo nico de la orden de compra generada por el comercio. Es obligatorio para transaccin
MALL.

*5 El detalle de la pgina de transicin se encuentra descrito en Anexo


A, 12.1.1, del documento de descripcin general de la API SOAP.

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

TYPE WSTRANSACTIONDETAIL
Descripcin: Tipo de dato contiene detalles de la transaccin

CAMPO DESCRIPCIN
xs:decimal
amount Monto de la transaccin. Mximo 2 decimales para USD.
Largo mximo: 10
xs:string
Orden de compra de la tienda.*6
buyOrder
Largo mximo: 26
La orden de compra puede tener: Nmeros, letras, maysculas y minsculas, y los signos |_=&%.,~:/?[+!@()>-
xs:string
commerceCode Cdigo comercio de la tienda entregado por Transbank.
Largo: 12
sharesAmount Campo no utilizado
sharesNumber Campo no utilizado

7.5.1.2 Parmetros de salida:TypewsInitTransactionOutput 7.5.2 Operacin getTransactionResult


Mtodo que permite obtener el resultado de la transaccin y
CAMPO DESCRIPCIN los datos de la misma.
xs:string 7.5.2.1 Parmetros de entrada
token Token de la transaccin.
Largo: 64 CAMPO DESCRIPCIN
xs:string xs:string
url URL de formulario de pago Webpay tokenInput Token de la transaccin.
Largo mximo: 256 Largo: 64

*6 Debe cumplir con caracteres permitidos.

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

7.5.2.2 Parmetros de salida: TypeTransactionResultOutput

CAMPO DESCRIPCIN
xs:string
buyOrder Orden de compra de la tienda.
Largo mximo: 26
xs:string
sessionId
Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin. Largo mximo: 61
Tns:carddetails
cardDetails
Objeto que representa los datos de la tarjeta de crdito del tarjeta habiente. cardDetails descrito ms adelante.
xs:string
accoutingDate Fecha de la autorizacin.
Largo: 4, formato MMDD
xs:string
transactionDate Fecha y hora de la autorizacin.
Largo: 6, formato: MMDDHHmm
xs:string
Resultado de la autenticacin para comercios Webpay Plus y/o 3D Secure, los valores posibles son los siguientes:
TSY : Autenticacin exitosa
TSN : Autenticacin fallida.
VCI TO*7 : Tiempo mximo excedido para autenticacin.
ABO : Autenticacin abortada por tarjetahabiente.
U3 : Error interno en la autenticacin.
Puede ser vaco si la transaccin no se autentic.
Largo mximo: 3
xs:string
urlRedirection URL de redireccin para visualizacin de voucher.
Largo mximo: 256
tns:wsTransactionDetailOutput
detailsOutput
detailsOutput Objeto que contiene el detalle de la transaccin financiera. Descrito ms adelante

TYPECARDDETAIL
Descripcin: Tipo de dato contiene detalles de la tarjeta de crdito.

CAMPO DESCRIPCIN
xs:string
4 ltimos nmeros de la tarjeta de crdito del tarjeta habiente.
cardNumber
Solo para comercios autorizados por Transbank se enva el nmero completo.
Largo mximo: 16
xs:string
(Opcional) Fecha de expiracin de la tarjeta de crdito del tarjetahabiente. Formato YYMM
cardExpirationDate
Solo para comercios autorizados por Transbank.
Largo mximo: 4

*7 VCI=TO indica que se produjo un time-out en el proceso de autenticacin bancaria. Esta transaccin no ser autorizada y seguir el flujo normal de eventos.

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


7 TRANSACCIN DE AUTORIZACIN NORMAL

TYPEWSTRANSACTIONDETAILOUTPUT
Descripcin: Tipo de dato contiene el detalle del resultado de la transaccin.

CAMPO DESCRIPCIN
xs:string
authorizationCode Cdigo de autorizacin de la transaccin
Largo mximo: 6
xs:string
Tipo de pago de la transaccin.
VD = Venta Dbito
VN = Venta Normal
paymentTypeCode
VC = Venta en cuotas
SI = 3 cuotas sin inters
S2 = 2 cuotas sin inters
NC = N Cuotas sin inters
xs:string
Cdigo de respuesta de la autorizacin. Valores posibles:
0 Transaccin aprobada
-1 Rechazo de transaccin
-2 Transaccin debe reintentarse
responseCode -3 Error en transaccin
-4 Rechazo de transaccin
-5 Rechazo por error de tasa
-6 Excede cupo mximo mensual
-7 Excede lmite diario por transaccin
-8 Rubro no autorizado
xs:decimal
Amount Monto de la transaccin
Largo mximo: 10
xs:int
sharesNumber Cantidad de cuotas
Largo mximo: 2
xs:string
commerceCode Cdigo comercio de la tienda
Largo: 12
xs:string
buyOrder Orden de compra de la tienda.
Largo mximo: 26

7.5.3 Operacin acknowledgeTransaction


Mtodo que permite informar a Webpay la correcta recepcin
del resultado de la transaccin.
En caso de llamar al mtodo acknowledgeTransaction
7.5.3.1 Parmetros de entrada: acknowledgeTransaction despus de 30 segundos de ocurrida la autorizacin, se informar
la excepcin descrita ms abajo y el comercio no debe entregar
CAMPO DESCRIPCIN producto o servicio, ya que la transaccin ha sido reversada por
Webpay:
xs:string
token Token de la transaccin. Timeout error (Transactions REVERSED) con cdigo 277.
Largo: 64

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8.1 Descripcin de la Transaccin de Autorizacin Mall


Normal Tienda
Pago
virtual
Una transaccin Mall Normal corresponde a una solicitud de $1.000
1
autorizacin financiera de un conjunto de pagos con tarjetas de
crdito o dbito, en donde quin 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 crdito o dbito 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 mltiples tiendas, son estas ltimas las Pago
virtual
$3.000
que pueden generar transacciones. Tanto el mall como las tiendas N
asociadas son identificadas a travs de un nmero denominado
cdigo de comercio. El flujo de pginas para la transaccin es el siguiente:

Sitio del Webpay Autenticacin Sitio del Webpay Sitio del


Comercio Formulario en Banco Comercio Comprobante Comercio
de Pago Emisor de pago

Resumen de los mtodos del servicio Web de Transaccin Mall Normal

MTODO DESCRIPCIN GENERAL


Permite inicializar una transaccin en Webpay. Como respuesta a la invocacin se genera un token que representa
en forma nica una transaccin.
initTransaction
Es importante considerar que una vez invocado este mtodo, 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 transaccin una vez Webpay ha resuelto su autorizacin financiera.
Indica a Webpay que se ha recibido conforme el resultado de la transaccin.

El mtodo acknowledgeTransaction debe ser invocado siempre, independientemente del resultado


acknowledgeTransaction
entregado por el mtodo getTransactionResult. Si la invocacin no se realiza en un perodo de 30segundos,
Webpay reversar la transaccin, asumiendo que el comercio no pudo informarse de su resultado, evitando as el
cobro al tarjetahabiente.

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8.2 Secuencia de pago en una transaccin de autorizacin Mall Normal


8.2.1 Diagrama
El siguiente diagrama ilustra la secuencia de pago y cmo participan los distintos actores en una transaccin Mall Normal.

sd Secuencia Flujo Webpay Transaccin Mall 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()

Ilustracin 5: Diagrama de secuencia de Transaccin Mall Normal

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8.2.2 Descripcin 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 mtodo Web, getTransactionResult () (mientras
decide pagar a travs de Webpay. se despliega la pgina de transicin*8), para obtener el *8
resultado de la autorizacin. Se recomienda que el resultado
20. El comercio inicia una transaccin en Webpay, invocando de la autorizacin sea persistida en los sistemas del comercio,
el mtodo initTransaction(). ya que este mtodo se puede invocar una nica vez por
transaccin.
21. Webpay procesa el requerimiento y entrega como
resultado de la operacin el token de la transaccin y 30. Webpay responde el resultado de la invocacin del mtodo
URL de redireccionamiento a la cual se deber redirigir al getTransactionResult().
tarjetahabiente.
31. Para informar a Webpay que el resultado de la transaccin
22. Comercio redirecciona al tarjetahabiente hacia Webpay, se ha recibido sin problemas, el sistema del comercio consume
con el token de la transaccin a la URL indicada en punto 3. La el tercer mtodo acknowledgeTransaction().
redireccin se realiza enviando por mtodo POST el token en
variable token_ws. NOTA: De no ser consumido demorar ms de 30 segundos
en su consumo, Webpay realizar la reversa de la transaccin,
23. El navegador Web del tarjetahabiente realiza una peticin asumiendo que existieron problemas de comunicacin.
HTTPS a Webpay, en base al redireccionamiento generado
por el comercio en el punto 4. 32. Una vez recibido el resultado de la transaccin e informado
a Webpay su correcta recepcin, 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
comunicacin 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 transaccin, informacin 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 mtodo
opciones de pago a travs de crdito o dbito. getTransactionResult() enviando por mtodo POST el
token de la transaccin 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 transaccin se encuentre aprobada.
26. Webpay procesa la solicitud de autorizacin para cada uno
de los pagos de las tiendas. 34. Webpay identifica la transaccin y despliega el comprobante
de pago al tarjetahabiente.
27. Una vez resuelta la autorizacin 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 enva tarjetahabiente es redirigido de vuelta al sitio del comercio,
por mtodo POST el token de la transaccin en la variable por medio de redireccionamiento con el token en la variable
token_ws. token_ws enviada por mtodo POS, hacia la pgina final
informada por el comercio en el mtodo initTransaction().
28. El navegador Web del tarjetahabiente realiza una peticin
HTTP/HTTPS al sitio del comercio, en base a la redireccin 36. Sitio del comercio despliega pgina final de pago*9. *9
generada por Webpay en el punto 9.

*8 El detalle de la pgina de transicin se encuentra descrito en


*9 Anexo A, del documento de descripcin general de la API SOAP.

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8.3 Flujo Alternativo: Secuencia de pago en una transaccin


mall normal anulada en formulario de pago

El siguiente diagrama ilustra la secuencia de una transaccin


normal donde el TH anula la transaccin en el formulario de pago
de Webpay y cmo participan los distintos actores en esta situacin.

Ilustracin 6. Botn anular formulario de pago en Webpay

sd Secuencia Flujo Webpay Transaccin Anulada

TARJETAHABIENTE COMERCIO WEBPAY WS

1 Pagar con Webpay()

2 initTransaction()

3 Response() :token, urfFormOfPayment

4 Redirect(token...)

5 Request(token)

6 Formulario Webpay()

7 Anular()

8 Redirect()

9 Request(token)

10 Pagina final()

Ilustracin 7: Diagrama de secuencia de pago en una transaccin mall normal anulada en formulario de pago

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8.3.1 Descripcin de secuencia alternativa, anular: despliega la pgina de transicin*10), para obtener el resultado *10
2. Pasos de 1 a 6 son idnticos a la secuencia normal. de la autorizacin. En este caso debe obtener una excepcin,
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, segn anexo glosa transaccin no autorizada.
redireccionamiento HTTP/HTTPS hacia la pgina de final del
comercio, en donde se enva por mtodo POST el token de la 8.4 Flujo Alternativo: Secuencia de pago en una transaccin
transaccin 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 mtodo Web, getTransactionResult()(mientras se

sd Secuencia Flujo Webpay Webservice Transaccin

TARJETAHABIENTE COMERCIO WEBPAY WS

1 Pagar con Webpay()

2 initTransaction()

3 Response() :token, urfFormOfPayment

4 Redirect(token...)

5 Request(token)

6 Formulario Webpay()

7 Timeout()

8 Error() : Pgina de error

Ilustracin 8: Diagrama de secuencia de Transaccin con Timeout en Formulario

*10 El detalle de la pgina de transicin se encuentra descrito en Anexo


A, 12.1.1, del documento de descripcin general de la API SOAP.

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8.4.2 Descripcin de secuencia alternativa, timeout: 8.5 Descripcin de mtodos del Servicio Web de Transaccin
2. Pasos de 1 a 6 son idnticos a la secuencia normal. de Autorizacin Mall Normal

9. Tarjetahabiente est en formulario Webpay, pero no presiona A continuacin, se describen cada uno de las operaciones que
pagar durante 10 minutos. Esto causa un timeout en dicho deben ser utilizadas en una Transaccin Mall Normal.
formulario.
8.5.1 Operacin initTransaction
10. Webpay genera un error de timeout, se presenta una Mtodo que permite iniciar una transaccin de pago Webpay.
pantalla indicando que ocurri un error. No se regresa
automticamente al comercio. 8.5.1.1 Parmetro de entrada

NOMBRE DESCRIPCIN
tns:wsTransactionType
WSTransactionType
Indica el tipo de transaccin, su valor debe ser siempre TR_NORMAL_WS
xs:string
sessionId (Opcional) Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin.
Largo mximo: 61
xs:anyURI
returnURL (Obligatorio) URL del comercio, a la cual Webpayredireccionar posterior al proceso de autorizacin.
Largo mximo: 256
xs:anyURI
finalURL (Obligatorio) URL del comercio a la cual Webpayredireccionar posterior al voucher de xito de Webpay.
Largo mximo 256
tns:wsTransactionDetail
(Obligatorio) Lista de objetos del tipo wsTransactionDetail, el cual contiene datos de la transaccin. Mxima
transactionDetails
cantidad de repeticiones es de 1 para este tipo de transaccin.
wsTransactionDetail est descrito ms adelante.
tns:wPMDetail
wPMDetail
(No se utiliza para Transaccin Normal) Este campo contiene la transaccin webpay mensual.
xs:string
(Obligatorio)Es el cdigo nico de identificacin del comercio entregado por Transbank.
commerceId En este caso el commerceID corresponde al cdigo asignado al PST (o cdigo mall), y que agrupa los cdigos de
comercio que recibirn los pagos.
Largo: 12
xs:string
buyOrder
(Obligatorio)Es el cdigo nico de la orden de compra generada por el comercio mall.

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

TYPE WSTRANSACTIONDETAIL
Descripcin: Tipo de dato contiene detalles de la transaccin

CAMPO DESCRIPCIN
xs:decimal
amount Monto de la transaccin. Mximo 2 decimales para USD.
Largo mximo: 10
xs:string
Orden de compra de la tienda.*11
buyOrder
Largo mximo: 26
La orden de compra puede tener: Nmeros, letras, maysculas y minsculas, y los signos |_=&%.,~:/?[+!@()>-
xs:string
commerceCode Cdigo comercio de la tienda entregado por Transbank.
Largo: 12
sharesAmount Campo no utilizado
sharesNumber Campo no utilizado

8.5.1.2 Parmetros de salida:TypewsInitTransactionOutput 8.5.2 Operacin getTransactionResult


Mtodo que permite obtener el resultado de la transaccin y
CAMPO DESCRIPCIN los datos de la misma.
xs:string 8.5.2.1 Parmetros de entrada
token Token de la transaccin.
Largo: 64 CAMPO DESCRIPCIN
xs:string xs:string
url URL de formulario de pago Webpay tokenInput Token de la transaccin.
Largo mximo: 256 Largo: 64

*11 Debe cumplir con el formato de caracteres permitidos

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

8.5.2.2 Parmetros de salida: TypeTransactionResultOutput

CAMPO DESCRIPCIN
xs:string
buyOrder Orden de compra del mall.
Largo mximo: 26
xs:string
sessionId
Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin. Largo mximo: 61
Tns:carddetails
cardDetails
Objeto que representa los datos de la tarjeta de crdito del tarjetahabiente. cardDetails descrito ms adelante.
xs:string
accoutingDate Fecha de la autorizacin.
Largo: 4, formato MMDD
xs:string
transactionDate Fecha y hora de la autorizacin.
Largo: 6, formato: MMDDHHmm
xs:string
Resultado de la autenticacin para comercios Webpay Plus y/o 3D Secure, los valores posibles son los siguientes:
TSY : Autenticacin exitosa
TSN : Autenticacin fallida.
VCI TO*12 : Tiempo mximo excedido para autenticacin.
ABO : Autenticacin abortada por tarjetahabiente.
U3 : Error interno en la autenticacin.
Puede ser vaco si la transaccin no se autentic.
Largo mximo: 3
xs:string
urlRedirection URL de redireccin para visualizacin de voucher.
Largo mximo: 256
tns:wsTransactionDetailOutput
detailsOutput
detailsOutput Objeto que contiene el detalle de la transaccin financiera. Descrito ms adelante

TYPECARDDETAIL
Descripcin: Tipo de dato contiene detalles de la tarjeta de crdito.

CAMPO DESCRIPCIN
xs:string
4 ltimos nmeros de la tarjeta de crdito del tarjeta habiente.
cardNumber
Solo para comercios autorizados por Transbank se enva el nmero completo. La fecha de expiracin llegara nula.
Largo mximo: 16
xs:string
(Opcional) Fecha de expiracin de la tarjeta de crdito del tarjetahabiente. Formato YYMM
cardExpirationDate
Solo para comercios autorizados por Transbank.
Largo mximo: 4

*12 VCI=TO indica que se produjo un time-out en el proceso de autenticacin bancaria. Esta transaccin no ser autorizada y seguir el flujo normal de eventos.

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


8 TRANSACCIN DE AUTORIZACIN MALL NORMAL

TYPEWSTRANSACTIONDETAILOUTPUT
Descripcin: Tipo de dato contiene el detalle del resultado de la transaccin.

CAMPO DESCRIPCIN
xs:string
authorizationCode Cdigo de autorizacin de la transaccin
Largo mximo: 6
xs:string
Tipo de pago de la transaccin.
VD = Venta Dbito
VN = Venta Normal
paymentTypeCode
VC = Venta en cuotas
SI = 3 cuotas sin inters
S2 = 2 cuotas sin inters
NC = N Cuotas sin inters
xs:string
Cdigo de respuesta de la autorizacin. Valores posibles:
0 Transaccin aprobada
-1 Rechazo de transaccin
-2 Transaccin debe reintentarse
responseCode -3 Error en transaccin
-4 Rechazo de transaccin
-5 Rechazo por error de tasa
-6 Excede cupo mximo mensual
-7 Excede lmite diario por transaccin
-8 Rubro no autorizado
xs:decimal
Amount Monto de la transaccin
Largo mximo: 10
xs:int
sharesNumber Cantidad de cuotas
Largo mximo: 2
xs:string
commerceCode Cdigo comercio de la tienda
Largo: 12
xs:string
buyOrder Orden de compra del mall.
Largo mximo: 26

8.5.3 Operacin acknowledgeTransaction


Mtodo que permite informar a Webpay la correcta recepcin
del resultado de la transaccin.
En caso de llamar al mtodo acknowledgeTransaction
8.5.3.1 Parmetros de entrada: acknowledgeTransaction despus de 30 segundos de ocurrida la autorizacin, se informar
la excepcin descrita ms abajo y el comercio no debe entregar
CAMPO DESCRIPCIN producto o servicio, ya que la transaccin ha sido reversada por
Webpay:
xs:string
token Token de la transaccin. Timeout error (Transactions REVERSED) con cdigo 277.
Largo: 64

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


9 TRANSACCIN ONECLICK

9 TRANSACCIN ONECLICK

9.1 Descripcin de la Transaccin de OneClick


La modalidad de pago OneClick permite al tarjetahabiente realizar El proceso de integracin 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
informacin de la tarjeta de crdito al momento de realizar la compra. dispuestos por Transbank para la inscripcin de los tarjetahabientes,
El modelo de pago contempla un proceso previo de inscripcin o as como para la realizacin de los pagos.
enrolamiento del tarjetahabiente, a travs del comercio, que desee
utilizar el servicio. Este tipo de pago facilita la venta, disminuye el 9.2 Resumen de los mtodos del servicio Web
tiempo de la transaccin y reduce los riesgos de ingreso errneo de
los datos del medio de pago.

MTODO DESCRIPCIN GENERAL


Permite realizar la inscripcin del tarjetahabiente e informacin de su tarjeta de crdito. Retorna como respuesta
un token que representa la transaccin de inscripcin y una URL (UrlWebpay), que corresponde a la URL de
inscripcin de OneClick.
initInscription
Una vez que se llama a este servicio Web, el usuario debe ser redireccionado va POST a urlWebpay con parmetro
TBK_TOKEN igual al token obtenido.
Permite finalizar el proceso de inscripcin 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 inscripcin en Transbank el usuario es enviado a la URL de fin de inscripcin que
defini el comercio. En ese instante el comercio debe llamar a finishInscription.
Permite realizar transacciones de pago. Retorna el resultado de la autorizacin. Este mtodo que debe ser
authorize
ejecutado, cada vez que el usuario selecciona pagar con OneClick.
Permite reversar una transaccin de venta autorizada con anterioridad. Este mtodo retorna como respuesta un
codeReverseOneClick
identificador nico de la transaccin de reversa.

9.3 Inscripcin en Oneclick El comercio enva el browser del cliente a la URL obtenida y
9.3.1 Descripcin pasa por parmetro el token (mtodo POST).
La inscripcin 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 inscripcin, 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 pgina del comercio al flujo normal de pago. En este punto se realiza una transaccin
antes de iniciar la inscripcin. 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 pgina del comercio, Finalizada la inscripcin, Webpay enva el browser del
mediante su nombre de usuario y clave. cliente a la URL entregada por el comercio, pasando por
parmetro el token.
El cliente selecciona la opcin de inscripcin, la cual debe estar
explicada en la pgina del comercio. El comercio debe consumir otro servicio web de Transbank,
con el token, para obtener el resultado de la inscripcin 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 trmino; obtiene realizar los pagos.
un token y URL de Webpay.
El comercio presenta al cliente el resultado de la inscripcin.

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


9 TRANSACCIN ONECLICK

9.3.2 Diagrama

Inscripcin

CLIENTE COMERCIO WEBPAY BANCO


Login comercio

Selecciona
Inscripcin Login comercio
username/email

Token initInscription

Token

Pantalla
ingreso de
datos tarjeta Datos tarjeta

Token banco

Pantalla
autenticacin
del banco username y password

Token banco

Token

Token

finishInscription
user_tbk_id

Comercio
presenta
resultado

Ilustracin 9: Diagrama de flujo proceso de inscripcin

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


9 TRANSACCIN ONECLICK

9.3.3 Mtodo initInscription 9.5 Transaccin de Pago Oneclick


El pago es el proceso donde el comercio solicita el cargo de una
Mtodo Web Service compra a la tarjeta de crdito de un usuario inscrito anteriormente,
Permite gatillar el inicio del proceso de usando el identificador entregado por Transbank al momento de
initInscription
inscripcin la inscripcin.
{username}, {id usuario Transbank}
Recibe Los pagos en esta modalidad no requieren necesariamente la
Username : String (255)
intervencin del usuario.
Id usuario Transbank : String (255)
{ booleano que indica si la inscripcin fue dada
de baja correctamente) El monto del pago debe estar dentro de los lmites 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 pgina o aplicacin del
comercio mediante su nombre de usuario y clave.
Una vez que se llama a este webservice el usuario debe ser
redireccionado va POST a urlWebpay con parmetro TBK_TOKEN
igual al token. El cliente selecciona la opcin de pagar con Webpay Oneclick.

El comercio usa el servicio web de pago, publicado por


9.4 Eliminar registro de inscripcin de usuario Transbank, entregando el identificador de usuario (que se obtuvo
En el caso que el comercio requiera eliminar la inscripcin de en la inscripcin), el monto del pago y la orden de compra.
un usuario en Webpay OneClick ya sea por la eliminacin de un Obtiene la respuesta con el cdigo de autorizacin.
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 inscripcin.
Pago
Mtodo Web Service
Permite eliminar una inscripcin 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 inscripcin fue dada Selecciona
de baja correctamente) producto
Retorna y pagar Pagar
id_user_tbk, monto
Return: boolean (true/false)
cod_autor, id_trx
Resultado

Ilustracin 10: Diagrama de Flujo de Pago Oneclick.

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


9 TRANSACCIN ONECLICK

Mtodo 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 autorizacin de la transaccin.
{username}, {id usuario Transbank}, {monto},
{orden de compra}.
String (255) Mtodo Web Service
Recibe
String (255) Permite reversar una venta y se obtiene
Number (19,2) codeReverseOneClick el resultado de la reversa y un cdigo de
String (255) reversa en caso que esta sea exitosa.
{cdigo de respuesta}, {cdigo de autorizacin}, {orden de compra}
}, {marca de tarjeta}, Recibe
Retorna Orden de compra: Long
{ltimos 4 dgitos}, {id de la transaccin}
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 cdigo regresado por este mtodo, es un identificador nico de
concretarse, dentro del mismo da contable, con la finalidad de
la transaccin de reversa.
anular un cargo realizado al cliente.

9.7 Definicin detallada de mtodos del Servicio Web

finishInscription
INPUT

token Identificador del proceso de inscripcin, entregado por Webpay en el mtodo initInscription
OUTPUT
responseCode Cdigo de retorno del proceso de inscripcin, donde 0 (cero) es aprobado.
authCode Cdigo que identifica la autorizacin de la inscripcin.
creditCardType Indica el tipo de tarjeta que fue inscrita por el cliente ( Visa, AmericanExpress, MasterCard, Diners, Magna).
last4CardDigits Los ltimos 4 dgitos de la tarjeta ingresada por el cliente en la inscripcin.
tbkUser Identificador nico de la inscripcin del cliente, este debe ser usado para realizar pagos, o borrar la inscripcin.

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


9 TRANSACCIN ONECLICK

authorize
INPUT

amount Monto del pago en pesos.


tbkUser Identificador nico de la inscripcin 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 dgitos.
buyOrder
Ej: Para la tercera transaccin realizada el da 15 de julio de 2011 a las 11:55:50 la orden de compra sera:
20110715115550003.
OUTPUT
Cdigo 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 Lmites Oneclick, mximo monto diario de pago excedido
-98 Lmites Oneclick, mximo monto de pago excedido
-99 Lmites Oneclick, mxima cantidad de pagos diarios excedido
authCode Cdigo de autorizacin de la transaccin de pago.
last4CardDigits Indica el tipo de tarjeta que fue inscrita por el cliente (Visa, AmericanExpress, MasterCard, Diners, Magna).
creditCardType Los ltimos 4 dgitos de la tarjeta ingresada por el cliente en la inscripcin.
transactionId Identificador nico de la transaccin de pago, se utiliza para la reversa, si fuera necesario

removeUser
INPUT

tbkUser Identificador nico de la inscripcin del cliente


username Nombre de usuario, del cliente, en el sistema del comercio.
OUTPUT
booleano Retorno verdadero, si fue posible eliminar la inscripcin. Falso de lo contrario.

El proceso de integracin con Webpay Oneclick consiste en


desarrollar por parte del comercio las llamadas a los servicios
web dispuestos por Transbank para la inscripcin de los
tarjetahabientes, as como para la realizacin de los pagos.

Resumen de los mtodos del servicio Web

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


10 TRANSACCIN DE CAPTURA DIFERIDA

10 TRANSACC IN DE CAPTURA DIFERIDA

10.1 Descripcin de la captura diferida con autorizacin sin captura y el monto requerido para capturar el
Este mtodo permite a todo comercio habilitado realizar capturas de cual debe ser menor o igual al monto originalmente autorizado.
una transaccin autorizada sin captura en plataforma Webpay 3G.
El mtodo contempla una nica captura por cada autorizacin. Para Las ejecuciones con errores entregarn un SoapFault de acuerdo
ello se deber indicar los datos asociados a la transaccin de venta a la codificacin de errores definida.

Resumen del mtodo del servicio web de captura diferida

MTODO DESCRIPCIN GENERAL


Permite solicitar a Webpay la captura diferida de una transaccin con autorizacin y sin captura simultnea.
capture
El mtodo capture debe ser invocado siempre indicando el cdigo del comercio que realiz la transaccin.
En el caso de comercios MALL, el cdigo debe ser el cdigo de la tienda virtual.

10.2 Descripcin del mtodo del servicio web de captura diferida


10.2.1 Operacin capture
Mtodo que permite realizar la captura de una transaccin.

PARMETROS DE ENTRADA
CAMPO DESCRIPCIN
xs:string
authorizationCode Cdigo de autorizacin de la transaccin que se requiere capturar
Largo mximo: 6
xs:string
buyOrder Orden de compra de la transaccin que se requiere capturar
Largo mximo: 26
xs:long
commerceId Cdigo de comercio o tienda mall que realiz la transaccin
Largo: 12
xs:decimal
captureAmount Monto que se desea capturar
Largo mximo: 10
PARMETROS DE SALIDA
CAMPO DESCRIPCIN
xs:string
token
Token de la transaccin
xs:string
authorizationCode
Cdigo de autorizacin de la captura diferida
xs:dateTime
authorizationDate
Fecha y hora de la autorizacin
xs:decimal
captureAmount
Monto capturado

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


10 TRANSACCIN DE CAPTURA DIFERIDA

10.2.2 Cdigos de error


Los siguientes son cdigos de error exclusivos del mtodo Capture

CDIGO DESCRIPCIN
304 Validacin de campos de entrada nulos
245 Cdigo 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 Operacin no permitida
274 Transaccin no encontrada
16 La transaccin no es de captura diferida
292 La transaccin no est autorizada
284 Periodo de captura excedido
310 Transaccin reversada previamente
309 Transaccin capturada previamente
311 Monto a capturar excede el monto autorizado
315 Error del autorizador

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


11 TRANSACCIN DE ANULACIN

11 TRANSACCIN DE ANULACIN

11.1 Descripcin de la anulacin autorizado en la venta en lnea.


Este mtodo permite a todo comercio habilitado anular una
transaccin que fue generada en plataforma Webpay 3G. El mtodo Webpay soporta una sola anulacin parcial para la transaccin de
contempla anular total o parcialmente una transaccin. Para ello venta en lnea. En caso de enviar una segunda anulacin parcial se
se deber indicar los datos asociados a la transaccin de venta en retornar una Exception.
lnea que se desea anular y los montos requeridos para anular. Se
considera totalmente anulada una transaccin cuando el monto Las ejecuciones con errores entregarn un SoapFault de acuerdo a
anulado o el monto total de anulaciones cursadas alcancen el monto la codificacin de errores definida.

Resumen del mtodo del servicio web de anulacin de transacciones

MTODO DESCRIPCIN GENERAL


Permite solicitar a Webpay la anulacin de una transaccin realizada previamente y que se encuentra vigente.
Nullify
El mtodo nullify debe ser invocado siempre indicando el cdigo del comercio que realiz la transaccin.
En el caso de comercios MALL, el cdigo debe ser el cdigo de la tienda virtual.

11.2 Descripcin del mtodo del servicio web de anulacin de 10.2.1 Operacin nullify
transacciones Mtodo que permite anular una transaccin de pago Webpay.

PARMETROS DE ENTRADA
CAMPO DESCRIPCIN
xs:string
Cdigo de autorizacin de la transaccin que se requiere anular. Para el caso que se est anulando una transaccin
authorizationCode
de captura en lnea, este cdigo corresponde al cdigo de autorizacin de la captura.
Largo mximo: 6
xs:decimal
Monto autorizado de la transaccin que se requiere anular. Para el caso que se est anulando una transaccin de
authorizedAmount
captura en lnea, este monto corresponde al monto de la captura.
Largo mximo: 10
xs:string
buyOrder Orden de compra de la transaccin que se requiere anular
Largo mximo: 26
xs:long
commerceId Cdigo de comercio o tienda mall que realiz la transaccin
Largo: 12
xs:decimal
ullifyAmount Monto que se desea anular de la transaccin
Largo mximo: 10
PARMETROS DE SALIDA
CAMPO DESCRIPCIN
xs:string
token
Token de la transaccin
xs:string
authorizationCode
Cdigo de autorizacin de la anulacin
xs:dateTime
authorizationDate
Fecha y hora de la autorizacin
xs:decimal
Balance
Saldo actualizado de la transaccin (considera la venta menos el monto anulado)
xs:decimal
nullifiedAmount
Monto anulado

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


11 TRANSACCIN DE ANULACIN

11.2.2 Cdigos de error


Los siguientes cdigos de error son los ms comunes asociados al mtodo de anulacin

CDIGO DESCRIPCIN
304 Validacin de campos de entrada nulos
245 Cdigo 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 Operacin no permitida
274 Transaccin no encontrada
16 La transaccin no permite anulacin
292 La transaccin no est autorizada
284 Periodo de anulacin excedido
310 Transaccin anulada previamente
311 Monto a anular excede el saldo disponible para anular
312 Error genrico para anulaciones
315 Error del autorizador

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


12 ANEXOS

12 ANEXOS

12.1 Anexo A: Creacin de llaves y ambientes Webpay


12.1.1 Creacin de llave privada y certificado pblico 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 pblico productivo de un comercio cuyo cdigo 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 cdigo 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 servers 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 pblico utilizando el siguiente comando, procurando indicar 1460
on la llave privada y el CSR creados, debe crear el certificado das o ms, para la duracin 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 pblico, como asimismo es responsable por reemplazar
estos cuando caduquen.
Y es ste ltimo (crt) es el que el comercio comparte con
Transbank para la habilitacin de su comercio en produccin.

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


12 ANEXOS

12.1.2 Ambientes de Webpay


Endpoint integracin / Validacin

https://webpay3gint.transbank.cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl

Certificado pblico Webpay integracin

-----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 Produccin

https://webpay3g.transbank.cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl

Certificado pblico 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-----

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


12 ANEXOS

12.2 Anexo B: Requerimientos de pginas de transicin y de Monto y moneda de la transaccin


pgina de fin de transaccin Cdigo de autorizacin de la transaccin
12.2.1 Requerimientos Pgina de Transicin Fecha de la transaccin
La pgina de transicin de comercio, es la pgina que muestra Tipo de pago realizado (Dbito o Crdito)
el comercio cuando Webpay le entrega el control, despus del Tipo de cuota
proceso de autorizacin y previo a redirigir al tarjeta habiente al Cantidad de cuotas
comprobante de xito de la transaccin. Aplica para todos los 4 ltimos dgitos de la tarjeta bancaria
tipos de transacciones. Descripcin de los bienes y/o servicios

Es recomendable que en esta pgina muestre la imagen de 12.2.3 Requerimientos Pgina final de fracaso
background del formulario de pago, que se encuentra en la URL Cuando la transaccin 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 Pgina final de xito
Una vez finalizada a transaccin, el comercio debe presentar una Las posibles causas de este rechazo son:
pgina al tarjetahabiente para que este se informe del resultado
- Error en el ingreso de los datos de su tarjeta de Crdito
de la transaccin. La informacin a presentar depender de si la
o Dbito (fecha y/o cdigo de seguridad).
transaccin fue autorizada o no.
- Su tarjeta de Crdito o Dbito no cuenta con saldo
Se recomienda, como mnimo, que posea suficiente.
Nmero de orden de Pedido - Tarjeta aun no habilitada en el sistema financiero.
Nombre del comercio (Tienda de Mall)

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


12 ANEXOS

12.2 Anexo C: Excepciones SOAP API Webpay


Las excepciones ms comunes que pueden ser presentadas en cualquier integracin 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

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


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

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


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

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


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 validacin efectuada por Transbank


12.4.1 Pruebas de validacin para Transaccin Normal, 12.4.3 Pruebas de validacin para Transaccin Normal
modalidad plugin captura diferida
Pago crdito exitoso sin cuotas Pago crdito exitoso sin cuotas
Pago crdito exitoso con cuotas Pago crdito exitoso con cuotas
Pago crdito denegado Pago crdito denegado
Pago dbito exitoso Pago cancelado (abortado en formulario Webpay)
Pago dbito denegado Anulacin parcial (solo si integra el mtodo)
Pago cancelado (abortado en formulario Webpay) Anulacin total (solo si integra el mtodo)

12.4.2 Pruebas de validacin para Transaccin Normal 12.4.4 Pruebas de validacin para Transaccin Mall
Pago crdito exitoso sin cuotas Pago crdito exitoso sin cuotas
Pago crdito exitoso con cuotas Pago crdito exitoso con cuotas
Pago crdito denegado Pago crdito denegado
Pago dbito exitoso Pago dbito exitoso
Pago dbito denegado Pago dbito denegado
Anulacin parcial (solo si integra el mtodo) Anulacin parcial (solo si integra el mtodo)
Anulacin total (solo si integra el mtodo) Anulacin total (solo si integra el mtodo)
Pago cancelado (abortado en formulario Webpay) Pago cancelado (abortado en formulario Webpay)

12.4.5 Pruebas de validacin para Transaccin OneClick
Inscripcin rechazada
Inscripcin exitosa
Autorizacin
Reversa

Remover usuario

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


12 ANEXOS

12.5 Anexo D: Referencias

https://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-os-SOAPMessageSecurity.pdf

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