Escolar Documentos
Profissional Documentos
Cultura Documentos
SOAP WEBPAY
TRANSBANK S.A.
DOCUMENTO DE ESPECIFICACIONES (V 1.0)
CONTENIDO NDICE INTERACTIVO
Haz click en nmero de captulo o
de pgina para acceder directamente.
1 CONTROL DE CAMBIOS 5
2 PREFACIO 5
5 2.1 Acerca de esta gua
5 2.2 Audiencia
5 2.3 Feedback para esta documentacin
3 SOBRE WEBPAY 6
4 CONSIDERACIONES GENERALES 10
10 4.1 Comunicacin
10 4.2 Seguridad
10 4.3 Deberes de los comercios
10 4.3.1 Validacin de mensajes de solicitud y respuesta
10 4.3.2 Actualizaciones de plugins y SDK
9 TRANSACCIN ONECLICK 32
12 ANEXOS 41
1 CONTROL DE CAMBIOS
2 PREFACIO
3 SOBRE WEBPAY
Dentro de los atributos ms relevantes de Webpay se pueden comercio por eventuales fraudes o desconocimientos de
mencionar: compra.
Permite realizar transacciones seguras y en lnea a travs de
Internet. La seguridad es reforzada por medio de la utilizacin de
servidores seguros, protegidos con TLS 1.2
En transacciones con Webpay Plus se solicita al tarjetahabiente
autenticarse con su emisor, protegiendo de esta forma al Firma digital.
Una transaccin normal corresponde a una solicitud de autorizacin financiera de un pago con tarjetas de crdito o
Normal dbito. El tarjetahabiente ingresa al sitio del comercio, selecciona productos o servicio, y el ingreso asociado a los datos
de la tarjeta de crdito o dbito lo realiza en forma segura en Webpay.
Una transaccin Mall corresponde a mltiples solicitudes de autorizacin financiera de distintos cdigos de comercios
pertenecientes a un comercio padre. Cada transaccin constituye un pago con tarjetas de crdito o dbito en una
Mall
tienda en particular. El tarjetahabiente ingresa al sitio del comercio padre, selecciona productos o servicio de distintas
tiendas, y el ingreso asociado a los datos de la tarjeta de crdito o dbito lo realiza en forma segura en Webpay.
Una transaccin OneClick permite que el tarjetahabiente registre su tarjeta de crdito nacional una nica vez y los
pagos los realice en un solo click en la tienda de comercio electrnico. El registro de la tarjeta queda almacenado en
One Click Webpay en forma segura y asociado al login de usuario de la tienda, de esta forma cada vez que un tarjetahabiente
realiza una compra en la tienda, basta con que inicie sesin en esta y presione pagar para enviar todos los datos
asociados a la transaccin.
3.3 Autorizacin y captura de transacciones de crdito la cuenta de crdito asociada a la tarjeta del titular. Ambas fases
Las transacciones Webpay cuentan con 2 fases, autorizacin pueden ocurrir en el mismo instante o en forma desfasada. Estas
y captura. La autorizacin se encarga de validar si es posible modalidades, por separado, solo son vlidas para tarjetas de
realizar el cargo a la cuenta asociada a la tarjeta de crdito crdito. En el caso de compras con tarjeta de dbito siempre es
realizando en el mismo acto la reserva de monto de la transaccin. en modalidad autorizacin y captura simultanea no siendo posible
La captura hace efectiva la reserva hecha previamente o cargo en separar ambos procesos.
Autorizacin
Es la utilizada cuando la transaccin es validada en lnea por Transbank. El cargo del pago se hace simultneamente
y captura
simultanea en la tarjeta de crdito o dbito del cliente.
Es utilizada cuando el comercio por diversas razones, ejemplo: verificacin de stock, no puede realizar la transaccin
en tiempo real, aqu lo que se hace es retener el valor de la compra del saldo de la tarjeta de crdito del cliente sin
consumir definitivamente el cupo de la tarjeta de crdito hasta que el comercio confirma la compra, va captura, y lo
comunique a Transbank.
Existe un tiempo mximo de 7 das para realizar esto ltimo, de no ser as la retencin de la tarjeta de crdito del cliente
ser reversada.
Esta modalidad slo est disponible para pagos de crdito y no as para pagos con tarjetas de dbito.
Los tipos de pago soportados para esta modalidad son solo los siguientes:
- Venta Normal
- 2 cuotas sin inters
- 3 cuotas sin inters
- N Cuotas
3.4 Anulacin de transacciones querer hacerlo se debe entregar el dinero en efectivo al cliente.
Webpay permite, por medio de servicios Web, anular una
transaccin de crdito que fue autorizada. Las transacciones crdito se pueden anular bajo el siguiente criterio:
Esta operacin contempla anular total o parcialmente una Producto Cdigo Anulacin Anulacin
Total Parcial
transaccin. Para ello se deber indicar los datos asociados a la
transaccin de autorizacin o captura en lnea sobre los cuales se Venta Normal VN
El comercio conoce el producto aplicado en una transaccin al Para que la transaccin sea autenticada, el comercio debe tener
obtener la respuesta de autorizacin original desde Transbank. habilitado Webpay Plus o 3D Secure.
Este dato debe ser almacenado por el comercio para poder
aplicar la lgica de anulacin parcial y/o total. 3.7 Compatibilidad con navegadores Web
Transbank garantiza el correcto funcionamiento de Webpay bajo
Las anulaciones no pueden ser aplicadas, por ahora, en los siguientes dispositivos y navegadores:
comercios OneClick.
Clientes PC:
3.5 Monedas soportadas Internet Explorer 9 o superior
Actualmente Webpay soporta los siguientes tipos de monedas: Microsoft Edge
Pesos Chilenos (CLP) Mozilla Firefox 48 o superior
Dlares norteamericanos (USD) Chrome 52 o superior
Safari 7 o superior
3.6 Autenticacin del tarjetahabiente
Webpay permite autenticar al tarjetahabiente durante el proceso de Smartphone / Dispositivos mviles:
pago, agregando mayor seguridad y evitando desconocimientos Blackberry 9900, 9700
de compra. Las modalidades de autenticacin existentes son los iPhone e iPod en cualquiera de sus versiones
siguientes: Android en cualquiera de sus versiones
3.8 Tipos de pago (productos) tenga activado el comercio, en general se soportan los siguientes
Los tipos de pago disponibles actualmente a travs de Webpay tipos de pago:
dependen del tipo de tarjeta usada por el tarjetahabiente y los que
Abreviacin
Tipo de Pago Descripcin
tipo de pago
N CUOTAS Corresponde al pago de un producto o servicio en N cuotas iguales sin inters para
CRDITO (SIN el TH. El nmero de cuotas puede ir de 2 hasta "N" cuotas. Con "N" mximo 12, y NC
INTERS) definido por el Comercio.
CUOTAS SIN Corresponde al pago de un producto o servicio en N cuotas iguales sin inters para el
INTERS DEL TH. Esto es una promocin del emisor de la tarjeta. Puede ir de 2 hasta 48 cuotas. El VC
EMISOR Emisor escoge el rango en promocin.
Cuotas normales o cuotas fijas van de 2 hasta 48 y se les aplica el inters definido por
CUOTAS
cada Emisor. Si ste se encuentra adherido a diferimiento puede ofrecer desde 1 hasta VC
NORMALES
3 meses de diferido (sin impacto para el Comercio).
Nota: Para dudas con respecto a los abonos para el comercio, dirigirse al Manual de Comercios de Webpay.
4 CONSIDERACIONES GENERALES
Dado lo anterior es que, al utilizar cualquier software distribuido Cabe recordar que Webpay posee 2 ambientes: integracin/
por Transbank, asume que el comercio acepta esta y otras testing y produccin. En ambos casos, Webpay posee un
consideraciones publicadas en certificado distinto para cada ambiente, por lo que debe procurar
www.transbankdevelopers.cl no confundir el escenario en que se encuentra el comercio.
4.2 Seguridad
Los servicios Web de Webpay estn protegidos para garantizar 4.3.2 Actualizaciones de plugins y SDK
que solamente miembros autorizados por Transbank hagan uso Si el comercio est utilizando una solucin basada en Plugins
de las operaciones disponibles. El mecanismo de seguridad o SDK, debe atento a las actualizaciones que peridicamente
implementado est basado en un canal de comunicacin seguro Transbank realizarn, los que pueden responder a mantener
TLS 1.2 y WS-Security, los cuales proporcionan autenticacin, compatibilidad con los CMS o Shoppping Cart para su
confidencialidad e integridad a los Servicios Web. Con lo anterior, compatibilidad, modificaciones por seguridad, adicin de
la seguridad se encuentra basada en: propiedades o funciones, o correcciones a las comunicaciones.
Canal seguro a travs de TLS 1.2 para la comunicacin del La comunicacin oficial siempre se realizar a travs del sitio
cliente con Webpay.
www.transbankdevelopers.cl
Mensajes requerimientos y respuestas firmados digitalmente.
La API SOAP de Webpay est basada en el estndar conocido El comercio debe generar un certificado digital, el cual puede ser
*1 como Servicios Web*1, el que incluye el protocolo SOAP (Simple auto-firmado, teniendo especial cuidado de usar el common name
Object Access Protocol) 1.1, WSDL (Web Services Definition (CN) igual al cdigo de comercio entregado por Transbank,
Language), proporcionando un alto grado de interoperabilidad, ejemplo: cn = 597029124456.|
un protocolo estndar para invocacin de servicios remotos e
independencia de la plataforma y el lenguaje de desarrollo. El comercio debe enviar a Transbank el certificado digital (parte
pblica) que utilizar para validar que el requerimiento viene
El tipo de transaccin, la posibilidad de permitir el pago con crdito realmente desde el comercio. No se requiere la llave privada de
y dbito, y los productos cuotas, dependern del tipo de producto este y siempre debe ser custodiada por el comercio.
contratado por el comercio y del emisor de la tarjeta utilizada en
la compra. En los siguientes captulos se entrega informacin Transbank entregar su certificado a los comercios en el
especfica para cada tipo de transaccin. proceso de integracin, de testing y de puesta en produccin,
de forma independiente para que puedan realizar la validacin
5.1 Aspectos de Seguridad de API SOAP de la firma en la respuesta.
5.1.1 Informacin general
Los servicios Web de Webpay estn protegidos para garantizar Todos los mtodos, en su requerimiento y respuesta van con
que solamente miembros autorizados por Transbank hagan uso firma digital (WS-Security) del cuerpo del mensaje ({http://
de las operaciones disponibles. El mecanismo de seguridad schemas.xmlsoap.org/soap/envelope/}Body). El comercio
implementado est basado en un canal de comunicacin seguro firma con su certificado el requerimiento y valida la respuesta
TLS 1.2 y WS-Security, los cuales proporcionan autenticacin, con el certificado de Transbank.
confidencialidad e integridad a los Servicios Web. Con lo
anterior, la seguridad se encuentra basada en: 5.1.2 Generacin de llave y certificado auto-firmado
Canal seguro a travs de TLS 1.2 para la comunicacin del 1. Crear llave privada
cliente con Webpay.
openssl genrsa -out 597029124456.key 2048
Mensajes requerimientos y respuestas firmados digitalmente.
2. Crear requerimiento de certificado
REQUERIMIENTO
6.1 Etapas de integracin de Webpay ambiente de integracin, ya vienen preinstalados, por lo que
Para que el comercio incorpore Webpay como medio de pago, es no requiere de una configuracin adicional.
necesario que realice las siguientes etapas:
Etapa de Integracin Cabe destacar, las tienda de pruebas soporta los medios
Etapa de Validacin de Integracin de pago dbito y crdito en transaccin normal y captura
Etapa de Puesta en produccin simultnea, en moneda pesos chilenos, que es el producto
Webpay ms utilizado en el mercado.
Cada una de las etapas es necesaria para que el comercio realice
una correcta implementacin de Webpay, priorizando la seguridad Cualquier duda con este aspecto, o algn requerimiento
e integridad transaccional. en particular respecto de la tienda de integracin,
contacte a la mesa de soporte al 800 44 11 44 o al correo
6.1.1 Etapa de integracin
soporte@transbank.cl
La etapa de integracin corresponde al proceso en que el
comercio desarrolla su solucin de medio de pago, consumiendo 6.1.1.2 Datos de prueba para el ambiente de integracin
los servicios de la API Webpay. Para utilizar el ambiente de integracin, necesitar tarjetas
de pruebas, las que se encuentran predefinidas para los
En este caso, el comercio utiliza un cdigo de comercio escenarios de xito y fracaso.
de integracin que provee Transbank, junto con todas las
credenciales necesarias para realizar la conexin y el correcto En ambos casos, y tanto para dbito y crdito, las
consumo de servicios. transacciones son autenticadas, por lo que deben utilizarse
los siguientes datos.
En el caso que el comercio desee utilizar los plugins o los SDK
que provee Transbank, stos ya incorporan dichas credenciales. Para el caso de pruebas con tarjetas de crdito, se tiene lo
Si el comercio desea desarrollar su propia solucin, entonces siguiente:
debe utilizar las credenciales correspondientes que las puede
obtener desde transbankdevelopers.cl o solicitndolas a Marca VISA MASTERCARD
N de Tarjeta 4051885600446623 5186059559590568
soporte@transbank.cl
Ao Expiracin Cualquiera Cualquiera
6.1.1.1 Credenciales Mes Expiracin Cualquiera Cualquiera
Para comenzar el proceso de integracin, visite CVV 123 123
y descargue el plugin correspondiente a su Shopping Cart o Para el caso de transacciones con tarjeta de dbito:
CMS, el SDK de su preferencia, o el package con credenciales
APRUEBA RECHAZA
correspondientes si desea utilizar desarrollo propio.
TARJETA 4051885600446620 5186059559590560
Procure cumplir con los requisitos tcnicos que all se RUT 11.111.111-1 11.111.111-1
especifican y seguir las instrucciones de instalacin PASSWORD 123 123
detalladas para cada caso.
6.1.2 Etapa de validacin de Integracin
Cada plugin viene de la forma listo para usar en ambiente de Durante la validacin de la integracin se pretende verificar que
integracin / validacin, cumpliendo con los requerimientos el comercio transacciona de manera segura y sin problemas,
tcnicos, de seguridad y de despliegue de informacin por lo que se solicitarn una serie de pruebas y su posterior
requeridos por Webpay, por lo que no debera modificar nada. envo de evidencias para validar la integracin.
La tienda de pruebas que viene por defecto con los plugins
tiene el cdigo de comercio 597020000541, y su llave privada, Esta validacin es requisito necesario para dejar al comercio
certificado pblico y el certificado pblico de Webpay, para el en produccin y no se permitir que un comercio utilice
productivamente el servicio Webpay sin poseer una validacin. Estos pasos incluyen cambio en el ambiente sobre el que
transacciones, pasando de integracin a produccin, adems
Por otro lado, Transbank no validar ninguna integracin a de las instrucciones de creacin de llave privada productiva y
algn comercio que no posea cdigo de comercio productivo. certificado pblico autofirmado asociado a dicha llave, como
Para obtenerlo, siga las instrucciones en cmo hacerse asimismo el cambio en el certificado pblico de transbank del
cliente en el portal ambiente productivo.
www.transbank.cl
o contacte a su ejecutivo comercial. Para dudas sobre las llaves y certificados, ver anexo Creacin
de llaves y ambiente de integracin
En esta etapa, el comercio enva las evidencias a
soporte@transbank.cl Durante el paso a produccin se le exigir realizar, al menos,
una transaccin de prueba, con la que finalizar oficialmente la
mediante el formulario correspondiente, indicando claramente puesta en produccin.
las rdenes de compra, fecha y hora de las transacciones.
Como Webpay utiliza WS_Security, es que es en esta etapa 2) Ambiente de produccin: Este ambiente es en el cual
en que se intercambian, comercio y Transbank, los certificados finalmente operar productivamente el comercio. En este
pblicos productivos, manteniendo ambas partes sus ambiente puede hacer pruebas con tarjetas de crdito o dbito
respectivas llaves privadas. De esta manera, es que ambas reales. Las credenciales de este ambiente son entregadas al
partes firman sus comunicaciones y la contraparte validar las momento que se coordina el paso a produccin.
firmas con los certificados ya intercambiados.
Cada uno de estos ambientes maneja distintas URLs (endpoints),
Una vez que soporte le comunique formalmente que la distintos cdigos de comercios, distintas tarjetas de prueba y
integracin est aprobada, deber seguir los pasos que le indican distintos certificados, por lo que es importante tener la claridad
para pasar a produccin y poder comenzar a transaccionar de que, al realizar el cambio de ambiente un ambiente a otro, se
manera real. consideren los puntos anteriores.
7.1 Descripcin de la Transaccin de Autorizacin Normal ingreso asociado a los datos de la tarjeta de crdito o dbito lo
Una transaccin de autorizacin normal (o transaccin normal), realiza en forma segura en Webpay.
corresponde a una solicitud de autorizacin financiera de un pago
con tarjetas de crdito o dbito, en donde quin realiza el pago El flujo de pginas para la transaccin es el siguiente:
ingresa al sitio del comercio, selecciona productos o servicio, y el
2 initTransaction()
4 Redirect(token...)
5 Request(token)
6 Formulario Webpay()
7 Pagar()
8 Autoriza()
9 Redirect()
10 Request(token)
11 getTransactionResult(token...)
12 Response()
13 acknowledge Transaction(token)
14 Redirection(token)
15 Request(token)
16 Comprobante Webpay()
17 Request(token)
18 Pagina final()
7.2.2 Descripcin de la secuencia autorizacin sea persistida en los sistemas del comercio, ya que
1. Una vez seleccionado los bienes o servicios, tarjetahabiente este mtodo se puede invocar una nica vez por transaccin.
decide pagar a travs de Webpay.
12. Comercio recibe el resultado de la invocacin del mtodo
2. El comercio inicia una transaccin en Webpay, invocando el getTransactionResult().
mtodo initTransaction().
13. Para que el comercio informe a Webpay que el
3. Webpay procesa el requerimiento y entrega como resultado de la transaccin se ha recibido sin problemas,
resultado de la operacin el token de la transaccin y el sistema del comercio debe consumir el tercer mtodo
URL de redireccionamiento a la cual se deber redirigir al acknowledgeTransaction(). Si esto fue ejecutado
tarjetahabiente. correctamente el producto puede ser liberado al cliente.
9. Una vez resuelta la autorizacin, Webpay retorna el control 15. Webpay recibe un requerimiento con la variable token_ws
al comercio, realizando un redireccionamiento HTTP/HTTPS
hacia la pgina de transicin del comercio, en donde se enva por 16. Webpay identifica la transaccin y despliega el comprobante
mtodo POST el token de la transaccin en la variable token_ws. de pago al tarjetahabiente.
El comercio debe implementar la recepcin de esta variable.
17. Una vez visualizado el comprobante de pago por un
10. El navegador Web del tarjetahabiente realiza una peticin periodo acotado de tiempo, el tarjetahabiente es redirigido de
HTTP/HTTPS al sitio del comercio, en base a la redireccin vuelta al sitio del comercio, por medio de redireccionamiento
generada por Webpay en el punto 9. con el token en la variable token_ws enviada por mtodo
POST hacia la pgina final informada por el comercio en el
11. El sitio del comercio recibe la variable token_ws e invoca el mtodo initTransaction.
segundo mtodo Web, getTransactionResult () (mientras
*2 se despliega la pgina de transicin*2), para obtener el resultado 18. Sitio del comercio despliega pgina final de pago*3. *3
*2 El detalle de la pgina de transicin se encuentra descrito en Anexo A, *3 El detalle de la pgina de final se encuentra descrito en Anexo A,
del documento de descripcin general de la API SOAP. 12.1.2 del documento de descripcin general de la API SOAP.
7.3.1 Diagrama
El siguiente diagrama ilustra la secuencia de una transaccin
normal donde el TH anula la transaccin en el formulario de
pago de Webpay y cmo participan los distintos actores en
esta situacin.
2 initTransaction()
4 Redirect(token...)
5 Request(token)
6 Formulario Webpay()
7 Anular()
8 Redirect()
9 Request(token)
10 Pagina final()
Ilustracin 3: Diagrama de secuencia de pago en una transaccin normal anulada en formulario de pago
7.3.2 Descripcin secuencia de pago para transaccin anulada resultado de la autorizacin. En este caso debe obtener una
en formulario de pago: excepcin, pues el pago fue abortado.
1. Pasos de 1 a 6 son idnticos a la secuencia normal.
10. El comercio debe informar al tarjeta habiente que su pago
7. Tarjetahabiente hace clic en anular, en formulario Webpay. no se complet, segn anexo glosa transaccin no autorizada.
8. Webpay retorna el control al comercio, realizando un 7.4 Flujo Alternativo: Secuencia de pago en una transaccin
redireccionamiento HTTP/HTTPS hacia la pgina de final del normal con evento de timeout
comercio, en donde se enva por mtodo POST el token de la
transaccin en la variable TBK_TOKEN. 7.4.1 Diagrama
El siguiente diagrama ilustra la secuencia de pago y cmo
9. El comercio con la variable TBK_TOKEN debe, invocar el participan los distintos actores en una transaccin normal con
segundo mtodo Web, getTransactionResult () (mientras evento de timeout.
*4 se despliega la pgina de transicin*4), para obtener el
2 initTransaction()
4 Redirect(token...)
5 Request(token)
6 Formulario Webpay()
7 Timeout()
7.4.2 Descripcin de secuencia alternativa, timeout: 7.5 Descripcin de mtodos del Servicio Web de Transaccin
1. Pasos de 1 a 6 son idnticos a la secuencia normal. de Autorizacin Normal
7. Tarjetahabiente se encuentra en formulario Webpay, pero no A continuacin se describen cada uno de las operaciones que
presiona pagar durante 10 minutos. Esto causa un timeout en deben ser utilizadas en una Transaccin Normal.
dicho formulario.
7.5.1 Operacin initTransaction
8. Webpay genera un error de timeout, se presenta una pantalla Mtodo que permite iniciar una transaccin de pago Webpay.
*5 indicando que ocurri un error*5. Se regresa automticamente
al comercio. 7.5.1.1 Parmetro de entrada
NOMBRE DESCRIPCIN
tns:wsTransactionType
WSTransactionType
Indica el tipo de transaccin, su valor debe ser siempre TR_NORMAL_WS
xs:string
sessionId (Opcional) Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin.
Largo mximo: 61
xs:anyURI
returnURL (Obligatorio) URL del comercio, a la cual Webpay redireccionar posterior al proceso de autorizacin
Largo mximo: 256
xs:anyURI
finalURL (Obligatorio) URL del comercio a la cual Webpay redireccionar posterior al voucher de xito de Webpay.
Largo mximo 256
tns:wsTransactionDetail
(Obligatorio) Lista de objetos del tipo wsTransactionDetail, el cual contiene datos de la transaccin. Mxima
transactionDetails
cantidad de repeticiones es de 1 para este tipo de transaccin.
wsTransactionDetail est descrito ms adelante.
tns:wPMDetail
wPMDetail
(No se utiliza para Transaccin Normal) Este campo contiene la transaccin webpay mensual.
xs:string
(Opcional)Es el cdigo nico de identificacin del comercio entregado por Transbank. Es obligatorio para
commerceId
transaccin MALL.
Largo: 12
xs:string
buyOrder (Opcional) Es el cdigo nico de la orden de compra generada por el comercio. Es obligatorio para transaccin
MALL.
TYPE WSTRANSACTIONDETAIL
Descripcin: Tipo de dato contiene detalles de la transaccin
CAMPO DESCRIPCIN
xs:decimal
amount Monto de la transaccin. Mximo 2 decimales para USD.
Largo mximo: 10
xs:string
Orden de compra de la tienda.*6
buyOrder
Largo mximo: 26
La orden de compra puede tener: Nmeros, letras, maysculas y minsculas, y los signos |_=&%.,~:/?[+!@()>-
xs:string
commerceCode Cdigo comercio de la tienda entregado por Transbank.
Largo: 12
sharesAmount Campo no utilizado
sharesNumber Campo no utilizado
CAMPO DESCRIPCIN
xs:string
buyOrder Orden de compra de la tienda.
Largo mximo: 26
xs:string
sessionId
Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin. Largo mximo: 61
Tns:carddetails
cardDetails
Objeto que representa los datos de la tarjeta de crdito del tarjeta habiente. cardDetails descrito ms adelante.
xs:string
accoutingDate Fecha de la autorizacin.
Largo: 4, formato MMDD
xs:string
transactionDate Fecha y hora de la autorizacin.
Largo: 6, formato: MMDDHHmm
xs:string
Resultado de la autenticacin para comercios Webpay Plus y/o 3D Secure, los valores posibles son los siguientes:
TSY : Autenticacin exitosa
TSN : Autenticacin fallida.
VCI TO*7 : Tiempo mximo excedido para autenticacin.
ABO : Autenticacin abortada por tarjetahabiente.
U3 : Error interno en la autenticacin.
Puede ser vaco si la transaccin no se autentic.
Largo mximo: 3
xs:string
urlRedirection URL de redireccin para visualizacin de voucher.
Largo mximo: 256
tns:wsTransactionDetailOutput
detailsOutput
detailsOutput Objeto que contiene el detalle de la transaccin financiera. Descrito ms adelante
TYPECARDDETAIL
Descripcin: Tipo de dato contiene detalles de la tarjeta de crdito.
CAMPO DESCRIPCIN
xs:string
4 ltimos nmeros de la tarjeta de crdito del tarjeta habiente.
cardNumber
Solo para comercios autorizados por Transbank se enva el nmero completo.
Largo mximo: 16
xs:string
(Opcional) Fecha de expiracin de la tarjeta de crdito del tarjetahabiente. Formato YYMM
cardExpirationDate
Solo para comercios autorizados por Transbank.
Largo mximo: 4
*7 VCI=TO indica que se produjo un time-out en el proceso de autenticacin bancaria. Esta transaccin no ser autorizada y seguir el flujo normal de eventos.
TYPEWSTRANSACTIONDETAILOUTPUT
Descripcin: Tipo de dato contiene el detalle del resultado de la transaccin.
CAMPO DESCRIPCIN
xs:string
authorizationCode Cdigo de autorizacin de la transaccin
Largo mximo: 6
xs:string
Tipo de pago de la transaccin.
VD = Venta Dbito
VN = Venta Normal
paymentTypeCode
VC = Venta en cuotas
SI = 3 cuotas sin inters
S2 = 2 cuotas sin inters
NC = N Cuotas sin inters
xs:string
Cdigo de respuesta de la autorizacin. Valores posibles:
0 Transaccin aprobada
-1 Rechazo de transaccin
-2 Transaccin debe reintentarse
responseCode -3 Error en transaccin
-4 Rechazo de transaccin
-5 Rechazo por error de tasa
-6 Excede cupo mximo mensual
-7 Excede lmite diario por transaccin
-8 Rubro no autorizado
xs:decimal
Amount Monto de la transaccin
Largo mximo: 10
xs:int
sharesNumber Cantidad de cuotas
Largo mximo: 2
xs:string
commerceCode Cdigo comercio de la tienda
Largo: 12
xs:string
buyOrder Orden de compra de la tienda.
Largo mximo: 26
Tienda
El Mall Webpay agrupa mltiples tiendas, son estas ltimas las Pago
virtual
$3.000
que pueden generar transacciones. Tanto el mall como las tiendas N
asociadas son identificadas a travs de un nmero denominado
cdigo de comercio. El flujo de pginas para la transaccin es el siguiente:
2 initTransaction()
4 Redirect(token...)
5 Request(token)
6 Formulario Webpay()
7 Pagar()
8 Autoriza()
9 Redirect()
10 Request(token)
11 getTransactionResult(token...)
12 Response()
13 acknowledge Transaction(token)
14 Redirection(token)
15 Request(token)
16 Comprobante Webpay()
17 Request(token)
18 Pagina final()
8.2.2 Descripcin de la secuencia 29. El sitio del comercio recibe la variable token_ws e invoca el
19. Una vez seleccionado los bienes o servicios, tarjetahabiente segundo mtodo Web, getTransactionResult () (mientras
decide pagar a travs de Webpay. se despliega la pgina de transicin*8), para obtener el *8
resultado de la autorizacin. Se recomienda que el resultado
20. El comercio inicia una transaccin en Webpay, invocando de la autorizacin sea persistida en los sistemas del comercio,
el mtodo initTransaction(). ya que este mtodo se puede invocar una nica vez por
transaccin.
21. Webpay procesa el requerimiento y entrega como
resultado de la operacin el token de la transaccin y 30. Webpay responde el resultado de la invocacin del mtodo
URL de redireccionamiento a la cual se deber redirigir al getTransactionResult().
tarjetahabiente.
31. Para informar a Webpay que el resultado de la transaccin
22. Comercio redirecciona al tarjetahabiente hacia Webpay, se ha recibido sin problemas, el sistema del comercio consume
con el token de la transaccin a la URL indicada en punto 3. La el tercer mtodo acknowledgeTransaction().
redireccin se realiza enviando por mtodo POST el token en
variable token_ws. NOTA: De no ser consumido demorar ms de 30 segundos
en su consumo, Webpay realizar la reversa de la transaccin,
23. El navegador Web del tarjetahabiente realiza una peticin asumiendo que existieron problemas de comunicacin.
HTTPS a Webpay, en base al redireccionamiento generado
por el comercio en el punto 4. 32. Una vez recibido el resultado de la transaccin e informado
a Webpay su correcta recepcin, el sitio del comercio debe
24. Webpay responde al requerimiento desplegando redirigir al tarjetahabiente nuevamente a Webpay, con la
el formulario de pago de Webpay. Desde este punto la finalidad de desplegar el comprobante de pago. Es importante
comunicacin es entre Webpay y el tarjetahabiente, sin interferir realizar este punto para que el tarjetahabiente entienda que
el comercio. El formulario de pago de Webpay despliega, entre el proceso de pago fue exitoso, y que involucrar un cargo a
otras cosas, el monto de la transaccin, informacin del mall su tarjeta bancaria. El redirecionamiento a Webpay se hace
como nombre y logotipo,nombre y monto por cada tienda, las utilizando como destino la URL informada por el mtodo
opciones de pago a travs de crdito o dbito. getTransactionResult() enviando por mtodo POST el
token de la transaccin en la variable token_ws.
25. Tarjetahabiente ingresa los datos de la tarjeta, hace clic en
pagar en formulario Webpay. 33. Webpay recibe un requerimiento con el token en la variable
token_ws valida que la transaccin se encuentre aprobada.
26. Webpay procesa la solicitud de autorizacin para cada uno
de los pagos de las tiendas. 34. Webpay identifica la transaccin y despliega el comprobante
de pago al tarjetahabiente.
27. Una vez resuelta la autorizacin de cada pago, Webpay
retorna el control al comercio, realizando un redireccionamiento 35. Una vez visualizado el comprobante de pago, el
HTTP/HTTPS hacia el sitio del comercio, en donde se enva tarjetahabiente es redirigido de vuelta al sitio del comercio,
por mtodo POST el token de la transaccin en la variable por medio de redireccionamiento con el token en la variable
token_ws. token_ws enviada por mtodo POS, hacia la pgina final
informada por el comercio en el mtodo initTransaction().
28. El navegador Web del tarjetahabiente realiza una peticin
HTTP/HTTPS al sitio del comercio, en base a la redireccin 36. Sitio del comercio despliega pgina final de pago*9. *9
generada por Webpay en el punto 9.
2 initTransaction()
4 Redirect(token...)
5 Request(token)
6 Formulario Webpay()
7 Anular()
8 Redirect()
9 Request(token)
10 Pagina final()
Ilustracin 7: Diagrama de secuencia de pago en una transaccin mall normal anulada en formulario de pago
8.3.1 Descripcin de secuencia alternativa, anular: despliega la pgina de transicin*10), para obtener el resultado *10
2. Pasos de 1 a 6 son idnticos a la secuencia normal. de la autorizacin. En este caso debe obtener una excepcin,
pues el pago fue abortado.
11. Tarjetahabiente hace clic en anular, en formulario Webpay.
14. El comercio debe informar al tarjeta habiente que su pago
12. Webpay retorna el control al comercio, realizando un no se complet, segn anexo glosa transaccin no autorizada.
redireccionamiento HTTP/HTTPS hacia la pgina de final del
comercio, en donde se enva por mtodo POST el token de la 8.4 Flujo Alternativo: Secuencia de pago en una transaccin
transaccin en la variable TBK_TOKEN. mall normal con evento de timeout
2 initTransaction()
4 Redirect(token...)
5 Request(token)
6 Formulario Webpay()
7 Timeout()
8.4.2 Descripcin de secuencia alternativa, timeout: 8.5 Descripcin de mtodos del Servicio Web de Transaccin
2. Pasos de 1 a 6 son idnticos a la secuencia normal. de Autorizacin Mall Normal
9. Tarjetahabiente est en formulario Webpay, pero no presiona A continuacin, se describen cada uno de las operaciones que
pagar durante 10 minutos. Esto causa un timeout en dicho deben ser utilizadas en una Transaccin Mall Normal.
formulario.
8.5.1 Operacin initTransaction
10. Webpay genera un error de timeout, se presenta una Mtodo que permite iniciar una transaccin de pago Webpay.
pantalla indicando que ocurri un error. No se regresa
automticamente al comercio. 8.5.1.1 Parmetro de entrada
NOMBRE DESCRIPCIN
tns:wsTransactionType
WSTransactionType
Indica el tipo de transaccin, su valor debe ser siempre TR_NORMAL_WS
xs:string
sessionId (Opcional) Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin.
Largo mximo: 61
xs:anyURI
returnURL (Obligatorio) URL del comercio, a la cual Webpayredireccionar posterior al proceso de autorizacin.
Largo mximo: 256
xs:anyURI
finalURL (Obligatorio) URL del comercio a la cual Webpayredireccionar posterior al voucher de xito de Webpay.
Largo mximo 256
tns:wsTransactionDetail
(Obligatorio) Lista de objetos del tipo wsTransactionDetail, el cual contiene datos de la transaccin. Mxima
transactionDetails
cantidad de repeticiones es de 1 para este tipo de transaccin.
wsTransactionDetail est descrito ms adelante.
tns:wPMDetail
wPMDetail
(No se utiliza para Transaccin Normal) Este campo contiene la transaccin webpay mensual.
xs:string
(Obligatorio)Es el cdigo nico de identificacin del comercio entregado por Transbank.
commerceId En este caso el commerceID corresponde al cdigo asignado al PST (o cdigo mall), y que agrupa los cdigos de
comercio que recibirn los pagos.
Largo: 12
xs:string
buyOrder
(Obligatorio)Es el cdigo nico de la orden de compra generada por el comercio mall.
TYPE WSTRANSACTIONDETAIL
Descripcin: Tipo de dato contiene detalles de la transaccin
CAMPO DESCRIPCIN
xs:decimal
amount Monto de la transaccin. Mximo 2 decimales para USD.
Largo mximo: 10
xs:string
Orden de compra de la tienda.*11
buyOrder
Largo mximo: 26
La orden de compra puede tener: Nmeros, letras, maysculas y minsculas, y los signos |_=&%.,~:/?[+!@()>-
xs:string
commerceCode Cdigo comercio de la tienda entregado por Transbank.
Largo: 12
sharesAmount Campo no utilizado
sharesNumber Campo no utilizado
CAMPO DESCRIPCIN
xs:string
buyOrder Orden de compra del mall.
Largo mximo: 26
xs:string
sessionId
Identificador de sesin, uso interno de comercio, este valor es devuelto al final de la transaccin. Largo mximo: 61
Tns:carddetails
cardDetails
Objeto que representa los datos de la tarjeta de crdito del tarjetahabiente. cardDetails descrito ms adelante.
xs:string
accoutingDate Fecha de la autorizacin.
Largo: 4, formato MMDD
xs:string
transactionDate Fecha y hora de la autorizacin.
Largo: 6, formato: MMDDHHmm
xs:string
Resultado de la autenticacin para comercios Webpay Plus y/o 3D Secure, los valores posibles son los siguientes:
TSY : Autenticacin exitosa
TSN : Autenticacin fallida.
VCI TO*12 : Tiempo mximo excedido para autenticacin.
ABO : Autenticacin abortada por tarjetahabiente.
U3 : Error interno en la autenticacin.
Puede ser vaco si la transaccin no se autentic.
Largo mximo: 3
xs:string
urlRedirection URL de redireccin para visualizacin de voucher.
Largo mximo: 256
tns:wsTransactionDetailOutput
detailsOutput
detailsOutput Objeto que contiene el detalle de la transaccin financiera. Descrito ms adelante
TYPECARDDETAIL
Descripcin: Tipo de dato contiene detalles de la tarjeta de crdito.
CAMPO DESCRIPCIN
xs:string
4 ltimos nmeros de la tarjeta de crdito del tarjeta habiente.
cardNumber
Solo para comercios autorizados por Transbank se enva el nmero completo. La fecha de expiracin llegara nula.
Largo mximo: 16
xs:string
(Opcional) Fecha de expiracin de la tarjeta de crdito del tarjetahabiente. Formato YYMM
cardExpirationDate
Solo para comercios autorizados por Transbank.
Largo mximo: 4
*12 VCI=TO indica que se produjo un time-out en el proceso de autenticacin bancaria. Esta transaccin no ser autorizada y seguir el flujo normal de eventos.
TYPEWSTRANSACTIONDETAILOUTPUT
Descripcin: Tipo de dato contiene el detalle del resultado de la transaccin.
CAMPO DESCRIPCIN
xs:string
authorizationCode Cdigo de autorizacin de la transaccin
Largo mximo: 6
xs:string
Tipo de pago de la transaccin.
VD = Venta Dbito
VN = Venta Normal
paymentTypeCode
VC = Venta en cuotas
SI = 3 cuotas sin inters
S2 = 2 cuotas sin inters
NC = N Cuotas sin inters
xs:string
Cdigo de respuesta de la autorizacin. Valores posibles:
0 Transaccin aprobada
-1 Rechazo de transaccin
-2 Transaccin debe reintentarse
responseCode -3 Error en transaccin
-4 Rechazo de transaccin
-5 Rechazo por error de tasa
-6 Excede cupo mximo mensual
-7 Excede lmite diario por transaccin
-8 Rubro no autorizado
xs:decimal
Amount Monto de la transaccin
Largo mximo: 10
xs:int
sharesNumber Cantidad de cuotas
Largo mximo: 2
xs:string
commerceCode Cdigo comercio de la tienda
Largo: 12
xs:string
buyOrder Orden de compra del mall.
Largo mximo: 26
9 TRANSACCIN ONECLICK
Retorna el identificador del usuario en OneClick, el cual ser utilizado para realizar las transacciones de pago.
finishInscription
Una vez terminado el flujo de inscripcin en Transbank el usuario es enviado a la URL de fin de inscripcin que
defini el comercio. En ese instante el comercio debe llamar a finishInscription.
Permite realizar transacciones de pago. Retorna el resultado de la autorizacin. Este mtodo que debe ser
authorize
ejecutado, cada vez que el usuario selecciona pagar con OneClick.
Permite reversar una transaccin de venta autorizada con anterioridad. Este mtodo retorna como respuesta un
codeReverseOneClick
identificador nico de la transaccin de reversa.
9.3 Inscripcin en Oneclick El comercio enva el browser del cliente a la URL obtenida y
9.3.1 Descripcin pasa por parmetro el token (mtodo POST).
La inscripcin es el proceso en el cual el tarjetahabiente registra
los datos de su tarjeta en Webpay OneClick para usarlo en Webpay presenta el formulario de inscripcin, este es similar al
compras futuras. Estos datos son almacenados de forma segura formulario de pago actual de Webpay Plus, para que el cliente
en Transbank, y nunca son conocidos por el comercio. ingrese los datos de su tarjeta.
Este proceso debe ser iniciado por la tienda del comercio y es El cliente ser autenticado por su banco emisor, de forma similar
requisito que el cliente est autenticado en la pgina del comercio al flujo normal de pago. En este punto se realiza una transaccin
antes de iniciar la inscripcin. de $1 peso, la cual no se captura (no se ver reflejada en su
estado de cuenta).
Proceso:
El cliente se conecta y autentica en la pgina del comercio, Finalizada la inscripcin, Webpay enva el browser del
mediante su nombre de usuario y clave. cliente a la URL entregada por el comercio, pasando por
parmetro el token.
El cliente selecciona la opcin de inscripcin, la cual debe estar
explicada en la pgina del comercio. El comercio debe consumir otro servicio web de Transbank,
con el token, para obtener el resultado de la inscripcin y el
El comercio consume un servicio web publicado por Transbank, identificador de usuario, que debe utilizar en el futuro para
donde entrega los datos del cliente y la URL de trmino; obtiene realizar los pagos.
un token y URL de Webpay.
El comercio presenta al cliente el resultado de la inscripcin.
9.3.2 Diagrama
Inscripcin
Selecciona
Inscripcin Login comercio
username/email
Token initInscription
Token
Pantalla
ingreso de
datos tarjeta Datos tarjeta
Token banco
Pantalla
autenticacin
del banco username y password
Token banco
Token
Token
finishInscription
user_tbk_id
Comercio
presenta
resultado
Proceso:
El cliente se conecta y autentica en la pgina o aplicacin del
comercio mediante su nombre de usuario y clave.
Una vez que se llama a este webservice el usuario debe ser
redireccionado va POST a urlWebpay con parmetro TBK_TOKEN
igual al token. El cliente selecciona la opcin de pagar con Webpay Oneclick.
Mtodo Web Service El comercio, en caso de requerir reversar un pago, debe consumir
un servicio web publicado por Transbank con el identificador del
authorize Permite autorizar un pago.
pago entregado en la respuesta de la autorizacin de la transaccin.
{username}, {id usuario Transbank}, {monto},
{orden de compra}.
String (255) Mtodo Web Service
Recibe
String (255) Permite reversar una venta y se obtiene
Number (19,2) codeReverseOneClick el resultado de la reversa y un cdigo de
String (255) reversa en caso que esta sea exitosa.
{cdigo de respuesta}, {cdigo de autorizacin}, {orden de compra}
}, {marca de tarjeta}, Recibe
Retorna Orden de compra: Long
{ltimos 4 dgitos}, {id de la transaccin}
Codigo de respuesta : Number (10,0) {reverseCode} {reversed}
Retorna reverseCode: Long
reversed: boolean (true/false)
9.6 Reversa de pagos autorizados
Este proceso permite reversar una venta cuando esta no pudo
El cdigo regresado por este mtodo, es un identificador nico de
concretarse, dentro del mismo da contable, con la finalidad de
la transaccin de reversa.
anular un cargo realizado al cliente.
finishInscription
INPUT
token Identificador del proceso de inscripcin, entregado por Webpay en el mtodo initInscription
OUTPUT
responseCode Cdigo de retorno del proceso de inscripcin, donde 0 (cero) es aprobado.
authCode Cdigo que identifica la autorizacin de la inscripcin.
creditCardType Indica el tipo de tarjeta que fue inscrita por el cliente ( Visa, AmericanExpress, MasterCard, Diners, Magna).
last4CardDigits Los ltimos 4 dgitos de la tarjeta ingresada por el cliente en la inscripcin.
tbkUser Identificador nico de la inscripcin del cliente, este debe ser usado para realizar pagos, o borrar la inscripcin.
authorize
INPUT
removeUser
INPUT
10.1 Descripcin de la captura diferida con autorizacin sin captura y el monto requerido para capturar el
Este mtodo permite a todo comercio habilitado realizar capturas de cual debe ser menor o igual al monto originalmente autorizado.
una transaccin autorizada sin captura en plataforma Webpay 3G.
El mtodo contempla una nica captura por cada autorizacin. Para Las ejecuciones con errores entregarn un SoapFault de acuerdo
ello se deber indicar los datos asociados a la transaccin de venta a la codificacin de errores definida.
PARMETROS DE ENTRADA
CAMPO DESCRIPCIN
xs:string
authorizationCode Cdigo de autorizacin de la transaccin que se requiere capturar
Largo mximo: 6
xs:string
buyOrder Orden de compra de la transaccin que se requiere capturar
Largo mximo: 26
xs:long
commerceId Cdigo de comercio o tienda mall que realiz la transaccin
Largo: 12
xs:decimal
captureAmount Monto que se desea capturar
Largo mximo: 10
PARMETROS DE SALIDA
CAMPO DESCRIPCIN
xs:string
token
Token de la transaccin
xs:string
authorizationCode
Cdigo de autorizacin de la captura diferida
xs:dateTime
authorizationDate
Fecha y hora de la autorizacin
xs:decimal
captureAmount
Monto capturado
CDIGO DESCRIPCIN
304 Validacin de campos de entrada nulos
245 Cdigo de comercio no existe
22 El comercio no se encuentra activo
316 El comercio indicado no corresponde al certificado o no es hijo del comercio MALL en caso de transacciones MALL
308 Operacin no permitida
274 Transaccin no encontrada
16 La transaccin no es de captura diferida
292 La transaccin no est autorizada
284 Periodo de captura excedido
310 Transaccin reversada previamente
309 Transaccin capturada previamente
311 Monto a capturar excede el monto autorizado
315 Error del autorizador
11 TRANSACCIN DE ANULACIN
11.2 Descripcin del mtodo del servicio web de anulacin de 10.2.1 Operacin nullify
transacciones Mtodo que permite anular una transaccin de pago Webpay.
PARMETROS DE ENTRADA
CAMPO DESCRIPCIN
xs:string
Cdigo de autorizacin de la transaccin que se requiere anular. Para el caso que se est anulando una transaccin
authorizationCode
de captura en lnea, este cdigo corresponde al cdigo de autorizacin de la captura.
Largo mximo: 6
xs:decimal
Monto autorizado de la transaccin que se requiere anular. Para el caso que se est anulando una transaccin de
authorizedAmount
captura en lnea, este monto corresponde al monto de la captura.
Largo mximo: 10
xs:string
buyOrder Orden de compra de la transaccin que se requiere anular
Largo mximo: 26
xs:long
commerceId Cdigo de comercio o tienda mall que realiz la transaccin
Largo: 12
xs:decimal
ullifyAmount Monto que se desea anular de la transaccin
Largo mximo: 10
PARMETROS DE SALIDA
CAMPO DESCRIPCIN
xs:string
token
Token de la transaccin
xs:string
authorizationCode
Cdigo de autorizacin de la anulacin
xs:dateTime
authorizationDate
Fecha y hora de la autorizacin
xs:decimal
Balance
Saldo actualizado de la transaccin (considera la venta menos el monto anulado)
xs:decimal
nullifiedAmount
Monto anulado
CDIGO DESCRIPCIN
304 Validacin de campos de entrada nulos
245 Cdigo de comercio no existe
22 El comercio no se encuentra activo
316 El comercio indicado no corresponde al certificado o no es hijo del comercio MALL en caso de transacciones MALL
308 Operacin no permitida
274 Transaccin no encontrada
16 La transaccin no permite anulacin
292 La transaccin no est autorizada
284 Periodo de anulacin excedido
310 Transaccin anulada previamente
311 Monto a anular excede el saldo disponible para anular
312 Error genrico para anulaciones
315 Error del autorizador
12 ANEXOS
Le solicitar ingresar los siguientes datos, teniendo especial Lo que generar un archivo llamado 59702012345678.csr
cuidado en ingresar el cdigo de comercio productivo, ya
entregado por Transbank, en el campo Common Name (CN)
como sigue:
3. Crear certificado autofirmado pblico utilizando el siguiente comando, procurando indicar 1460
on la llave privada y el CSR creados, debe crear el certificado das o ms, para la duracin de la validez del certificado
openssl x509 -req -days 1460 -in 597029124456.csr -signkey 597029124456.key -out 597012345678.crt
https://webpay3gint.transbank.cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl
Certificado pblico Webpay integracin
-----BEGIN CERTIFICATE-----
MIIDKTCCAhECBFZl7uIwDQYJKoZIhvcNAQEFBQAwWTELMAkGA1UEBhMCQ0wxDjAMBgNVBAgMBUNo
aWxlMREwDwYDVQQHDAhTYW50aWFnbzEMMAoGA1UECgwDa2R1MQwwCgYDVQQLDANrZHUxCzAJBgNV
BAMMAjEwMB4XDTE1MTIwNzIwNDEwNloXDTE4MDkwMjIwNDEwNlowWTELMAkGA1UEBhMCQ0wxDjAM
BgNVBAgMBUNoaWxlMREwDwYDVQQHDAhTYW50aWFnbzEMMAoGA1UECgwDa2R1MQwwCgYDVQQLDANr
ZHUxCzAJBgNVBAMMAjEwMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAizJUWTDC7nfP
3jmZpWXFdG9oKyBrU0Bdl6fKif9a1GrwevThsU5Dq3wiRfYvomStNjFDYFXOs9pRIxqX2AWDybjA
X/+bdDTVbM+xXllA9stJY8s7hxAvwwO7IEuOmYDpmLKP7J+4KkNH7yxsKZyLL9trG3iSjV6Y6SO5
EEhUsdxoJFAow/h7qizJW0kOaWRcljf7kpqJAL3AadIuqV+hlf+Ts/64aMsfSJJA6xdbdp9ddgVF
oqUl1M8vpmd4glxlSrYmEkbYwdI9uF2d6bAeaneBPJFZr6KQqlbbrVyeJZqmMlEPy0qPco1TIxrd
EHlXgIFJLyyMRAyjX9i4l70xjwIDAQABMA0GCSqGSIb3DQEBBQUAA4IBAQBn3tUPS6e2USgMrPKp
sxU4OTfW64+mfD6QrVeBOh81f6aGHa67sMJn8FE/cG6jrUmX/FP1/Cpbpvkm5UUlFKpgaFfHv+Kg
CpEvgcRIv/OeIi6Jbuu3NrPdGPwzYkzlOQnmgio5RGb6GSs+OQ0mUWZ9J1+YtdZc+xTga0x7nsCT
5xNcUXsZKhyjoKhXtxJm3eyB3ysLNyuL/RHy/EyNEWiUhvt1SIePnW+Y4/cjQWYwNqSqMzTSW9TP
2QR2bX/W2H6ktRcLsgBK9mq7lE36p3q6c9DtZJE+xfA4NGCYWM9hd8pbusnoNO7AFxJZOuuvLZI7
JvD7YLhPvCYKry7N6x3l
-----END CERTIFICATE-----
Endpoint Produccin
https://webpay3g.transbank.cl/WSWebpayTransaction/cxf/WSWebpayService?wsdl
-----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-----
Es recomendable que en esta pgina muestre la imagen de 12.2.3 Requerimientos Pgina final de fracaso
background del formulario de pago, que se encuentra en la URL Cuando la transaccin no sea autorizada, se recomienda
informar al tarjetahabiente al respecto. Puede presentar un texto
https://webpay3g.transbank.cl/ explicativo como:
webpayserver/imagenes/background.gif
# 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
# 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
# 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
# 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
12.4.2 Pruebas de validacin para Transaccin Normal 12.4.4 Pruebas de validacin para Transaccin Mall
Pago crdito exitoso sin cuotas Pago crdito exitoso sin cuotas
Pago crdito exitoso con cuotas Pago crdito exitoso con cuotas
Pago crdito denegado Pago crdito denegado
Pago dbito exitoso Pago dbito exitoso
Pago dbito denegado Pago dbito denegado
Anulacin parcial (solo si integra el mtodo) Anulacin parcial (solo si integra el mtodo)
Anulacin total (solo si integra el mtodo) Anulacin total (solo si integra el mtodo)
Pago cancelado (abortado en formulario Webpay) Pago cancelado (abortado en formulario Webpay)
12.4.5 Pruebas de validacin para Transaccin OneClick
Inscripcin rechazada
Inscripcin exitosa
Autorizacin
Reversa
Remover usuario
https://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-os-SOAPMessageSecurity.pdf