REFERENCIA APISOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) CONTENIDO ÍNDICE INTERACTIVO Haz click en número de capítulo o de página para acceder directamente. 1 CONTROL DE CAMBIOS 5 2 PREFACIO 5 5 2.1 Acerca de esta guía 5 2.2 Audiencia 5 2.3 Feedback para esta documentación 3 SOBRE WEBPAY 6 6 3.1 Introducción a Webpay 6 3.2 Tipos de Transacciones Webpay 7 3.3 Autorización y captura de transacciones de crédito 7 3.4 Anulación de transacciones 8 3.5 Monedas soportadas 8 3.6 Autenticación del tarjetahabiente 8 3.7 Compatibilidad con navegadores Web 9 3.8 Tipos de pago (productos) 4 CONSIDERACIONES GENERALES 10 10 4.1 Comunicación 10 4.2 Seguridad 10 4.3 Deberes de los comercios 10 4.3.1 Validación de mensajes de solicitud y respuesta 10 4.3.2 Actualizaciones de plugins y SDK 5 API SOAP DE WEBPAY 11 11 5.1 Aspectos de Seguridad de API SOAP 11 5.1.1 Información general 11 5.1.2 Generación de llave y certificado auto-firmado 6 INTEGRACIÓN, VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN 12 12 6.1 Etapas de integración de Webpay 12 6.1.1 Etapa de integración 12 6.1.2 Etapa de validación de Integración 13 6.1.3 Etapa de puesta en producción 13 6.2 Ambientes 7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 14 14 7.1 Descripción de la Transacción de Autorización Normal 15 7.2 Secuencia de pago en una transacción normal 15 7.2.1 Diagrama 16 7.2.2 Descripción de la secuencia REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 2 17 7.3 Flujo Alternativo: Secuencia de pago en una transacción normal anulada en formulario de pago 17 7.3.1 Diagrama 18 7.3.2 Descripción secuencia de pago para transacción anulada en formulario de pago 18 7.4 Flujo Alternativo: Secuencia de pago en una transacción normal con evento de timeout 18 7.4.1 Diagrama 19 7.4.2 Descripción de secuencia timeout en transacción normal 19 7.5 Descripción de métodos del Servicio Web de Transacción de Autorización Normal 19 7.5.1 Operación initTransaction 20 7.5.2 Operación getTransactionResult 22 7.5.3 Operación acknowledgeTransaction 8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 23 23 8.1 Descripción de la Transacción de Autorización Mall Normal 24 8.2 Secuencia de pago en una transacción de autorización Mall Normal 24 8.2.1 Diagrama 25 8.2.2 Descripción de la secuencia 26 8.3 Flujo Alternativo: Secuencia de pago en una transacción mall normal anulada en formulario de pago 27 8.3.1 Descripción de secuencia alternativa, anular 27 8.4 Flujo Alternativo: Secuencia de pago en una transacción mall normal con evento de timeout 27 8.4.1 Diagrama 28 8.4.2 Descripción de secuencia alternativa, timeout 28 8.5 Descripción de métodos del Servicio Web de Transacción de Autorización Mall Normal 28 8.5.1 Operación initTransaction 29 8.5.2 Operación getTransactionResult 31 8.5.3 Operación acknowledgeTransaction 9 TRANSACCIÓN ONECLICK 32 32 9.1 Descripción de la Transacción de OneClick 32 9.2 Resumen de los métodos del servicio Web 32 9.3 Inscripción en Oneclick 32 9.3.1 Descripción 33 9.3.2 Diagrama 34 9.3.3 Método initInscription 34 9.4 Eliminar registro de inscripción de usuario 34 9.5 Transacción de Pago Oneclick 35 9.6 Reversa de Pagos Autorizados 35 9.7 Definición detallada de métodos del Servicio Web 10 TRANSACCIÓN DE CAPTURA DIFERIDA 37 37 10.1 Descripción de la captura diferida 37 10.2 Descripción del método del servicio web de captura diferida 37 10.2.1 Operación capture 38 10.2.2 Códigos de error REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 3 11 TRANSACCIÓN DE ANULACIÓN 39 39 11.1 Descripción de la anulación 39 11.2 Descripción del método del servicio web de anulación de transacciones 39 11.2.1 Operación nullify 40 11.2.2 Códigos de error 12 ANEXOS 41 41 12.1 Anexo A: Creación de llaves y ambientes Webpay 41 12.1.1 Creación de llave privada y certificado público 42 12.1.2 Ambientes de Webpay 43 12.2 Anexo B: Requerimientos de páginas de transición y de página de fin de transacción 43 12.2.1 Requerimientos Página de Transición 43 12.2.2 Requerimientos Página final de éxito 43 12.2.3 Requerimientos Página final de fracaso 44 12.3 Anexo C: Excepciones SOAP API Webpay 47 12.4 Anexo D: Pruebas de validación efectuada por Transbank 47 12.4.1 Pruebas de validación para Transacción Normal, modalidad plugin 47 12.4.2 Pruebas de validación para Transacción Normal 47 12.4.3 Pruebas de validación para Transacción Normal captura diferida 47 12.4.4 Pruebas de validación para Transacción Mall 47 12.4.5 Pruebas de validación para Transacción OneClick 48 12.5 Anexo D: Referencias REFERENCIA API SOAP WEBPAY TRANSBANK S.A. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 4 • WS-Security • Generación y validación de firma digital en mensajes SOAP. posea conocimiento técnico de al menos en los siguientes temas: Antes de continuar. 08-06-2017 1. DOCUMENTO DE ESPECIFICACIONES (V 1. por lo que es importante prestar atención a las obligaciones.1 Acerca de esta guía 2.1 CONTROL DE CAMBIOS 2 PREFACIO 1 CONTROL DE CAMBIOS FECHA VERSIÓN DESCRIPCIÓN DEL CAMBIO 22-05-2017 1.3 Feedback para esta documentación Ayúdanos a mejorar esta información enviándonos comentarios a: El presente manual se considera parte íntegra del contrato. REFERENCIA API SOAP WEBPAY TRANSBANK S.0) 5 . al menos. 2 PREFACIO 2. Mall Normal.0 Liberación inicial de documento de API SOAP de integración Webpay. 2. es necesario declarar que para tener una visión general de los productos y modalidades asociadas a Webpay se • Servicios Web recomienda leer el manual Operacional de Webpay.cl sugerencias e indicaciones descritas en el presente documento. [email protected] Audiencia Esta guía describe los aspectos técnicos y operativos que deben Esta guía está dirigida a implementadores que realizan la ser considerados en la integración con Webpay utilizando API integración de Webpay en comercios utilizando la API SOAP para SOAP para los servicios web para Transacción de Autorización soportar en estos el pago con tarjetas bancarias.A. OneClick y Anulaciones. Se recomienda que quién realice la integración. Normal.1 Corrige largo de código de autorización. • La seguridad es reforzada por medio de la utilización de servidores seguros. DOCUMENTO DE ESPECIFICACIONES (V 1. Durante el proceso de pago se autentica crédito y débito.1 Introducción a Webpay dependiendo de los productos contratados por el comercio. con clave para el desarrollo de un comercio electrónico eficaz y seguro el objetivo de validar que la tarjeta este siendo utilizada por el en Chile. autorización y si ésta es aprobada. El registro de la tarjeta queda almacenado en One Click Webpay en forma segura y asociado al login de usuario de la tienda. Hoy en día Webpay constituye una herramienta al tarjetahabiente antes de realizar la transacción financiera.2 • En transacciones con Webpay Plus se solicita al tarjetahabiente autenticarse con su emisor. pagar. y el ingreso asociado a los datos de la tarjeta de crédito o débito lo realiza en forma segura en Webpay. selecciona productos o servicio de distintas tiendas. protegidos con TLS 1. y el ingreso asociado a los datos de la tarjeta de crédito o débito lo realiza en forma segura en Webpay.3 SOBRE WEBPAY 3 SOBRE WEBPAY 3.2 Tipos de Transacciones Webpay Los tipos de transacciones disponibles a través de servicios Web son los siguientes: Una transacción normal corresponde a una solicitud de autorización financiera de un pago con tarjetas de crédito o Normal débito. Una transacción Mall corresponde a múltiples solicitudes de autorización financiera de distintos códigos de comercios pertenecientes a un comercio padre. Una vez realizado esto. • Permite realizar transacciones seguras y en línea a través de Internet. REFERENCIA API SOAP WEBPAY TRANSBANK S. de esta forma cada vez que un tarjetahabiente realiza una compra en la tienda. Cada transacción constituye un pago con tarjetas de crédito o débito en una Mall tienda en particular. Webpay entrega al sistema del comercio el resultado de la En general un flujo de pago en Webpay se inicia desde el comercio. 3. Una transacción OneClick permite que el tarjetahabiente registre su tarjeta de crédito nacional una única vez y los pagos los realice en un solo click en la tienda de comercio electrónico. elige pagar con Webpay en donde. titular. El tarjetahabiente ingresa al sitio del comercio. selecciona productos o servicio. se Webpay es una pasarela de pago desarrollada por Transbank para despliegan las alternativas de pago de crédito con productos cuotas realizar transacciones desde Internet con tarjetas bancarías de y/o débito Redcompra. Una vez resuelta la autenticación se procede a autorizar el pago. Webpay emite un comprobante en donde el tarjetahabiente selecciona los productos o servicios a electrónico del pago. protegiendo de esta forma al • Firma digital.A. basta con que inicie sesión en esta y presione pagar para enviar todos los datos asociados a la transacción. Sitio del Webpay Autenticación Sitio del Webpay Sitio del Comercio Formulario en Banco Comercio Comprobante Comercio de Pago Emisor de pago Dentro de los atributos más relevantes de Webpay se pueden comercio por eventuales fraudes o desconocimientos de mencionar: compra.0) 6 . El tarjetahabiente ingresa al sitio del comercio padre. de no ser así la retención de la tarjeta de crédito del cliente será reversada. vía captura.3 Autorización y captura de transacciones de crédito la cuenta de crédito asociada a la tarjeta del titular. DOCUMENTO DE ESPECIFICACIONES (V 1. 2 cuotas sin interés . Estas y captura.4 Anulación de transacciones querer hacerlo se debe entregar el dinero en efectivo al cliente. Para ello se deberá indicar los datos asociados a la transacción de autorización o captura en línea sobre los cuales se Venta Normal VN desea realizar la anulación y los montos requeridos para anular. autorización pueden ocurrir en el mismo instante o en forma desfasada. con esto es posible revertir el cargo en la cuenta del tarjetahabiente. Webpay permite. N Cuotas 3. Mecanismos para realizar la captura en forma diferida: Autorización y captura diferida • A través de portal de Transbank www. a partir de la fecha de la venta.0) 7 . Autorización Es la utilizada cuando la transacción es validada en línea por Transbank. La autorización se encarga de validar si es posible modalidades. Es utilizada cuando el comercio por diversas razones. Existe un tiempo máximo de 7 días para realizar esto último. 3 cuotas sin interés . ejemplo: verificación de stock.cl • Transacción de captura diferida. en modalidad autorización y captura simultanea no siendo posible La captura hace efectiva la reserva hecha previamente o cargo en separar ambos procesos. soportada a través de servicios Web. y lo comunique a Transbank. aquí lo que se hace es retener el valor de la compra del saldo de la tarjeta de crédito del cliente sin consumir definitivamente el cupo de la tarjeta de crédito hasta que el comercio confirma la compra. Los tipos de pago soportados para esta modalidad son solo los siguientes: . Ambas fases Las transacciones Webpay cuentan con 2 fases. El cargo del pago se hace simultáneamente y captura simultanea en la tarjeta de crédito o débito del cliente. 2 cuotas sin interés S2 En caso de que la transacción haya sido abonada al comercio. por separado. El comercio tiene un plazo de 30 Nº Cuotas NC días para anular transacciones. no puede realizar la transacción en tiempo real. solo son válidas para tarjetas de realizar el cargo a la cuenta asociada a la tarjeta de crédito crédito. Las transacciones crédito se pueden anular bajo el siguiente criterio: Esta operación contempla anular total o parcialmente una Producto Código Anulación Anulación Total Parcial transacción. Cuotas Normales VC Esta funcionalidad solo es válida para transacciones crédito.3 SOBRE WEBPAY 3. En el caso de compras con tarjeta de débito siempre es realizando en el mismo acto la reserva de monto de la transacción. Venta débito VD Las transacciones débito no pueden ser anuladas y en caso de REFERENCIA API SOAP WEBPAY TRANSBANK S. la anulación generará una retención en los siguientes abonos por el 3 cuotas sin interés SI monto previamente autorizado.A. Venta Normal . por medio de servicios Web. anular una transacción de crédito que fue autorizada.transbank. Esta modalidad sólo está disponible para pagos de crédito y no así para pagos con tarjetas de débito. A. garantizar la compatibilidad de su sitio Web con navegadores Web. 9700 de compra. agregando mayor seguridad y evitando desconocimientos • Blackberry 9900. Las modalidades de autenticación existentes son los • iPhone e iPod en cualquiera de sus versiones siguientes: • Android en cualquiera de sus versiones • Webpay Plus. Clientes PC: 3. Webpay utiliza el user-agent que llega vía el browser del tarjetahabiente e identifica si este corresponde El resultado de la autenticación. corresponden a los programas internacionales seguridad para garantizar una compra segura.6 Autenticación del tarjetahabiente Webpay permite autenticar al tarjetahabiente durante el proceso de Smartphone / Dispositivos móviles: pago. permite autenticar a tarjetahabientes cuyas tarjetas de crédito y débito han sido emitidas en Chile y que Es de responsabilidad del comercio realizan compras en comercios Webpay.5 Monedas soportadas • Internet Explorer 9 o superior Actualmente Webpay soporta los siguientes tipos de monedas: • Microsoft Edge • Pesos Chilenos (CLP) • Mozilla Firefox 48 o superior • Dólares norteamericanos (USD) • Chrome 52 o superior • Safari 7 o superior 3. 3. habilitado Webpay Plus o 3D Secure. por ahora. REFERENCIA API SOAP WEBPAY TRANSBANK S. el comercio debe tener obtener la respuesta de autorización original desde Transbank. Para el despliegue de crédito han sido emitidas en el extranjero.7 Compatibilidad con navegadores Web Transbank garantiza el correcto funcionamiento de Webpay bajo Las anulaciones no pueden ser aplicadas.3 SOBRE WEBPAY El comercio conoce el producto aplicado en una transacción al Para que la transacción sea autenticada. como también tomar todas las medidas necesarias de • 3D Secure. resultado de la autorización financiera de la transacción Webpay.0) 8 . es entregado junto con el a los soportados detallados anteriormente. de la capa mobile. en los siguientes dispositivos y navegadores: comercios OneClick. DOCUMENTO DE ESPECIFICACIONES (V 1. 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. Este dato debe ser almacenado por el comercio para poder aplicar la lógica de anulación parcial y/o total. REFERENCIA API SOAP WEBPAY TRANSBANK S.3 SOBRE WEBPAY 3. VENTA CUOTAS N CUOTAS Corresponde al pago de un producto o servicio en N cuotas iguales sin interés para CRÉDITO (SIN el TH. y NC INTERÉS) definido por el Comercio. Cuotas normales o cuotas fijas van de 2 hasta 48 y se les aplica el interés definido por CUOTAS cada Emisor. en general se soportan los siguientes Los tipos de pago disponibles actualmente a través de Webpay tipos de pago: dependen del tipo de tarjeta usada por el tarjetahabiente y los que Abreviación Tipo de Pago Descripción tipo de pago VENTA NORMAL Corresponde al pago de un producto o servicio en 1 cuota. Con "N" máximo 12. CUOTAS SIN Corresponde al pago de un producto o servicio en N cuotas iguales sin interés para el INTERÉS DEL TH.A. DÉBITO REDCOMPRA Pago a través de tarjeta de débito Redcompra VD Nota: Para dudas con respecto a los abonos para el comercio. dirigirse al Manual de Comercios de Webpay. DOCUMENTO DE ESPECIFICACIONES (V 1. Puede ir de 2 hasta 48 cuotas. El número de cuotas puede ir de 2 hasta "N" cuotas. 3 CUOTAS Corresponde al pago de un producto o servicio en 3 cuotas iguales sin interés para el SI SIN INTERÉS TH. Si éste se encuentra adherido a diferimiento puede ofrecer desde 1 hasta VC NORMALES 3 meses de diferido (sin impacto para el Comercio). VN 2 CUOTAS Corresponde al pago de un producto o servicio en 2 cuotas iguales sin interés para el S2 SIN INTERÉS TH.8 Tipos de pago (productos) tenga activado el comercio. El VC EMISOR Emisor escoge el rango en promoción.0) 9 . Esto es una promoción del emisor de la tarjeta. En el portal de Transbank.cl protocolos SOAP 1.1 Validación de mensajes de solicitud y respuesta funcionar la comunicación entre su comercio y Webpay.1 Comunicación DEBE velar por la seguridad de las transacciones.3. y es OBLIGACIÓN de ambas partes validar dicha firma.cl.2 Actualizaciones de plugins y SDK que solamente miembros autorizados por Transbank hagan uso Si el comercio está utilizando una solución basada en Plugins de las operaciones disponibles. las integraciones de Webpay. mientras que en el portal En el caso de las solicitudes (request) de los comercios.2 Seguridad Los servicios Web de Webpay están protegidos para garantizar 4. compatibilidad con los CMS o Shoppping Cart para su confidencialidad e integridad a los Servicios Web. Webpay servicios web para que operen con Webpay Plus. El mecanismo de seguridad o SDK. el comercio podrá encontrar información general asociado al producto Webpay.2 para la comunicación del La comunicación oficial siempre se realizará a través del sitio cliente con Webpay. cumpla Cart y los SDK con configuraciones y requisitos indicados en con los protocolos de seguridad. A su vez. mediante el certificado público de código abierto que tienen como único propósito facilitar la autofirmado que tiene cargado en sus sistemas. 4. En ambos casos. integración de comercios y proveer el entendimiento de los cuando el comercio recibe una respuesta a la solicitud. los que pueden responder a mantener TLS 1. plugins.1 y WS-Security que utilizan los Webservices de Webpay. al utilizar cualquier software distribuido Cabe recordar que Webpay posee 2 ambientes: integración/ por Transbank. Webpay de desarrolladores.3. y es obligación del comercio consumir en tiempo y forma los servicios expuestos.cl Webpay deben ir firmadas.transbankdevelopers. asume que el comercio acepta esta y otras testing y producción.cl • Mensajes requerimientos y respuestas firmados digitalmente.3 Deberes de los comercios se ha asegurado compatibilidad. modificaciones por seguridad. www. cada solicitud del comercio y cada respuesta de Portal de desarrolladores: www. Los plugins y SDK para Webpay que distribuye Transbank ya están construidos con las librerías necesarias para realizar las Transbank asegura compatibilidad del plugin validaciones requeridas.4 CONSIDERACIONES GENERALES 4 CONSIDERACIONES GENERALES 4.2 y WS-Security. porque podría dejar de 4. compatibilidad.cl no confundir el escenario en que se encuentra el comercio. bajo el La comunicación e información oficial que entrega Transbank para esquema del servicio ofertado por Transbank. • Canal seguro a través de TLS 1. los cuales proporcionan autenticación. o correcciones a las comunicaciones. transbankdevelopers. por lo que debe procurar www. pero es deber del comercio asegurarse con una(s) versión(es) específica(s) del CMS o Shopping que la solución o desarrollo de medio de pago que utilice. REFERENCIA API SOAP WEBPAY TRANSBANK S. adición de la seguridad se encuentra basada en: propiedades o funciones.0) 10 . Tenga especial cuidado si actualiza su plataforma de solución de pago a una versión que no 4. DOCUMENTO DE ESPECIFICACIONES (V 1. Con lo anterior. el certificado público que Transbank le compartió.A. por lo no puede firma dicha respuesta (response) y es deber del comercio validar utilizar ni permitir que las herramientas disponibles sean utilizadas que dicha firma efectivamente provenga de Webpay utilizando para cualquier otro propósito. por lo que dado los Portal de Transbank: www. en todas sus modalidades. los comercios podrán encontrar información valida que la firma del mensaje SOAP corresponda al comercio específica como manuales.transbank. Dado lo anterior es que. que son herramientas que consume el servicio. Webpay posee un consideraciones publicadas en certificado distinto para cada ambiente. sólo se realiza a través de los siguientes canales: Webpay expone una API. debe atento a las actualizaciones que periódicamente implementado está basado en un canal de comunicación seguro Transbank realizarán. Todo comercio que utiliza Webpay mediante Webservices.transbankdevelopers. SDK.transbankdevelopers. 2.2 y WS-Security.1.2 para la comunicación del 1. section) []: Aplicación Common Name (eg. confidencialidad e integridad a los Servicios Web. city) []:SANTIAGO Mensaje firmado con llave Organization Name (eg. ejemplo: cn = 597029124456.A. Language). dependerán del tipo de producto este y siempre debe ser custodiada por el comercio.crt El comercio debe enviar a Transbank el certificado público (597029124456. Con lo anterior. WSDL (Web Services Definition (CN) igual al código de comercio entregado por Transbank.csr privada de Webpay -signkey 597029124456.2 Generación de llave y certificado auto-firmado • Canal seguro a través de TLS 1. REFERENCIA API SOAP WEBPAY TRANSBANK S. Crear certificado autofirmado Mensaje firmado con llave openssl x509 -req -days 1460 -in 597029124456. No se requiere la llave privada de y débito. el que incluye el protocolo SOAP (Simple auto-firmado. 5 API SOAP DE WEBPAY 5 API SOAP DE WEBPAY La API SOAP de Webpay está basada en el estándar conocido El comercio debe generar un certificado digital. openssl genrsa -out 597029124456. contratado por el comercio y del emisor de la tarjeta utilizada en la compra. DOCUMENTO DE ESPECIFICACIONES (V 1.| un protocolo estándar para invocación de servicios remotos e independencia de la plataforma y el lenguaje de desarrollo. teniendo especial cuidado de usar el common name Object Access Protocol) 1. proceso de integración. your name or your server’s hostname) Servicios Cliente del []:597029124456 Webpay Comercio Email Address []: Please enter the following ‘extra’ attributes RESPUESTA to be sent with your certificate request A challenge password []: Valida firma con llave pública de Webpay An optional company name []: 3. 5.1. el cual puede ser *1 como Servicios Web*1.1. y los productos cuotas. Crear requerimiento de certificado REQUERIMIENTO openssl req -new -key 597029124456. de forma independiente para que puedan realizar la validación 5.1 Información general Los servicios Web de Webpay están protegidos para garantizar Todos los métodos.key 2048 • Mensajes requerimientos y respuestas firmados digitalmente. con el certificado de Transbank. 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 comercio implementado está basado en un canal de comunicación seguro firma con su certificado el requerimiento y valida la respuesta TLS 1.crt) y quedarse con su llave privada con la *1 Anexo D: REF 03 cual deberá transaccionar.key -out 597029124456.0) 11 .xmlsoap.org/soap/envelope/}Body). la posibilidad de permitir el pago con crédito realmente desde el comercio. Crear llave privada cliente con Webpay.1 Aspectos de Seguridad de API SOAP de la firma en la respuesta. El comercio debe enviar a Transbank el certificado digital (parte pública) que utilizará para validar que el requerimiento viene El tipo de transacción. los cuales proporcionan autenticación.key -out 597029124456. company) []: privada de comercio Organizational Unit Name (eg. de testing y de puesta en producción. En los siguientes capítulos se entrega información Transbank entregará su certificado a los comercios en el específica para cada tipo de transacción. la seguridad se encuentra basada en: 5. El mecanismo de seguridad schemas. proporcionando un alto grado de interoperabilidad.csr SSL Country Name (2 letter code) []:CL Valida firma con llave pública de comercio State or Province Name (full name) []: Locality Name (eg. y su llave privada. envío de evidencias para validar la integración. Cada una de las etapas es necesaria para que el comercio realice una correcta implementación de Webpay. de integración que provee Transbank.1. en particular respecto de la tienda de integración. de seguridad y de despliegue de información por lo que se solicitarán una serie de pruebas y su posterior requeridos por Webpay.cl o solicitándolas a Marca VISA MASTERCARD Nº de Tarjeta 4051885600446623 5186059559590568 [email protected]. consumiendo 6.1 Credenciales Mes Expiración Cualquiera Cualquiera Para comenzar el proceso de integración. necesario que realice las siguientes etapas: • Etapa de Integración Cabe destacar. por lo que no debería modificar nada. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 12 . éstos ya incorporan dichas credenciales. Para utilizar el ambiente de integración. las tienda de pruebas soporta los medios • Etapa de Validación de Integración de pago débito y crédito en transacción normal y captura • Etapa de Puesta en producción simultánea. entonces siguiente: debe utilizar las credenciales correspondientes que las puede obtener desde transbankdevelopers. La tienda de pruebas que viene por defecto con los plugins tiene el código de comercio 597020000541. VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN 6. para el en producción y no se permitirá que un comercio utilice REFERENCIA API SOAP WEBPAY TRANSBANK S. junto con todas las credenciales necesarias para realizar la conexión y el correcto En ambos casos. cumpliendo con los requerimientos el comercio transacciona de manera segura y sin problemas. 6.2 Datos de prueba para el ambiente de integración los servicios de la API Webpay. necesitará tarjetas de pruebas. en moneda pesos chilenos. y tanto para débito y crédito. o algún requerimiento e integridad transaccional. VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN 6 INTEGRACIÓN. el SDK de su preferencia.111. visite CVV 123 123 www. se tiene lo Si el comercio desea desarrollar su propia solución. el comercio utiliza un código de comercio escenarios de éxito y fracaso. las consumo de servicios. TARJETA 4051885600446620 5186059559590560 Procure cumplir con los requisitos técnicos que allí se RUT 11.transbankdevelopers.1.cl Resultado APROBADO RECHAZADO y descargue el plugin correspondiente a su Shopping Cart o Para el caso de transacciones con tarjeta de débito: CMS.111. contacte a la mesa de soporte al 800 44 11 44 o al correo 6. Para el caso de pruebas con tarjetas de crédito.6 INTEGRACIÓN. Esta validación es requisito necesario para dejar al comercio certificado público y el certificado público de Webpay. técnicos. priorizando la seguridad Cualquier duda con este aspecto. En el caso que el comercio desee utilizar los plugins o los SDK que provee Transbank.1 Etapa de integración soporte@transbank. que es el producto Webpay más utilizado en el mercado.cl La etapa de integración corresponde al proceso en que el comercio desarrolla su solución de medio de pago.1. las que se encuentran predefinidas para los En este caso. o el package con credenciales APRUEBA RECHAZA correspondientes si desea utilizar desarrollo propio.A. por lo que deben utilizarse los siguientes datos. ya vienen preinstalados.cl Año Expiración Cualquiera Cualquiera 6. es no requiere de una configuración adicional.1. por lo que Para que el comercio incorpore Webpay como medio de pago.111-1 11. transacciones son autenticadas.1 Etapas de integración de Webpay ambiente de integración.1.2 Etapa de validación de Integración Cada plugin viene de la forma ‘listo para usar’ en ambiente de Durante la validación de la integración se pretende verificar que integración / validación.111-1 especifican y seguir las instrucciones de instalación PASSWORD 123 123 detalladas para cada caso. cl Durante el paso a producción se le exigirá realizar. manteniendo ambas partes sus ambiente puede hacer pruebas con tarjetas de crédito o débito respectivas llaves privadas. permitiéndole al 6.cl o contacte a su ejecutivo comercial. De no comercios tiene una fecha de caducidad. Una vez que soporte le comunique formalmente que la distintos códigos de comercios. realizan para habilitar la solución de medio de pago en producción. validación y paso a producción. en éste ambiente es que se valida la certificado público productivo del comercio. Como Webpay utiliza WS_Security. los certificados finalmente operará productivamente el comercio. deberá seguir los pasos que le indican distintos certificados. Estos pasos incluyen cambio en el ambiente sobre el que transacciones. Soporte validará que los casos de prueba sean consistentes con los registrados en los sistemas de Webpay y. En este públicos productivos. las órdenes de compra. una transacción de prueba. www. 6. privada y su certificado público. con la que finalizará oficialmente la mediante el formulario correspondiente. comercio y Transbank. indicando claramente puesta en producción.0) 13 . consideren los puntos anteriores. De esta manera. es que ambas reales. es que es en esta etapa 2) Ambiente de producción: Este ambiente es en el cual en que se intercambian. Las credenciales de este ambiente son entregadas al partes firman sus comunicaciones y la contraparte validará las momento que se coordina el paso a producción. pasando de integración a producción. Asimismo. ver anexo “Creación de llaves y ambiente de integración” En esta etapa.1. además Por otro lado. siga las instrucciones en cómo hacerse asimismo el cambio en el certificado público de transbank del cliente en el portal ambiente productivo.3 Etapa de puesta en producción Corresponde a las actividades técnico-administrativas en que ambas partes.transbank. firmas con los certificados ya intercambiados. Cada uno de estos ambientes maneja distintas URLs (endpoints). que incluyen 1) Ambiente de Integración y Validación: En este ambiente el cambio a endpoints productivos. integración del comercio. REFERENCIA API SOAP WEBPAY TRANSBANK S. entre otros. el comercio envía las evidencias a soporte@transbank. Para dudas sobre las llaves y certificados. distintas tarjetas de prueba y integración está aprobada.6 INTEGRACIÓN. Transbank pone a disposición 2 ambientes: Una vez que la validación de integración es aprobada. Transbank no validará ninguna integración a de las instrucciones de creación de llave privada productiva y algún comercio que no posea código de comercio productivo. de estar todo Es responsabilidad del comercio considerar correcto. DOCUMENTO DE ESPECIFICACIONES (V 1. se le hará alcances al comercio el certificado que el comercio genera y que comparte con respecto de su integración. VALIDACIÓN DE INTEGRACIÓN Y PASO A PRODUCCIÓN productivamente el servicio Webpay sin poseer una validación. Para el proceso de integración. certificado público productivo comercio realiza la integración a Webpay y testea su solución de Webpay e instrucciones para la creación de llave privada y de medio pago. por lo que es importante tener la claridad para pasar a producción y poder comenzar a transaccionar de que. como asimismo es responsable por reemplazar estos cuando caduquen. se manera real. se le notificará al comercio la conformidad para pasar que el certificado público que Transbank comparte con los a producción. al menos. recibiendo las instrucciones para ello. como asimismo estar consistentes las pruebas. comercio y Transbank. certificado público autofirmado asociado a dicha llave.A. como Para obtenerlo. para que realice las correcciones Transbank para realizar las transacciones sobre Webpay. el comercio recibirá instrucciones desde soporte. correspondientes y vuelva a enviar las evidencias una vez El comercio es responsable por resguardar su llave terminadas dichas correcciones.2 Ambientes comercio operar con Webpay y toda su gama de tarjetas. al realizar el cambio de ambiente un ambiente a otro. fecha y hora de las transacciones. posterior a esto el token es caducado y no podrá ser utilizado en un pago. y el Sitio del Webpay Autenticación Sitio del Webpay Sitio del Comercio Formulario en Banco Comercio Comprobante Comercio de Pago Emisor de pago Resumen de los métodos del servicio Web de Transacción Normal MÉTODO DESCRIPCIÓN GENERAL Permite inicializar una transacción en Webpay. selecciona productos o servicio. Webpay reversará la transacción. Indica a Webpay que se ha recibido conforme el resultado de la transacción. evitando así el cobro al tarjetahabiente. corresponde a una solicitud de autorización financiera de un pago con tarjetas de crédito o débito. getTransactionResult Permite obtener el resultado de la transacción una vez que Webpay ha resuelto su autorización financiera. DOCUMENTO DE ESPECIFICACIONES (V 1. REFERENCIA API SOAP WEBPAY TRANSBANK S. El método acknowledgeTransaction debe ser invocado siempre. asumiendo que el comercio no pudo informar de su resultado. en donde quién realiza el pago El flujo de páginas para la transacción es el siguiente: ingresa al sitio del comercio.7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7. el token que es entregado tiene un periodo reducido de vida de 5 minutos. Si la invocación no se realiza en un período de 30 segundos. initTransaction Es importante considerar que una vez invocado este método. realiza en forma segura en Webpay.A.1 Descripción de la Transacción de Autorización Normal ingreso asociado a los datos de la tarjeta de crédito o débito lo Una transacción de autorización normal (o transacción normal).0) 14 . independientemente del resultado acknowledgeTransaction entregado por el método getTransactionResult. Como respuesta a la invocación se genera un token que representa en forma única una transacción. .2..) 5 Request(token) 6 Formulario Webpay() 7 Pagar() 8 Autoriza() 9 Redirect() 10 Request(token) 11 getTransactionResult(token.. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 15 ..7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7. urfFormOfPayment 4 Redirect(token.A.2 Secuencia de pago en una transacción normal 7. sd Secuencia Flujo Webpay Transacción Normal TARJETAHABIENTE COMERCIO WEBPAY WS 1 Pagar con Webpay() 2 initTransaction() 3 Response() :token.1 Diagrama El siguiente diagrama ilustra la secuencia de pago y cómo participan los distintos actores en una transacción normal.) 12 Response() 13 acknowledge Transaction(token) 14 Redirection(token) 15 Request(token) 16 Comprobante Webpay() 17 Request(token) 18 Pagina final() Ilustración 1: Diagrama de secuencia de Transacción Normal REFERENCIA API SOAP WEBPAY TRANSBANK S. La redirección se realiza enviando por método POST el token en De no ser consumido o demorar más de 30 variable token_ws. Una vez seleccionado los bienes o servicios. En este caso el método retorna una HTTPS a Webpay.2 Descripción de la secuencia autorización sea persistida en los sistemas del comercio. el a Webpay su correcta recepción. Webpay recibe un requerimiento con la variable token_ws al comercio. Para que el comercio informe a Webpay que el 3. 12. 13. Comercio redirecciona al tarjetahabiente hacia Webpay. realizando un redireccionamiento HTTP/HTTPS hacia la página de transición del comercio. con la y logotipo.0) 16 . en base al redireccionamiento generado Excepción indicando la situación. Si esto fue ejecutado tarjetahabiente. tarjetahabiente este método se puede invocar una única vez por transacción.A. El comercio debe implementar la recepción de esta variable. segundos en su consumo. método initTransaction(…). 9. 7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7. getTransactionResult () (mientras *2 se despliega la página de transición*2). 4. DOCUMENTO DE ESPECIFICACIONES (V 1. de pago al tarjetahabiente. por medio de redireccionamiento generada por Webpay en el punto 9. el sitio del comercio debe monto de la transacción. su tarjeta bancaria. hace clic en el proceso de pago fue exitoso. Webpay procesa la solicitud de autorización (primero getTransactionResult() enviando por método POST el autenticación bancaria y luego la autorización de la transacción). Tarjetahabiente ingresa los datos de la tarjeta. REFERENCIA API SOAP WEBPAY TRANSBANK S. token de la transacción en la variable token_ws. Webpay retorna el control 15. en base a la redirección vuelta al sitio del comercio. Comercio recibe el resultado de la invocación del método 2. Una vez resuelta la autorización. El comercio inicia una transacción en Webpay. en donde se envía por 16. *3 de la autorización. las opciones de pago a través de crédito o débito. finalidad de desplegar el comprobante de pago. sin interferir el comercio. Esta excepción debe por el comercio en el punto 4. ya que 1. 17. información del comercio como nombre redirigir al tarjetahabiente nuevamente a Webpay. con el token de la transacción a la URL indicada en punto 3. Se recomienda que el resultado de la *2 El detalle de la página de transición se encuentra descrito en Anexo A. *3 El detalle de la página de final se encuentra descrito en Anexo A. decide pagar a través de Webpay.1. 6. con el token en la variable token_ws enviada por método POST hacia la página final informada por el comercio en el 11. resultado de la operación el token de la transacción y el sistema del comercio debe consumir el tercer método URL de redireccionamiento a la cual se deberá redirigir al acknowledgeTransaction(). 12. del documento de descripción general de la API SOAP. El sitio del comercio recibe la variable token_ws e invoca el método initTransaction. entre otras cosas. El navegador Web del tarjetahabiente realiza una petición de comunicación. segundo método Web. Webpay responde al requerimiento desplegando el formulario de pago de Webpay. Webpay identifica la transacción y despliega el comprobante método POST el token de la transacción en la variable token_ws. invocando el getTransactionResult(). Webpay realizará la reversa de la transacción. ser manejada para no entregar el producto o servicio en caso que ocurra. Una vez visualizado el comprobante de pago por un 10. Es importante realizar este punto para que el tarjetahabiente entienda que 7. correctamente el producto puede ser liberado al cliente. y que involucrará un cargo a pagar en formulario Webpay.2. Sitio del comercio despliega página final de pago*3. Desde este punto la comunicación es entre Webpay y el tarjetahabiente. Webpay procesa el requerimiento y entrega como resultado de la transacción se ha recibido sin problemas. para obtener el resultado 18. El navegador Web del tarjetahabiente realiza una petición periodo acotado de tiempo. Una vez recibido el resultado de la transacción e informado formulario de pago de Webpay despliega. El 14. el tarjetahabiente es redirigido de HTTP/HTTPS al sitio del comercio. asumiendo que existieron problemas 5.2 del documento de descripción general de la API SOAP. El redirecionamiento a Webpay se hace utilizando como destino la URL informada por el método 8. 0) 17 . Ilustración 2: Botón anular formulario de pago en Webpay sd Secuencia Flujo Webpay Transacción Anulada TARJETAHABIENTE COMERCIO WEBPAY WS 1 Pagar con Webpay() 2 initTransaction() 3 Response() :token..3.A.7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7.1 Diagrama El siguiente diagrama ilustra la secuencia de una transacción normal donde el TH anula la transacción en el formulario de pago de Webpay y cómo participan los distintos actores en esta situación. urfFormOfPayment 4 Redirect(token.3 Flujo Alternativo: Secuencia de pago en una transacción normal anulada en formulario de pago 7..) 5 Request(token) 6 Formulario Webpay() 7 Anular() 8 Redirect() 9 Request(token) 10 Pagina final() Ilustración 3: Diagrama de secuencia de pago en una transacción normal anulada en formulario de pago REFERENCIA API SOAP WEBPAY TRANSBANK S. DOCUMENTO DE ESPECIFICACIONES (V 1. del documento de descripción general de la API SOAP.4. REFERENCIA API SOAP WEBPAY TRANSBANK S.A. invocar el participan los distintos actores en una transacción normal con segundo método Web. realizando un 7. *4 se despliega la página de transición*4). según anexo glosa transacción no autorizada.) 5 Request(token) 6 Formulario Webpay() 7 Timeout() 8 Error() : Página de error Ilustración 4: Diagrama de secuencia de timeout en transacción normal *4 El detalle de la página de transición se encuentra descrito en Anexo A. 10.. El comercio debe informar al tarjeta habiente que su pago 7.2 Descripción secuencia de pago para transacción anulada resultado de la autorización.. Pasos de 1 a 6 son idénticos a la secuencia normal. en formulario Webpay. El comercio con la variable TBK_TOKEN debe.1. 12. pues el pago fue abortado. urfFormOfPayment 4 Redirect(token. Tarjetahabiente hace clic en “anular”.3. DOCUMENTO DE ESPECIFICACIONES (V 1. para obtener el sd Secuencia Flujo Webpay Webservice Transacción TARJETAHABIENTE COMERCIO WEBPAY WS 1 Pagar con Webpay() 2 initTransaction() 3 Response() :token.4 Flujo Alternativo: Secuencia de pago en una transacción redireccionamiento HTTP/HTTPS hacia la página de final del normal con evento de timeout comercio. En este caso debe obtener una en formulario de pago: excepción.1.1 Diagrama El siguiente diagrama ilustra la secuencia de pago y cómo 9. getTransactionResult () (mientras evento de timeout. Webpay retorna el control al comercio. en donde se envía por método POST el token de la transacción en la variable TBK_TOKEN. 8. 7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7. no se completó.0) 18 . 1. 7. Webpay genera un error de timeout. pero no A continuación se describen cada uno de las operaciones que presiona pagar durante 10 minutos. su valor debe ser siempre TR_NORMAL_WS xs:string sessionId (Opcional) Identificador de sesión.5. DOCUMENTO DE ESPECIFICACIONES (V 1. Se regresa automáticamente al comercio. REFERENCIA API SOAP WEBPAY TRANSBANK S. el cual contiene datos de la transacción. Tarjetahabiente se encuentra en formulario Webpay. de Autorización Normal 7.5. *5 indicando que ocurrió un error*5.2 Descripción de secuencia alternativa. *5 El detalle de la página de transición se encuentra descrito en Anexo A. Máxima transactionDetails cantidad de repeticiones es de 1 para este tipo de transacción.0) 19 . tns:wPMDetail wPMDetail (No se utiliza para Transacción Normal) Este campo contiene la transacción webpay mensual. wsTransactionDetail está descrito más adelante. a la cual Webpay redireccionará posterior al proceso de autorización Largo máximo: 256 xs:anyURI finalURL (Obligatorio) URL del comercio a la cual Webpay redireccionará posterior al voucher de éxito de Webpay. timeout: 7. Largo máximo: 61 xs:anyURI returnURL (Obligatorio) URL del comercio. 7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7. Pasos de 1 a 6 son idénticos a la secuencia normal. este valor es devuelto al final de la transacción.1. Largo máximo 256 tns:wsTransactionDetail (Obligatorio) Lista de objetos del tipo wsTransactionDetail. Esto causa un timeout en deben ser utilizadas en una Transacción Normal. Es obligatorio para commerceId transacción MALL.5 Descripción de métodos del Servicio Web de Transacción 1. xs:string (Opcional)Es el código único de identificación del comercio entregado por Transbank. 12. dicho formulario. Es obligatorio para transacción MALL. del documento de descripción general de la API SOAP.4. 7.A.1.1 Parámetro de entrada NOMBRE DESCRIPCIÓN tns:wsTransactionType WSTransactionType Indica el tipo de transacción. uso interno de comercio. 7. Largo: 12 xs:string buyOrder (Opcional) Es el código único de la orden de compra generada por el comercio.1. se presenta una pantalla Método que permite iniciar una transacción de pago Webpay.1 Operación initTransaction 8. DOCUMENTO DE ESPECIFICACIONES (V 1.5.1 Parámetros de entrada token Token de la transacción.7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL TYPE WSTRANSACTIONDETAIL Descripción: Tipo de dato contiene detalles de la transacción CAMPO DESCRIPCIÓN xs:decimal amount Monto de la transacción. Máximo 2 decimales para USD.5.2 Operación getTransactionResult Método que permite obtener el resultado de la transacción y CAMPO DESCRIPCIÓN los datos de la misma.5.2 Parámetros de salida:TypewsInitTransactionOutput 7. Largo máximo: 256 Largo: 64 *6 Debe cumplir con caracteres permitidos.~:/?[+!@()>- xs:string commerceCode Código comercio de la tienda entregado por Transbank.0) 20 . Largo: 12 sharesAmount Campo no utilizado sharesNumber Campo no utilizado 7. letras.1. mayúsculas y minúsculas. REFERENCIA API SOAP WEBPAY TRANSBANK S.A.2. y los signos |_=&%.*6 buyOrder Largo máximo: 26 La orden de compra puede tener: Números. Largo máximo: 10 xs:string Orden de compra de la tienda. Largo: 64 CAMPO DESCRIPCIÓN xs:string xs:string url URL de formulario de pago Webpay tokenInput Token de la transacción.. xs:string 7. formato MMDD xs:string transactionDate Fecha y hora de la autorización. REFERENCIA API SOAP WEBPAY TRANSBANK S. Formato YYMM cardExpirationDate Solo para comercios autorizados por Transbank. Largo máximo: 256 tns:wsTransactionDetailOutput detailsOutput detailsOutput Objeto que contiene el detalle de la transacción financiera. uso interno de comercio. Largo máximo: 4 *7 VCI=TO indica que se produjo un time-out en el proceso de autenticación bancaria. cardDetails descrito más adelante. • U3 : Error interno en la autenticación. VCI • TO*7 : Tiempo máximo excedido para autenticación. Esta transacción no será autorizada y seguirá el flujo normal de eventos. Largo máximo: 26 xs:string sessionId Identificador de sesión. Largo máximo: 16 xs:string (Opcional) Fecha de expiración de la tarjeta de crédito del tarjetahabiente.5.0) 21 . Largo máximo: 61 Tns:carddetails cardDetails Objeto que representa los datos de la tarjeta de crédito del tarjeta habiente. cardNumber Solo para comercios autorizados por Transbank se envía el número completo. Largo máximo: 3 xs:string urlRedirection URL de redirección para visualización de voucher.2 Parámetros de salida: TypeTransactionResultOutput CAMPO DESCRIPCIÓN xs:string buyOrder Orden de compra de la tienda. Largo: 6. los valores posibles son los siguientes: • TSY : Autenticación exitosa • TSN : Autenticación fallida. Descrito más adelante TYPECARDDETAIL Descripción: Tipo de dato contiene detalles de la tarjeta de crédito.A. este valor es devuelto al final de la transacción. • Puede ser vacío si la transacción no se autenticó. CAMPO DESCRIPCIÓN xs:string 4 últimos números de la tarjeta de crédito del tarjeta habiente.7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL 7. DOCUMENTO DE ESPECIFICACIONES (V 1. xs:string accoutingDate Fecha de la autorización. formato: MMDDHHmm xs:string Resultado de la autenticación para comercios Webpay Plus y/o 3D Secure. • ABO : Autenticación abortada por tarjetahabiente.2. Largo: 4. 5.0) 22 .5. CAMPO DESCRIPCIÓN xs:string authorizationCode Código de autorización de la transacción Largo máximo: 6 xs:string Tipo de pago de la transacción. Timeout error (Transactions REVERSED) con código 277.7 TRANSACCIÓN DE AUTORIZACIÓN NORMAL TYPEWSTRANSACTIONDETAILOUTPUT Descripción: Tipo de dato contiene el detalle del resultado de la transacción. Largo máximo: 26 7. En caso de llamar al método acknowledgeTransaction 7. Largo: 64 REFERENCIA API SOAP WEBPAY TRANSBANK S. Valores posibles: 0 Transacción aprobada -1 Rechazo de transacción -2 Transacción debe reintentarse responseCode -3 Error en transacción -4 Rechazo de transacción -5 Rechazo por error de tasa -6 Excede cupo máximo mensual -7 Excede límite diario por transacción -8 Rubro no autorizado xs:decimal Amount Monto de la transacción Largo máximo: 10 xs:int sharesNumber Cantidad de cuotas Largo máximo: 2 xs:string commerceCode Código comercio de la tienda Largo: 12 xs:string buyOrder Orden de compra de la tienda. DOCUMENTO DE ESPECIFICACIONES (V 1.A.1 Parámetros de entrada: acknowledgeTransaction después de 30 segundos de ocurrida la autorización. ya que la transacción ha sido reversada por Webpay: xs:string token Token de la transacción. se informará la excepción descrita más abajo y el comercio no debe entregar CAMPO DESCRIPCIÓN producto o servicio.3.3 Operación acknowledgeTransaction Método que permite informar a Webpay la correcta recepción del resultado de la transacción. VD = Venta Débito VN = Venta Normal paymentTypeCode VC = Venta en cuotas SI = 3 cuotas sin interés S2 = 2 cuotas sin interés NC = N Cuotas sin interés xs:string Código de respuesta de la autorización. posterior a esto el token es caducado y no podrá ser utilizado en un pago. el token que es entregado tiene un periodo reducido de vida de 5 minutos. en donde quién realiza el pago ingresa al sitio del comercio. Cada pago tendrá su propio resultado. El método acknowledgeTransaction debe ser invocado siempre. Tanto el mall como las tiendas N asociadas son identificadas a través de un número denominado código de comercio. Indica a Webpay que se ha recibido conforme el resultado de la transacción. REFERENCIA API SOAP WEBPAY TRANSBANK S. initTransaction Es importante considerar que una vez invocado este método.000 1 autorización financiera de un conjunto de pagos con tarjetas de crédito o débito. Webpay reversará la transacción. autorizado o rechazado. Como respuesta a la invocación se genera un token que representa en forma única una transacción.000 que pueden generar transacciones. El flujo de páginas para la transacción es el siguiente: Sitio del Webpay Autenticación Sitio del Webpay Sitio del Comercio Formulario en Banco Comercio Comprobante Comercio de Pago Emisor de pago Resumen de los métodos del servicio Web de Transacción Mall Normal MÉTODO DESCRIPCIÓN GENERAL Permite inicializar una transacción en Webpay. Tienda El Mall Webpay agrupa múltiples tiendas.A. son estas últimas las Pago virtual $3. DOCUMENTO DE ESPECIFICACIONES (V 1. asumiendo que el comercio no pudo informarse de su resultado. evitando así el cobro al tarjetahabiente.1 Descripción de la Transacción de Autorización Mall Normal Tienda Pago virtual Una transacción Mall Normal corresponde a una solicitud de $1. selecciona productos o servicios. Si la invocación no se realiza en un período de 30segundos. y el ingreso asociado Tienda Tienda Pago a los datos de la tarjeta de crédito o débito lo realiza una única vez virtual mall $2. independientemente del resultado acknowledgeTransaction entregado por el método getTransactionResult.8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8. getTransactionResult Permite obtener el resultado de la transacción una vez Webpay ha resuelto su autorización financiera.000 2 en forma segura en Webpay para el conjunto de pagos.0) 23 . urfFormOfPayment 4 Redirect(token.8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8.) 5 Request(token) 6 Formulario Webpay() 7 Pagar() 8 Autoriza() 9 Redirect() 10 Request(token) 11 getTransactionResult(token...A.1 Diagrama El siguiente diagrama ilustra la secuencia de pago y cómo participan los distintos actores en una transacción Mall Normal. DOCUMENTO DE ESPECIFICACIONES (V 1.) 12 Response() 13 acknowledge Transaction(token) 14 Redirection(token) 15 Request(token) 16 Comprobante Webpay() 17 Request(token) 18 Pagina final() Ilustración 5: Diagrama de secuencia de Transacción Mall Normal REFERENCIA API SOAP WEBPAY TRANSBANK S.2. sd Secuencia Flujo Webpay Transacción Mall Normal TARJETAHABIENTE COMERCIO WEBPAY WS 1 Pagar con Webpay() 2 initTransaction() 3 Response() :token.2 Secuencia de pago en una transacción de autorización Mall Normal 8..0) 24 .. El redirecionamiento a Webpay se hace como nombre y logotipo. en donde se envía tarjetahabiente es redirigido de vuelta al sitio del comercio. con la el formulario de pago de Webpay. 26. Una vez visualizado el comprobante de pago. se ha recibido sin problemas. *9 generada por Webpay en el punto 9. Es importante comunicación es entre Webpay y el tarjetahabiente. 32. 28.0) 25 . La el tercer método acknowledgeTransaction(). hacia la página final informada por el comercio en el método initTransaction(). y que involucrará un cargo a otras cosas. invocando de la autorización sea persistida en los sistemas del comercio. el HTTP/HTTPS hacia el sitio del comercio. 21. Comercio redirecciona al tarjetahabiente hacia Webpay. 34. 33. realizando un redireccionamiento 35. getTransactionResult() enviando por método POST el token de la transacción en la variable token_ws. 23. Webpay retorna el control al comercio. entre el proceso de pago fue exitoso. para obtener el *8 resultado de la autorización. DOCUMENTO DE ESPECIFICACIONES (V 1. Webpay procesa la solicitud de autorización para cada uno de los pagos de las tiendas. 27.nombre y monto por cada tienda. Una vez seleccionado los bienes o servicios. 31. token_ws enviada por método POS. Webpay recibe un requerimiento con el token en la variable token_ws valida que la transacción se encuentre aprobada. NOTA: De no ser consumido ó demorar más de 30 segundos en su consumo. El comercio inicia una transacción en Webpay. Sitio del comercio despliega página final de pago*9. Tarjetahabiente ingresa los datos de la tarjeta.2. HTTPS a Webpay. Para informar a Webpay que el resultado de la transacción 22. en base a la redirección 36. getTransactionResult () (mientras decide pagar a través de Webpay.2 Descripción de la secuencia 29. en base al redireccionamiento generado por el comercio en el punto 4. Se recomienda que el resultado 20. el sitio del comercio debe 24. Desde este punto la finalidad de desplegar el comprobante de pago. por método POST el token de la transacción en la variable por medio de redireccionamiento con el token en la variable token_ws. Webpay realizará la reversa de la transacción. Webpay responde el resultado de la invocación del método URL de redireccionamiento a la cual se deberá redirigir al getTransactionResult(). El navegador Web del tarjetahabiente realiza una petición asumiendo que existieron problemas de comunicación. 25. El formulario de pago de Webpay despliega. hace clic en pagar en formulario Webpay. tarjetahabiente segundo método Web. redirección se realiza enviando por método POST el token en variable token_ws. ya que este método se puede invocar una única vez por transacción. Webpay procesa el requerimiento y entrega como resultado de la operación el token de la transacción y 30. el sistema del comercio consume con el token de la transacción a la URL indicada en punto 3.8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8. el monto de la transacción. el método initTransaction(…). REFERENCIA API SOAP WEBPAY TRANSBANK S. las utilizando como destino la URL informada por el método opciones de pago a través de crédito o débito. El navegador Web del tarjetahabiente realiza una petición HTTP/HTTPS al sitio del comercio.A. El sitio del comercio recibe la variable token_ws e invoca el 19. información del mall su tarjeta bancaria. se despliega la página de transición*8). *8 El detalle de la página de transición se encuentra descrito en *9 Anexo A. sin interferir realizar este punto para que el tarjetahabiente entienda que el comercio. tarjetahabiente. Webpay identifica la transacción y despliega el comprobante de pago al tarjetahabiente. Webpay responde al requerimiento desplegando redirigir al tarjetahabiente nuevamente a Webpay. del documento de descripción general de la API SOAP. Una vez recibido el resultado de la transacción e informado a Webpay su correcta recepción. Una vez resuelta la autorización de cada pago. Ilustración 6..0) 26 . urfFormOfPayment 4 Redirect(token.8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8. DOCUMENTO DE ESPECIFICACIONES (V 1..A.3 Flujo Alternativo: Secuencia de pago en una transacción mall normal anulada en formulario de pago El siguiente diagrama ilustra la secuencia de una transacción normal donde el TH anula la transacción en el formulario de pago de Webpay y cómo participan los distintos actores en esta situación.) 5 Request(token) 6 Formulario Webpay() 7 Anular() 8 Redirect() 9 Request(token) 10 Pagina final() Ilustración 7: Diagrama de secuencia de pago en una transacción mall normal anulada en formulario de pago REFERENCIA API SOAP WEBPAY TRANSBANK S. Botón anular formulario de pago en Webpay sd Secuencia Flujo Webpay Transacción Anulada TARJETAHABIENTE COMERCIO WEBPAY WS 1 Pagar con Webpay() 2 initTransaction() 3 Response() :token. El comercio debe informar al tarjeta habiente que su pago 12. mall normal con evento de timeout 13. anular: despliega la página de transición*10).8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8. Tarjetahabiente hace clic en “anular”. en formulario Webpay.. 12. del documento de descripción general de la API SOAP.. según anexo glosa transacción no autorizada. Webpay retorna el control al comercio.4. en donde se envía por método POST el token de la 8. REFERENCIA API SOAP WEBPAY TRANSBANK S. DOCUMENTO DE ESPECIFICACIONES (V 1. 14. pues el pago fue abortado. redireccionamiento HTTP/HTTPS hacia la página de final del comercio.1 Descripción de secuencia alternativa.1. realizando un no se completó.A. getTransactionResult()(mientras se sd Secuencia Flujo Webpay Webservice Transacción TARJETAHABIENTE COMERCIO WEBPAY WS 1 Pagar con Webpay() 2 initTransaction() 3 Response() :token.4 Flujo Alternativo: Secuencia de pago en una transacción transacción en la variable TBK_TOKEN.3. urfFormOfPayment 4 Redirect(token.0) 27 . para obtener el resultado *10 2.1.) 5 Request(token) 6 Formulario Webpay() 7 Timeout() 8 Error() : Página de error Ilustración 8: Diagrama de secuencia de Transacción con Timeout en Formulario *10 El detalle de la página de transición se encuentra descrito en Anexo A. 11. Pasos de 1 a 6 son idénticos a la secuencia normal. invocar 8. El comercio con la variable TBK_TOKEN debe.1 Diagrama el segundo método Web. En este caso debe obtener una excepción. de la autorización. Largo máximo 256 tns:wsTransactionDetail (Obligatorio) Lista de objetos del tipo wsTransactionDetail.5. formulario. pantalla indicando que ocurrió un error. REFERENCIA API SOAP WEBPAY TRANSBANK S. este valor es devuelto al final de la transacción. Pasos de 1 a 6 son idénticos a la secuencia normal. commerceId En este caso el commerceID corresponde al código asignado al PST (o código mall).0) 28 . su valor debe ser siempre TR_NORMAL_WS xs:string sessionId (Opcional) Identificador de sesión. DOCUMENTO DE ESPECIFICACIONES (V 1. tns:wPMDetail wPMDetail (No se utiliza para Transacción Normal) Este campo contiene la transacción webpay mensual.8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8. uso interno de comercio. No se regresa automáticamente al comercio. el cual contiene datos de la transacción. Máxima transactionDetails cantidad de repeticiones es de 1 para este tipo de transacción. se describen cada uno de las operaciones que pagar durante 10 minutos. xs:string (Obligatorio)Es el código único de identificación del comercio entregado por Transbank. wsTransactionDetail está descrito más adelante. Largo máximo: 256 xs:anyURI finalURL (Obligatorio) URL del comercio a la cual Webpayredireccionará posterior al voucher de éxito de Webpay. Esto causa un timeout en dicho deben ser utilizadas en una Transacción Mall Normal. Largo: 12 xs:string buyOrder (Obligatorio)Es el código único de la orden de compra generada por el comercio mall.1.1 Parámetro de entrada NOMBRE DESCRIPCIÓN tns:wsTransactionType WSTransactionType Indica el tipo de transacción. timeout: 8.2 Descripción de secuencia alternativa. Webpay genera un error de timeout.5. se presenta una Método que permite iniciar una transacción de pago Webpay.4. Largo máximo: 61 xs:anyURI returnURL (Obligatorio) URL del comercio.1 Operación initTransaction 10. a la cual Webpayredireccionará posterior al proceso de autorización. 8.5 Descripción de métodos del Servicio Web de Transacción 2. de Autorización Mall Normal 9. Tarjetahabiente está en formulario Webpay. y que agrupa los códigos de comercio que recibirán los pagos. 8.A. pero no presiona A continuación. .2 Operación getTransactionResult Método que permite obtener el resultado de la transacción y CAMPO DESCRIPCIÓN los datos de la misma. Máximo 2 decimales para USD. Largo: 12 sharesAmount Campo no utilizado sharesNumber Campo no utilizado 8.*11 buyOrder Largo máximo: 26 La orden de compra puede tener: Números.5.5. y los signos |_=&%.A. letras.1. Largo máximo: 10 xs:string Orden de compra de la tienda. DOCUMENTO DE ESPECIFICACIONES (V 1.2 Parámetros de salida:TypewsInitTransactionOutput 8.0) 29 . xs:string 8. mayúsculas y minúsculas.2.1 Parámetros de entrada token Token de la transacción. Largo máximo: 256 Largo: 64 *11 Debe cumplir con el formato de caracteres permitidos REFERENCIA API SOAP WEBPAY TRANSBANK S.~:/?[+!@()>- xs:string commerceCode Código comercio de la tienda entregado por Transbank.8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL TYPE WSTRANSACTIONDETAIL Descripción: Tipo de dato contiene detalles de la transacción CAMPO DESCRIPCIÓN xs:decimal amount Monto de la transacción.5. Largo: 64 CAMPO DESCRIPCIÓN xs:string xs:string url URL de formulario de pago Webpay tokenInput Token de la transacción. cardDetails descrito más adelante. uso interno de comercio. Descrito más adelante TYPECARDDETAIL Descripción: Tipo de dato contiene detalles de la tarjeta de crédito. Largo máximo: 16 xs:string (Opcional) Fecha de expiración de la tarjeta de crédito del tarjetahabiente. VCI • TO*12 : Tiempo máximo excedido para autenticación. • ABO : Autenticación abortada por tarjetahabiente. Largo máximo: 3 xs:string urlRedirection URL de redirección para visualización de voucher. REFERENCIA API SOAP WEBPAY TRANSBANK S.A. • U3 : Error interno en la autenticación.2 Parámetros de salida: TypeTransactionResultOutput CAMPO DESCRIPCIÓN xs:string buyOrder Orden de compra del mall. Largo: 4.2. Largo máximo: 61 Tns:carddetails cardDetails Objeto que representa los datos de la tarjeta de crédito del tarjetahabiente.5. cardNumber Solo para comercios autorizados por Transbank se envía el número completo. Largo: 6. La fecha de expiración llegara nula. este valor es devuelto al final de la transacción. los valores posibles son los siguientes: • TSY : Autenticación exitosa • TSN : Autenticación fallida. Largo máximo: 26 xs:string sessionId Identificador de sesión. Esta transacción no será autorizada y seguirá el flujo normal de eventos. xs:string accoutingDate Fecha de la autorización. DOCUMENTO DE ESPECIFICACIONES (V 1. • Puede ser vacío si la transacción no se autenticó. formato MMDD xs:string transactionDate Fecha y hora de la autorización. Formato YYMM cardExpirationDate Solo para comercios autorizados por Transbank. Largo máximo: 256 tns:wsTransactionDetailOutput detailsOutput detailsOutput Objeto que contiene el detalle de la transacción financiera. formato: MMDDHHmm xs:string Resultado de la autenticación para comercios Webpay Plus y/o 3D Secure. Largo máximo: 4 *12 VCI=TO indica que se produjo un time-out en el proceso de autenticación bancaria.0) 30 .8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL 8. CAMPO DESCRIPCIÓN xs:string 4 últimos números de la tarjeta de crédito del tarjeta habiente. se informará la excepción descrita más abajo y el comercio no debe entregar CAMPO DESCRIPCIÓN producto o servicio.0) 31 . VD = Venta Débito VN = Venta Normal paymentTypeCode VC = Venta en cuotas SI = 3 cuotas sin interés S2 = 2 cuotas sin interés NC = N Cuotas sin interés xs:string Código de respuesta de la autorización.1 Parámetros de entrada: acknowledgeTransaction después de 30 segundos de ocurrida la autorización.8 TRANSACCIÓN DE AUTORIZACIÓN MALL NORMAL TYPEWSTRANSACTIONDETAILOUTPUT Descripción: Tipo de dato contiene el detalle del resultado de la transacción. Valores posibles: 0 Transacción aprobada -1 Rechazo de transacción -2 Transacción debe reintentarse responseCode -3 Error en transacción -4 Rechazo de transacción -5 Rechazo por error de tasa -6 Excede cupo máximo mensual -7 Excede límite diario por transacción -8 Rubro no autorizado xs:decimal Amount Monto de la transacción Largo máximo: 10 xs:int sharesNumber Cantidad de cuotas Largo máximo: 2 xs:string commerceCode Código comercio de la tienda Largo: 12 xs:string buyOrder Orden de compra del mall.3. Timeout error (Transactions REVERSED) con código 277.A.5. DOCUMENTO DE ESPECIFICACIONES (V 1. Largo: 64 REFERENCIA API SOAP WEBPAY TRANSBANK S. ya que la transacción ha sido reversada por Webpay: xs:string token Token de la transacción. En caso de llamar al método acknowledgeTransaction 8.3 Operación acknowledgeTransaction Método que permite informar a Webpay la correcta recepción del resultado de la transacción. Largo máximo: 26 8.5. CAMPO DESCRIPCIÓN xs:string authorizationCode Código de autorización de la transacción Largo máximo: 6 xs:string Tipo de pago de la transacción. DOCUMENTO DE ESPECIFICACIONES (V 1.3 Inscripción en Oneclick • El comercio envía el browser del cliente a la URL obtenida y 9. Este tipo de pago facilita la venta.2 Resumen de los métodos del servicio Web tiempo de la transacción y reduce los riesgos de ingreso erróneo de los datos del medio de pago. El modelo de pago contempla un proceso previo de inscripción o así como para la realización de los pagos. REFERENCIA API SOAP WEBPAY TRANSBANK S. la cual no se captura (no se verá reflejada en su estado de cuenta).1 Descripción de la Transacción de OneClick La modalidad de pago OneClick permite al tarjetahabiente realizar El proceso de integración con Webpay OneClick consiste en pagos en el comercio sin la necesidad de ingresar cada vez desarrollar por parte del comercio las llamadas a los servicios web información de la tarjeta de crédito al momento de realizar la compra. Este método retorna como respuesta un codeReverseOneClick identificador único de la transacción de reversa. cada vez que el usuario selecciona pagar con OneClick. • El comercio presenta al cliente el resultado de la inscripción. Estos datos son almacenados de forma segura formulario de pago actual de Webpay Plus. un token y URL de Webpay. el usuario debe ser redireccionado vía POST a urlWebpay con parámetro TBK_TOKEN igual al token obtenido. 9. el cual será utilizado para realizar las transacciones de pago.A. y nunca son conocidos por el comercio. a través del comercio. de $1 peso. Este proceso debe ser iniciado por la tienda del comercio y es • El cliente será autenticado por su banco emisor. que debe utilizar en el futuro para donde entrega los datos del cliente y la URL de término. con el token. disminuye el 9. Permite reversar una transacción de venta autorizada con anterioridad. la cual debe estar explicada en la página del comercio. MÉTODO DESCRIPCIÓN GENERAL Permite realizar la inscripción del tarjetahabiente e información de su tarjeta de crédito.3. este es similar al compras futuras. finishInscription Una vez terminado el flujo de inscripción en Transbank el usuario es enviado a la URL de fin de inscripción que definió el comercio. identificador de usuario.1 Descripción pasa por parámetro el token (método POST). que corresponde a la URL de inscripción de OneClick. de forma similar requisito que el cliente esté autenticado en la página del comercio al flujo normal de pago. Webpay envía el browser del mediante su nombre de usuario y clave. Retorna como respuesta un token que representa la transacción de inscripción y una URL (UrlWebpay). pasando por parámetro el token. dispuestos por Transbank para la inscripción de los tarjetahabientes. initInscription Una vez que se llama a este servicio Web. cliente a la URL entregada por el comercio. que desee utilizar el servicio. Este método que debe ser authorize ejecutado.9 TRANSACCIÓN ONECLICK 9 TRANSACCIÓN ONECLICK 9. En ese instante el comercio debe llamar a finishInscription. Proceso: • El cliente se conecta y autentica en la página del comercio. Permite realizar transacciones de pago. En este punto se realiza una transacción antes de iniciar la inscripción. • El comercio debe consumir otro servicio web de Transbank. obtiene realizar los pagos.0) 32 . ingrese los datos de su tarjeta. para que el cliente en Transbank. La inscripción es el proceso en el cual el tarjetahabiente registra los datos de su tarjeta en Webpay OneClick para usarlo en • Webpay presenta el formulario de inscripción. Retorna el resultado de la autorización. • Finalizada la inscripción. enrolamiento del tarjetahabiente. para obtener el resultado de la inscripción y el • El comercio consume un servicio web publicado por Transbank. • El cliente selecciona la opción de inscripción. Retorna el identificador del usuario en OneClick. Permite finalizar el proceso de inscripción del tarjetahabiente en OneClick. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 33 .3.2 Diagrama Inscripción CLIENTE COMERCIO WEBPAY BANCO Login comercio Selecciona Inscripción Login comercio username/email Token initInscription Token Pantalla ingreso de datos tarjeta Datos tarjeta Token banco Pantalla autenticación del banco username y password Token banco Token Token finishInscription user_tbk_id Comercio presenta resultado Ilustración 9: Diagrama de flujo proceso de inscripción REFERENCIA API SOAP WEBPAY TRANSBANK S.9 TRANSACCIÓN ONECLICK 9.A. {id usuario Transbank} CLIENTE COMERCIO WEBPAY Login Recibe Username : String (255) Id usuario Transbank : String (255) { booleano que indica si la inscripción fue dada Selecciona de baja correctamente) producto Retorna y pagar Pagar id_user_tbk. entregando el identificador de usuario (que se obtuvo En el caso que el comercio requiera eliminar la inscripción de en la inscripción).0) 34 . Id usuario Transbank : String (255) { booleano que indica si la inscripción fue dada de baja correctamente) El monto del pago debe estar dentro de los límites establecidos Retorna para este tipo de transacciones.5 Transacción de Pago Oneclick El pago es el proceso donde el comercio solicita el cargo de una Método Web Service compra a la tarjeta de crédito de un usuario inscrito anteriormente.9 TRANSACCIÓN ONECLICK 9. el proceso interno es similar a un Return: boolean (true/false) cargo normal de Webpay. el monto del pago y la orden de compra. Proceso: • El cliente se conecta y autentica en la página o aplicación del comercio mediante su nombre de usuario y clave. el comercio deberá consumir un servicio • El comercio presenta el resultado del pago al cliente. • El cliente selecciona la opción de pagar con Webpay Oneclick. id_trx Resultado Ilustración 10: Diagrama de Flujo de Pago Oneclick. Pago Método Web Service Permite eliminar una inscripción de usuario en removeUser Transbank {username}.4 Eliminar registro de inscripción de usuario Transbank. publicado por 9. web de Transbank con el identificador de usuario entregado en la inscripción. • El comercio usa el servicio web de pago. {id usuario Transbank} Recibe Los pagos en esta modalidad no requieren necesariamente la Username : String (255) intervención del usuario.3 Método initInscription 9. cliente en su sistema o por la solicitud de este para no operar con esta forma de pago.A. Permite gatillar el inicio del proceso de usando el identificador entregado por Transbank al momento de initInscription inscripción la inscripción. Una vez que se llama a este webservice el usuario debe ser redireccionado vía POST a urlWebpay con parámetro TBK_TOKEN igual al token.3. DOCUMENTO DE ESPECIFICACIONES (V 1. un usuario en Webpay OneClick ya sea por la eliminación de un Obtiene la respuesta con el código de autorización. {username}. monto Return: boolean (true/false) cod_autor. REFERENCIA API SOAP WEBPAY TRANSBANK S. REFERENCIA API SOAP WEBPAY TRANSBANK S. {monto}. donde 0 (cero) es aprobado. dentro del mismo día contable. anular un cargo realizado al cliente. {marca de tarjeta}. {id usuario Transbank}.7 Definición detallada de métodos del Servicio Web finishInscription INPUT token Identificador del proceso de inscripción. String (255) Método Web Service Recibe String (255) Permite reversar una venta y se obtiene Number (19. o borrar la inscripción. creditCardType Indica el tipo de tarjeta que fue inscrita por el cliente ( Visa. entregado por Webpay en el método initInscription OUTPUT responseCode Código de retorno del proceso de inscripción. debe consumir un servicio web publicado por Transbank con el identificador del authorize Permite autorizar un pago. {id de la transacción} Codigo de respuesta : Number (10. tbkUser Identificador único de la inscripción del cliente. {código de autorización}. MasterCard. AmericanExpress. 9. last4CardDigits Los últimos 4 dígitos de la tarjeta ingresada por el cliente en la inscripción. {orden de compra}. con la finalidad de la transacción de reversa.9 TRANSACCIÓN ONECLICK Método Web Service El comercio. este debe ser usado para realizar pagos. {username}. authCode Código que identifica la autorización de la inscripción. pago entregado en la respuesta de la autorización de la transacción. es un identificador único de concretarse. Recibe Retorna Orden de compra: Long {últimos 4 dígitos}. en caso de requerir reversar un pago.0) {reverseCode} {reversed} Retorna reverseCode: Long reversed: boolean (true/false) 9. Diners. {orden de compra} }.0) 35 . DOCUMENTO DE ESPECIFICACIONES (V 1. Magna).A.2) codeReverseOneClick el resultado de la reversa y un código de String (255) reversa en caso que esta sea exitosa. {código de respuesta}.6 Reversa de pagos autorizados Este proceso permite reversar una venta cuando esta no pudo El código regresado por este método. así como para la realización de los pagos. Resumen de los métodos del servicio Web REFERENCIA API SOAP WEBPAY TRANSBANK S. AmericanExpress. Falso de lo contrario. Identificador único de la compra generado por el comercio. máximo monto diario de pago excedido -98 Límites Oneclick. username Nombre de usuario. donde: 0 (cero) es aprobado. -1 Rechazo -2 Rechazo -3 Rechazo -4 Rechazo responseCode -5 Rechazo -6 Rechazo -7 Rechazo -8 Rechazo -97 Límites Oneclick.9 TRANSACCIÓN ONECLICK authorize INPUT amount Monto del pago en pesos. creditCardType Los últimos 4 dígitos de la tarjeta ingresada por el cliente en la inscripción. en el sistema del comercio. transactionId Identificador único de la transacción de pago. MasterCard. OUTPUT Código de retorno del proceso de pago.A. buyOrder Ej: Para la tercera transacción realizada el día 15 de julio de 2011 a las 11:55:50 la orden de compra sería: 20110715115550003. máxima cantidad de pagos diarios excedido authCode Código de autorización de la transacción de pago. Diners. DOCUMENTO DE ESPECIFICACIONES (V 1. máximo monto de pago excedido -99 Límites Oneclick.0) 36 . si fuera necesario removeUser INPUT tbkUser Identificador único de la inscripción del cliente username Nombre de usuario. Debe ser timestamp [yyyymmddhhMMss] + un correlativo de tres dígitos. se utiliza para la reversa. en el sistema del comercio. Magna). El proceso de integración con Webpay Oneclick consiste en desarrollar por parte del comercio las llamadas a los servicios web dispuestos por Transbank para la inscripción de los tarjetahabientes. del cliente. last4CardDigits Indica el tipo de tarjeta que fue inscrita por el cliente (Visa. tbkUser Identificador único de la inscripción del cliente. OUTPUT booleano Retorno verdadero. si fue posible eliminar la inscripción. del cliente. 1 Descripción de la captura diferida con autorización sin captura y el monto requerido para capturar el Este método permite a todo comercio habilitado realizar capturas de cual debe ser menor o igual al monto originalmente autorizado.2.A. DOCUMENTO DE ESPECIFICACIONES (V 1. Resumen del método del servicio web de captura diferida MÉTODO DESCRIPCIÓN GENERAL Permite solicitar a Webpay la captura diferida de una transacción con autorización y sin captura simultánea. El método contempla una única captura por cada autorización.0) 37 . Para Las ejecuciones con errores entregarán un SoapFault de acuerdo ello se deberá indicar los datos asociados a la transacción de venta a la codificación de errores definida. una transacción autorizada sin captura en plataforma Webpay 3G.2 Descripción del método del servicio web de captura diferida 10. 10. capture El método capture debe ser invocado siempre indicando el código del comercio que realizó la transacción. En el caso de comercios MALL.10 TRANSACCIÓN DE CAPTURA DIFERIDA 10 TRANSACC IÓN DE CAPTURA DIFERIDA 10.1 Operación capture Método que permite realizar la captura de una transacción. PARÁMETROS DE ENTRADA CAMPO DESCRIPCIÓN xs:string authorizationCode Código de autorización de la transacción que se requiere capturar Largo máximo: 6 xs:string buyOrder Orden de compra de la transacción que se requiere capturar Largo máximo: 26 xs:long commerceId Código de comercio o tienda mall que realizó la transacción Largo: 12 xs:decimal captureAmount Monto que se desea capturar Largo máximo: 10 PARÁMETROS DE SALIDA CAMPO DESCRIPCIÓN xs:string token Token de la transacción xs:string authorizationCode Código de autorización de la captura diferida xs:dateTime authorizationDate Fecha y hora de la autorización xs:decimal captureAmount Monto capturado REFERENCIA API SOAP WEBPAY TRANSBANK S. el código debe ser el código de la tienda virtual. 2. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 38 .2 Códigos de error Los siguientes son códigos de error exclusivos del método Capture CÓDIGO DESCRIPCIÓN 304 Validación de campos de entrada nulos 245 Código de comercio no existe 22 El comercio no se encuentra activo 316 El comercio indicado no corresponde al certificado o no es hijo del comercio MALL en caso de transacciones MALL 308 Operación no permitida 274 Transacción no encontrada 16 La transacción no es de captura diferida 292 La transacción no está autorizada 284 Periodo de captura excedido 310 Transacción reversada previamente 309 Transacción capturada previamente 311 Monto a capturar excede el monto autorizado 315 Error del autorizador REFERENCIA API SOAP WEBPAY TRANSBANK S.10 TRANSACCIÓN DE CAPTURA DIFERIDA 10.A. El método Webpay soporta una sola anulación parcial para la transacción de contempla anular total o parcialmente una transacción. Largo máximo: 6 xs:decimal Monto autorizado de la transacción que se requiere anular. línea que se desea anular y los montos requeridos para anular.2 Descripción del método del servicio web de anulación de 10. Para el caso que se esté anulando una transacción authorizationCode de captura en línea.0) 39 . este código corresponde al código de autorización de la captura. Se considera totalmente anulada una transacción cuando el monto Las ejecuciones con errores entregarán un SoapFault de acuerdo a anulado o el monto total de anulaciones cursadas alcancen el monto la codificación de errores definida. Para el caso que se esté anulando una transacción de authorizedAmount captura en línea. PARÁMETROS DE ENTRADA CAMPO DESCRIPCIÓN xs:string Código de autorización de la transacción que se requiere anular.2.1 Operación nullify transacciones Método que permite anular una transacción de pago Webpay. En caso de enviar una segunda anulación parcial se se deberá indicar los datos asociados a la transacción de venta en retornará una Exception.11 TRANSACCIÓN DE ANULACIÓN 11 TRANSACCIÓN DE ANULACIÓN 11. Resumen del método del servicio web de anulación de transacciones MÉTODO DESCRIPCIÓN GENERAL Permite solicitar a Webpay la anulación de una transacción realizada previamente y que se encuentra vigente. Para ello venta en línea. 11.A. el código debe ser el código de la tienda virtual. DOCUMENTO DE ESPECIFICACIONES (V 1.1 Descripción de la anulación autorizado en la venta en línea. Largo máximo: 10 xs:string buyOrder Orden de compra de la transacción que se requiere anular Largo máximo: 26 xs:long commerceId Código de comercio o tienda mall que realizó la transacción Largo: 12 xs:decimal ullifyAmount Monto que se desea anular de la transacción Largo máximo: 10 PARÁMETROS DE SALIDA CAMPO DESCRIPCIÓN xs:string token Token de la transacción xs:string authorizationCode Código de autorización de la anulación xs:dateTime authorizationDate Fecha y hora de la autorización xs:decimal Balance Saldo actualizado de la transacción (considera la venta menos el monto anulado) xs:decimal nullifiedAmount Monto anulado REFERENCIA API SOAP WEBPAY TRANSBANK S. Nullify El método nullify debe ser invocado siempre indicando el código del comercio que realizó la transacción. este monto corresponde al monto de la captura. Este método permite a todo comercio habilitado anular una transacción que fue generada en plataforma Webpay 3G. En el caso de comercios MALL. A.0) 40 . DOCUMENTO DE ESPECIFICACIONES (V 1.11 TRANSACCIÓN DE ANULACIÓN 11.2.2 Códigos de error Los siguientes códigos de error son los más comunes asociados al método de anulación CÓDIGO DESCRIPCIÓN 304 Validación de campos de entrada nulos 245 Código de comercio no existe 22 El comercio no se encuentra activo 316 El comercio indicado no corresponde al certificado o no es hijo del comercio MALL en caso de transacciones MALL 308 Operación no permitida 274 Transacción no encontrada 16 La transacción no permite anulación 292 La transacción no está autorizada 284 Periodo de anulación excedido 310 Transacción anulada previamente 311 Monto a anular excede el saldo disponible para anular 312 Error genérico para anulaciones 315 Error del autorizador REFERENCIA API SOAP WEBPAY TRANSBANK S. REFERENCIA API SOAP WEBPAY TRANSBANK S. DOCUMENTO DE ESPECIFICACIONES (V 1. Y es éste último (crt) es el que el comercio comparte con Transbank para la habilitación de su comercio en producción. el CSR y el En un terminal o consola.1 Creación de llave privada y certificado público 1.csr cuidado en ingresar el código de comercio productivo.csr El comercio es responsable por resguardar su llave privada y • 59702012345678. ya entregado por Transbank.key -out 597012345678. obtendrá 3 archivos: • 59702012345678. procurando indicar 1460 on la llave privada y el CSR creados.key 2048 2.key • 59702012345678. section) []: Ingrese_un_nombre_opcional Common Name (eg.1. 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.0) 41 .csr Le solicitará ingresar los siguientes datos.csr -signkey 597029124456. cree la llave certificado público productivo de un comercio cuyo código de utilizando el siguiente comando comercio productivo es 12345678 openssl genrsa -out 597012345678. city) []:Ingrese_su_ciudad Organization Name (eg. como asimismo es responsable por reemplazar estos cuando caduquen. utilizando el (archivo csr) openssl req -new -key 597012345678. utilizando openSSL. company) []: Ingrese_el_nombre_de_su_organizacion _el Organizational Unit Name (eg. teniendo especial Lo que generará un archivo llamado 59702012345678. your name or your server’s hostname) []:597012345678 Email Address []: Please enter the following ‘extra’ attributes to be sent with your certificate request A challenge password []: An optional company name []: 3.A. Crear requerimiento de certificado siguiente comando deberá crear el requerimiento de certificado Manteniendo en el mismo directorio la llave privada. para la duración de la validez del certificado openssl x509 -req -days 1460 -in 597029124456.crt su certificado público.key -out 597012345678.1 Anexo A: Creación de llaves y ambientes Webpay 12.12 ANEXOS 12 ANEXOS 12.crt Con todos los pasos. Crear certificado autofirmado público utilizando el siguiente comando. Crear llave privada Este es un ejemplo para crear la llave privada. debe crear el certificado días o más. transbank.A.cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl Certificado público productivo de Webpay -----BEGIN CERTIFICATE----- MIIDNDCCAhwCCQCJEQxY1moacjANBgkqhkiG9w0BAQsFADBcMQswCQYDVQQGEwJD TDELMAkGA1UECBMCUk0xETAPBgNVBAcTCFNhbnRpYWdvMRIwEAYDVQQKEwl0cmFu c2JhbmsxDDAKBgNVBAsTA1BSRDELMAkGA1UEAxMCMTAwHhcNMTQwNTA4MjEwNjIy WhcNMTgwNTA4MjEwNjIyWjBcMQswCQYDVQQGEwJDTDELMAkGA1UECBMCUk0xETAP BgNVBAcTCFNhbnRpYWdvMRIwEAYDVQQKEwl0cmFuc2JhbmsxDDAKBgNVBAsTA1BS RDELMAkGA1UEAxMCMTAwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCk ag5P6b/BnlpxGk1YX8OeX04ZqmxWThxHP1J+6FVj/hMYw9JGf2gMDCWd3fYaWwRM X7Y6MidAGCiVwNgsixsUad9C2qQWtpTHoc3T+rQuZ6wmGwxc/K/Gcjf4nuJQUPBo 3zjat+HC0HzPrTscms4A2EZ2VQ/bbznKiOWxcBSqqZ/8jK/RMmu4E6Pzj8Ms+vbA BfDCq9GDfeNZ+gtQna86enEX7XY/N55SO+VHv/6zGIof7kGIobeF1hYwALrKDhvy FVQgh4VUBhP0adtnQBfCc1mGVgnviAjioxMxGT4wwaj6IfTvtHhkxVcJ9qmX9oki wygTooWtcMM6U4oiVd+vAgMBAAEwDQYJKoZIhvcNAQELBQADggEBAEqW5DtWdAUP iSBpExhPgSnm+X6eiDmM3q0S8gWls3hnZCQ9RfhVROj93OS4Zaqg82RLGiU3GsWF pj4YRw0flCC7bCxo7Mt4Lvv6ihQYdsWxA97HN55HQOVv853kQAu6/vnCxoTtMt6W +zuiQY7hhabLhOCNJcrFpabj0wCO62IrWv65AZlikcsNKLAwQrstY7Y1VU5DOcXy FfE5niUGxH0mARXMxq1Z3CBqJ3GKKMmngqCMxX8ZFjIvz0z0VsOJQheX4Hl8prAR ZlVlkH02xlKKLIO2tcnXik1eW5VCpzuF6z9W3WqcvpaltfspJPx3kN3k5NHATNgk IypDl0jmq2w= -----END CERTIFICATE----- REFERENCIA API SOAP WEBPAY TRANSBANK S.1.transbank.12 ANEXOS 12. DOCUMENTO DE ESPECIFICACIONES (V 1.0) 42 .cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl Certificado público Webpay integración -----BEGIN CERTIFICATE----- MIIDKTCCAhECBFZl7uIwDQYJKoZIhvcNAQEFBQAwWTELMAkGA1UEBhMCQ0wxDjAMBgNVBAgMBUNo aWxlMREwDwYDVQQHDAhTYW50aWFnbzEMMAoGA1UECgwDa2R1MQwwCgYDVQQLDANrZHUxCzAJBgNV BAMMAjEwMB4XDTE1MTIwNzIwNDEwNloXDTE4MDkwMjIwNDEwNlowWTELMAkGA1UEBhMCQ0wxDjAM BgNVBAgMBUNoaWxlMREwDwYDVQQHDAhTYW50aWFnbzEMMAoGA1UECgwDa2R1MQwwCgYDVQQLDANr ZHUxCzAJBgNVBAMMAjEwMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAizJUWTDC7nfP 3jmZpWXFdG9oKyBrU0Bdl6fKif9a1GrwevThsU5Dq3wiRfYvomStNjFDYFXOs9pRIxqX2AWDybjA X/+bdDTVbM+xXllA9stJY8s7hxAvwwO7IEuOmYDpmLKP7J+4KkNH7yxsKZyLL9trG3iSjV6Y6SO5 EEhUsdxoJFAow/h7qizJW0kOaWRcljf7kpqJAL3AadIuqV+hlf+Ts/64aMsfSJJA6xdbdp9ddgVF oqUl1M8vpmd4glxlSrYmEkbYwdI9uF2d6bAeaneBPJFZr6KQqlbbrVyeJZqmMlEPy0qPco1TIxrd EHlXgIFJLyyMRAyjX9i4l70xjwIDAQABMA0GCSqGSIb3DQEBBQUAA4IBAQBn3tUPS6e2USgMrPKp sxU4OTfW64+mfD6QrVeBOh81f6aGHa67sMJn8FE/cG6jrUmX/FP1/Cpbpvkm5UUlFKpgaFfHv+Kg CpEvgcRIv/OeIi6Jbuu3NrPdGPwzYkzlOQnmgio5RGb6GSs+OQ0mUWZ9J1+YtdZc+xTga0x7nsCT 5xNcUXsZKhyjoKhXtxJm3eyB3ysLNyuL/RHy/EyNEWiUhvt1SIePnW+Y4/cjQWYwNqSqMzTSW9TP 2QR2bX/W2H6ktRcLsgBK9mq7lE36p3q6c9DtZJE+xfA4NGCYWM9hd8pbusnoNO7AFxJZOuuvLZI7 JvD7YLhPvCYKry7N6x3l -----END CERTIFICATE----- Endpoint Producción https://webpay3g.2 Ambientes de Webpay Endpoint integración / Validación https://webpay3gint. después del • Tipo de cuota proceso de autorización y previo a redirigir al tarjeta habiente al • Cantidad de cuotas comprobante de éxito de la transacción. como mínimo.Tarjeta aun no habilitada en el sistema financiero. . transacción fue autorizada o no.1 Requerimientos Página de Transición • Fecha de la transacción La página de transición de comercio. • Número de orden de Pedido .A.2 Requerimientos Página final de éxito Una vez finalizada a transacción.Su tarjeta de Crédito o Débito no cuenta con saldo Se recomienda. • Descripción de los bienes y/o servicios Es recomendable que en esta página muestre la imagen de 12.0) 43 .transbank. Puede presentar un texto https://webpay3g.Error en el ingreso de los datos de su tarjeta de Crédito de la transacción.2 Anexo B: Requerimientos de páginas de transición y de • Monto y moneda de la transacción página de fin de transacción • Código de autorización de la transacción 12. el comercio debe presentar una Las posibles causas de este rechazo son: página al tarjetahabiente para que este se informe del resultado . Aplica para todos los • 4 últimos dígitos de la tarjeta bancaria tipos de transacciones. DOCUMENTO DE ESPECIFICACIONES (V 1.gif Orden de Compra XXXXXXX 12.2. que se encuentra en la URL Cuando la transacción no sea autorizada. es la página que muestra • Tipo de pago realizado (Débito o Crédito) el comercio cuando Webpay le entrega el control.12 ANEXOS 12.3 Requerimientos Página final de fracaso background del formulario de pago. • Nombre del comercio (Tienda de Mall) REFERENCIA API SOAP WEBPAY TRANSBANK S. que posea suficiente.2.cl/ explicativo como: webpayserver/imagenes/background. se recomienda informar al tarjetahabiente al respecto. La información a presentar dependerá de si la o Débito (fecha y/o código de seguridad).2. DOCUMENTO DE ESPECIFICACIONES (V 1. # 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.2 Anexo C: Excepciones SOAP API Webpay Las excepciones más comunes que pueden ser presentadas en cualquier integración Webpay en su modalidad SOAP.A.0) 44 . son las siguientes.12 ANEXOS 12. A.0) 45 . DOCUMENTO DE ESPECIFICACIONES (V 1.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. DOCUMENTO DE ESPECIFICACIONES (V 1.A.0) 46 .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. 2 Pruebas de validación para Transacción Normal 12.5 Pruebas de validación para Transacción OneClick • Inscripción rechazada • Inscripción exitosa • Autorización • Reversa • Remover usuario REFERENCIA API SOAP WEBPAY TRANSBANK S. 12.4 Pruebas de validación para Transacción Mall • Pago crédito exitoso sin cuotas • Pago crédito exitoso sin cuotas • Pago crédito exitoso con cuotas • Pago crédito exitoso con cuotas • Pago crédito denegado • Pago crédito denegado • Pago débito exitoso • Pago débito exitoso • Pago débito denegado • Pago débito denegado • Anulación parcial (solo si integra el método) • Anulación parcial (solo si integra el método) • Anulación total (solo si integra el método) • Anulación total (solo si integra el método) • Pago cancelado (abortado en formulario Webpay) • Pago cancelado (abortado en formulario Webpay) 12.4 Anexo D: Pruebas de validación efectuada por Transbank 12.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.4.4.4.3 Pruebas de validación para Transacción Normal modalidad plugin captura diferida • Pago crédito exitoso sin cuotas • Pago crédito exitoso sin cuotas • Pago crédito exitoso con cuotas • Pago crédito exitoso con cuotas • Pago crédito denegado • Pago crédito denegado • Pago débito exitoso • Pago cancelado (abortado en formulario Webpay) • Pago débito denegado • Anulación parcial (solo si integra el método) • Pago cancelado (abortado en formulario Webpay) • Anulación total (solo si integra el método) 12.A.1 Pruebas de validación para Transacción Normal.0) 47 .4. DOCUMENTO DE ESPECIFICACIONES (V 1. php/16790/wss-v1.A.1-spec-os-SOAPMessageSecurity.0) 48 . DOCUMENTO DE ESPECIFICACIONES (V 1.org/committees/download.oasis-open.12 ANEXOS 12.pdf REFERENCIA API SOAP WEBPAY TRANSBANK S.5 Anexo D: Referencias https://www.