Versin N: 1
INFORMACIN TCNICA
SOBRE
COMERCIO ELECTRNICO
SEGURO VISAFORMULARIO
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 1 de 17
SGC_ANE19
Versin N: 1
INDICE
1.
DEFINICIONES ...................................................................................................................... 3
2.
3.
2.1.1.
2.1.2.
2.1.3.
ANEXOS .............................................................................................................................. 13
3.1.
3.1.1.
CDIGOS ECI.............................................................................................................. 13
3.1.2.
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 2 de 17
SGC_ANE19
Versin N: 1
1. Definiciones
Para efectos del presente documento se consideran los siguientes trminos:
Longitud
Descripcin
CANAL
PRODUCTO
CODTIENDA
NUMORDEN
MOUNT
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 3 de 17
SGC_ANE19
Versin N: 1
A continuacin se muestran los parmetros que podrn ser enviados por el comercio
obtenindolos de su base de datos1.
Parmetro
Longitud
Descripcin
NOMBRE
200
APELLIDO
200
CORREO
100
DIRECCIN
200
CIUDAD
100
Los comercios afiliados bajo la modalidad de PSP debern enviar los siguientes parmetros:
Parmetro
Longitud
CODASOCIADO
NOMBREASOCIADO
MCC
17
4
Descripcin
Cdigo del comercio asociado que es
asignado por el PSP.
Nombre del comercio asociado.
MCC del comercio asociado.
Longitud
DATO_COMERCIO
100
Descripcin
Datos opcionales que el comercio puede
enviar. Estos se incluirn, sin modificaciones,
en el XML de respuesta.
Estos campos se enviarn como parmetros al Web Service contenidos en una cadena XML
con el siguiente formato:
Se debe tener en consideracin que si el comercio enva estos campos, obtenindolos de su base de
datos, el tarjetahabiente no podr modificarlos en el formulario de pagos. No obstante, se agilizar el
proceso compra ya que se reducir la cantidad de campos a ser completados por el tarjetahabiente.
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 4 de 17
SGC_ANE19
Versin N: 1
<parametro id="DATO_COMERCIO">String</parametro>
</parametros>
</nuevo_eticket>
B. XML de generacin de e-Ticket.
El Web Service retornar un XML de respuesta, en el que estar incluido el valor de e-Ticket
generado.
El XML de respuesta tendr el siguiente formato:
</registro>
</mensajes/>
</eticket>
Dentro de la trama se identifican los siguientes nodos y sub-nodos:
1. Registro: Agrupa los campos del e-Ticket generado.
2. Campo: Que indicar los valores enviados como parmetros de respuesta. Puede tener
los siguientes IDs:
Parmetro
Longitud
Descripcin
CODTIENDA
NUMORDEN
ETICKET
30
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 5 de 17
SGC_ANE19
Versin N: 1
Longitud
Descripcin
30
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 6 de 17
SGC_ANE19
Versin N: 1
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 7 de 17
SGC_ANE19
Versin N: 1
La pasarela de pagos (POS Multimerchant) mostrar al usuario una pantalla informando que la
transaccin est siendo procesada, la pantalla ser la siguiente:
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 8 de 17
SGC_ANE19
Versin N: 1
Longitud
30
Descripcin
Valor del e-Ticket de la transaccin de pago procesada.
El parmetro es retornado a travs de HTTP POST y slo indica el fin del proceso de la
transaccin. No indican el resultado de la misma (aprobacin, denegacin, etc.).
Para conocer el resultado del proceso de pagos, el comercio deber realizar la consulta de
resultado del pedido (Etapa 3: Consulta del resultado de la transaccin).
SGC_ANE19
Versin N: 1
</parametros>
</consulta_eticket>
Longitud
CODTIENDA
ETICKET
30
Descripcin
Cdigo que se le asign al comercio al afiliarse a comercio
electrnico.
Valor de e-Ticket que se gener al inicio de la transaccin. Es
nico por transaccin.
El Web Service responder un XML que contiene el resultado de todas las operaciones
asociadas a este e-Ticket.
El formato del XML de respuesta es el siguiente:
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 10 de 17
SGC_ANE19
Versin N: 1
</operacion>
</pedido>
</mensajes/>
</respuesta_eticket>
1. Pedido: Agrupa los datos del pedido y sus operaciones . Tiene como valor de ID el
nmero de pedido y como valor el e-Ticket (el mismo que se envi en el XML de
consulta)
2. Operacin: Se tendr un nodo operacion para cada operacin que se haya realizado
con este nmero de pedido. La operacin tendr un ID, que es un correlativo asignado
por la pasarela de pagos. Se debe tener en cuenta que, como cada nmero pedido
debe ser nico, todas las operaciones posteriores a la primera, sern denegadas con
cdigo de accin 300 (Nmero de pedido duplicado). La operacin tiene una serie de
sub-nodos que estn contenidos bajo el mismo tag campo:
a. Campo: Indicar los valores enviados como parmetros de respuesta. Puede
tener los siguientes IDs:
Parmetro
Longitud
Respuesta
cod_tienda
nordent
cod_accion
Pan
19
Eci
cod_autoriza
ori_tarjeta
6
1
nom_emisor
50
dsc_eci
cod_rescvv2
imp_autorizado
50
1
fechayhora_tx
19
Descripcin
Tiene los siguientes valores:
1: Aprobada
2: Denegada
Cdigo de tienda que ser entregado por POS
Multimerchant.
Nmero de orden de la tienda.
Cdigo de denegacin. La descripcin del parmetro
cod_accion se detalla en el Anexo 2.
Nmero de tarjeta Visa. Est enmascarado, solamente
muestra los 6 primeros dgitos y los 4 ltimos:
456585******1001.
Electronic Commerce Indicator. Indica el resultado de la
autenticacin con Verified by Visa.
Cdigo de autorizacin
Indicador si es tarjeta fornea:
1. N= Tarjeta Nacional.
2. I= Tarjeta Internacional.
3. S= No determinado.
Nombre de la entidad emisora de la tarjeta. Solamente
en caso que la tarjeta sea nacional.
Descripcin del campo ECI
Resultado de validacin del CVV2
Importe autorizado
Formato: #####.##
El smbolo decimal es el punto y debe incluir
2 valores decimales.
Fecha y hora de la transaccin
Formato: DD/MM/YYYY hh:mm:ss
SGC_ANE19
19
fechayhora_devolucion
19
Versin N: 1
3. Mensajes: Agrupa los mensajes que se puedan generar cuando se consulta un e-Ticket.
4. Mensaje: Este nodo permitir la inclusin de mensajes hacia el comercio, por algn tipo de
error que se haya generado. Cada mensaje tendr un ID nico y siempre se debe revisar
si se ha enviado algn mensaje.
Se debe tener en consideracin que estos parmetros son los que se envan a la fecha de
redaccin de este documento. Siendo tramas XML, se puede incrementar el nmero de
parmetros de respuesta, de acuerdo a las mejoras que se vayan implementando en la
pasarela de pagos, las cuales se informarn oportunamente. Buscar actualizaciones en:
http://www.visanet.com.pe/comercio_electronico/
En la seccin de mensajes, se notificarn errores que se pueden haber producido durante el
procesamiento o la invocacin al Web Service.
Los posibles mensajes son:
Validaciones de XML
El comercio ejecuta el Web
Service desde un numero IP
no configurado
El comercio enva formato
incorrecto del XML
El comercio No enva el
"CODTIENDA" como campo
del XML
El comercio No enva el
"ETICKET" como campo del
XML
Mensaje
El IP xxx.xxx.xx.x no est autorizado
para el comercio yyyyyy
Respuesta al comercio
XML de respuesta
XML de respuesta
XML de respuesta
XML de respuesta
Validaciones de Negocio
Si falla el al intentar obtener
los parmetros de respuesta
del pedido.
Si el campo CODTIENDA no
se encuentra registrado en la
base de datos
Si el nmero de ETICKET no
se encuentra registrado en la
base de datos
Mensaje
Respuesta al comercio
Error de comunicacin
XML de respuesta
CODTIENDA no se encuentra
registrado
XML de respuesta
XML de respuesta
Nota. El Web Service estar disponible para que sea invocado por el comercio no slo al
terminar el proceso de pago, sino tambin cuando lo considere necesario, como por ejemplo,
para validar una transaccin sin respuesta por time out.
El comercio debe validar por lo menos los siguientes parmetros antes de dar una compra
como aprobada y atender el pedido:
respuesta: Deber tener el valor 1.
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 12 de 17
SGC_ANE19
Versin N: 1
3. Anexos
3.1. Cdigos de Accin
3.1.1. Cdigos ECI
Cdigos retornados en el proceso de autenticacin. Sus valores significan:
ECI
5
6
7
10
11
12
101
102
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 13 de 17
SGC_ANE19
104
Operacin
Denegada.
Operacin
permitida para esta tarjeta.
106
107
108
109
110
Operacin
Denegada.
Operacin
permitida para esta tarjeta.
111
112
no
no
116
117
Operacin
incorrecta.
118
119
121
126
Denegada.
Operacin Denegada.
Operacin
Denegada.
invlida.
Clave
Clave
secreta
secreta
129
180
181
Operacin
Denegada.
restricciones de Dbito.
Tarjeta
con
182
Operacin
Denegada.
restricciones de Crdito.
Tarjeta
con
183
199
201
202
190
191
192
Versin N: 1
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 14 de 17
SGC_ANE19
204
Operacin
Denegada.
Operacin
permitida para esta tarjeta.
206
207
208
209
263
264
no
265
266
280
290
300
306
401
402
Operacin Denegada.
Operacin
Denegada.
Tarjeta
no
autenticada
Operacin Denegada. El monto de la
transaccin supera el valor mximo
permitido.
Operacin Denegada. La tarjeta ha
superado
la
cantidad
mxima
de
transacciones en el da.
Operacin Denegada. La tienda ha
superado
la
cantidad
mxima
de
transacciones en el da.
Operacin Denegada. El monto de la
transaccin no llega al mnimo permitido.
403
404
405
406
407
408
409
410
411
Versin N: 1
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 15 de 17
SGC_ANE19
412
414
415
416
417
418
419
420
421
422
413
423
424
666
667
668
Operacin Denegada.
669
670
904
909
910
912
913
916
928
940
941
942
943
945
946
947
Versin N: 1
emisora de la tarjeta
Operacin Denegada. Cdigo de
seguridad no reconocido por la entidad
emisora de la tarjeta
Operacin Denegada. Contactar con
entidad emisora de su tarjeta.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada. Tarjeta no es
VISA.
Operacin Denegada. Contactar con
entidad emisora de su tarjeta.
Operacin Denegada. El comercio no
est configurado para usar este medio
de pago. Contactar con el comercio.
Operacin Denegada. Se cancel el
proceso de pago.
Operacin Denegada.
Operacin Denegada. Problemas de
comunicacin. Intente ms tarde.
Operacin Denegada. Transaccin sin
respuesta de Verified by Visa.
Operacin Denegada. Contactar con el
comercio.
Operacin Denegada. Contactar con el
comercio.
Operacin Denegada. Contactar con el
comercio.
Operacin Denegada.
Operacin Denegada. Problemas de
comunicacin. Intente ms tarde.
Operacin Denegada.
Operacin Denegada. Entidad emisora
de la tarjeta no disponible
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Operacin Denegada. Operacin de
anulacin en proceso.
Operacin Denegada. Problemas de
comunicacin. Intente ms tarde.
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 16 de 17
SGC_ANE19
Versin N: 1
Operacin Denegada.
Operacin Denegada.
Operacin Denegada.
Propiedad de Compaa Peruana de Medios de Pago S.A.C. - Prohibida cualquier reproduccin, distribucin o comunicacin para otros fines,
salvo autorizacin expresa de Visanet Per.
Pgina 17 de 17
SGC_ANE19