Tpvguia Cyberpac Caixa - Esp

Cyberpac Gua de uso del comercio
Marzo 2003
9736 Gestin y Desarrollo de Banca Electrnica
Contenido
Contenido ................................................................................................................................................ 2 1. Introduccin ......................................................................................................................................... 3 2. Contratacin y alta de su comercio en el Cyberpac ........................................................................... 5 3. Caractersticas del Cyberpac .............................................................................................................. 6 3.1. Tipos de pago ................................................................................................................................ 6 3.2. Notificacin del pago ...................................................................................................................... 7 3.3. Solicitud de notificacin de pago ................................................................................................... 8 4. Instalacin ......................................................................................................................................... 10 4.1. Instalacin en Windows NT ......................................................................................................... 10 4.2. Instalacin en UNIX ..................................................................................................................... 10 4.3. Parmetros de instalacin ........................................................................................................... 11 4.4. Reinstalacin y desinstalacin ..................................................................................................... 12 4.5. Contenido de la instalacin .......................................................................................................... 13 4.6. CrURLtpv ..................................................................................................................................... 14 4.6.1. Formulario de datos del comprador ........................................................................................ 16 4.6.2. Preautorizaciones .................................................................................................................... 18 4.6.3 Ejemplos de llamada al CrURLtpv ........................................................................................... 18 4.7. CheckNOTtpv: Verificacin de la notificacin HTTP ................................................................... 21 5. Configuracin de su comercio en el repositorio ................................................................................ 23 5.1. Modificar datos del comercio ....................................................................................................... 24 5.2. Modificar datos de usuario ........................................................................................................... 26 5.3. Gestin de usuarios ..................................................................................................................... 26 5.4. Consulta/Devoluciones de pagos ................................................................................................ 27 5.4.1. Devoluciones ........................................................................................................................... 28 5.5. Introduccin manual de pagos ..................................................................................................... 29 5.6. Gestin de pagos preautorizados ................................................................................................ 29 6. Paso a Produccin ............................................................................................................................ 31 7. Resolucin de problemas.................................................................................................................. 32 Apndice 1: Errores devueltos por el Cyberpac ................................................................................... 34 ERRORES QUE PROVIENEN DE SIS ................................................................................................ 41 Apndice 2: Ejemplos vlidos de integracin de la llamada al Cyberpac ............................................ 42
1. Introduccin
Con el Cyberpac de la Caixa cualquier comercio virtual autorizado puede generar, desde sus pginas de venta de productos o servicios, enlaces a la pasarela de pago de la Caixa. Cuando el comprador adquiere los productos o servicios ofertados en la web del comercio, mediante el botn de pago se establece conexin segura, en SSL3 de 128 bits, con el Cyberpac. El servidor del comercio no tiene porque estar en servidor seguro. S lo estn las pginas de pago del Cyberpac de la Caixa. El comprador puede pagar los productos utilizando cualquiera de los medios de pago para los que el comercio haya sido configurado: tarjetas, transferencias, domiciliaciones y contrareembolso. El Cyberpac verifica, entre otros datos, la autenticidad de la entidad, el saldo y el estado de la tarjeta. Para formalizar la entrega, el comercio puede solicitar los datos del comprador en un formulario de su web, o bien, indicar que se pidan en el Cyberpac. De esta forma, no es necesario que el comercio tenga un formulario de solicitud propia, y consulte los datos para el envo del producto desde la aplicacin de gestin del Cyberpac. Los detalles de la operacin relativos a los datos de pago del comprador (nmero de tarjeta, fecha de caducidad, nmero secreto, etc.), no son visibles desde el Cyberpac por el comercio. Del mismo modo, la Caixa desconoce cules son los productos adquiridos y, dependiendo de la opcin escogida, los datos personales del comprador, la direccin de entrega o cualquier otro dato requerido por el comercio para formalizar la compra. En las pginas del Cyberpac se visualiza el nombre y logo de la entidad, el nmero de pedido a procesar, el importe y la divisa del pago. Si el cliente confirma el pago, la orden es enviada a "la Caixa" para realizar el cargo en la cuenta del comprador y el ingreso correspondiente en la del comercio. El cliente recibir un E-Mail de confirmacin del pago, en el caso que nos lo solicite, y ser informado del resultado de la operacin mediante una pgina html. Finalmente, el cliente sigue la navegacin por las pginas del comercio. Es posible, para el comerciante, indicar pginas de retorno diferentes, dependiendo de que el pago se haya realizado correctamente, haya acabado con algn error o haya sido cancelado por el comprador. El comercio puede recibir informacin online va E-Mail y/o va HTTP de cada pago efectuado, recibirla en E-Mail de resumen diario o acceder, en cualquier momento, al men de administracin de la aplicacin en Internet para consultar el detalle de las operaciones. El Cyberpac permite realizar devoluciones totales o parciales, del importe de la compra realizada por un cliente a travs de la opcin de Tarjeta, Transferencias o Domiciliaciones, desde la propia aplicacin de gestin del Cyberpac.
El Cyberpac ofrece la opcin al comprador de fraccionar el pago en la pgina de peticin del PIN de la tarjeta. En el caso de que el cliente seleccione una de las opciones de fraccionamiento (pago en 3, 6 o 12 meses), por defecto el cargo correr por su cuenta, con un 1,39% mensual con un TAE del 18%). El comercio, si lo desea, puede elegir que el cargo de estos intereses corran a su cuenta, para ello deber solicitarlo en su oficina. La opcin de fraccionamiento slo est disponible en el caso de que el comprador introduzca una tarjeta de crdito de la Caixa. Mediante el Cyberpac se podrn realizar pedidos en los que el comercio, en el momento de la compra, no puede dar a su cliente un importe definitivo exacto del mismo. Por ello, el comercio podr realizar pedidos con preautorizaciones en las que el importe final lo introducir directamente el comercio. Estos pedidos nicamente podran ser efectuados mediante Tarjeta. Una vez el cliente haya introducido los datos de la tarjeta, se enva una transaccin segura al servidor de la Caixa para hacer una validacin de la misma, comprobando que la tarjeta no est bloqueada, sin llegar a realizarse el cobro del compra al cliente. Cuando el comercio tiene el importe definitivo del pedido nos enva la segunda transaccin, que es la que se cargar al cliente. El Cyberpac soporta multiidioma (cataln, castellano e ingls) y multimoneda, aunque actualmente slo est operativa la moneda Euro, y no tiene incompatibilidad el resto de pasarelas de pago por Internet de otras entidades.
Tambin existe la posibilidad de que el comercio introduzca manualmente los pagos en el Cyberpac, sin la necesidad que el comprador deba ir a realizar el pago a la pgina web del comercio. Esta opcin es la Introduccin manual de pagos o reentry (vea el apartado 6.5 Introduccin manual de pagos).
2. Contratacin y alta de su comercio en el Cyberpac
Le informamos que para obtener el software y copias del manual de instalacin del Cyberpac debes, en primer lugar, tener una cuenta abierta en la Caixa y, posteriormente, firmar un contrato de comercio con nuestra entidad. Las operaciones del Cyberpac de la Caixa realizadas con Tarjeta tienen el descuento correspondiente a la actividad comercial que realicen, sobre el importe de la operacin. Las condiciones econmicas se concretarn con la oficina de la Caixa con la que est vinculado. El comercio recibe, via mail, del administrador del Cyberpac un cdigo de usuario, una password y un identificador de comercio. La password puede ser modificada en cada conexin. Este usuario ser el utilizado para acceder a la aplicacin de administracin de su comercio en el Cyberpac. Esta aplicacin se encuentra en http://www.lacaixa.es/tpv.html El comercio es dado de alta en estado de TEST. Esto significa que el flujo de pago es aparentemente completo, pero no se procede al pago real en el servidor de la Caixa, sin que se efecta una simulacin del mismo. El objetivo es que usted pueda realizar las pruebas de integracin de su comercio en el Cyberpac. El abono de las liquidaciones al comercio respecto a los pagos con tarjeta se efecta segn la periodicidad acordada (diaria, semanal, quincenal o mensual) y, simultneamente se efecta el cargo de los descuentos correspondientes. El cargo de las operaciones del Cyberpac se abonan igual que con los TPV fsicos. El abono de las domiciliaciones se efecta despus de enviar el fichero, que crea el Cyberpac en la consulta de pagos, con el servicio de Lnea Abierta Web. El abono de las transferencias realizadas por Lnea Abierta es on line. Respecto a las transferencias de clientes que no utilizan la Lnea Abierta, el abono se efecta cuando ste la realiza. En este momento, el comercio puede actualizar, el estado de la operacin a pagado. Tambin se puede modificar el estado de los pedidos que se realizan mediante contrareembolso a pagado. El Cyberpac es de fcil instalacin, pero necesita de una figura informtica que sepa adaptar la tienda al sistema de pago. Es responsabilidad del comercio aportar este conocimiento, bien por experiencia propia, o por la contratacin de un proveedor. Si usted lo desea, "la Caixa" puede ponerle en contacto con alguna de sus empresas colaboradoras para que le faciliten un presupuesto sin ningn tipo de compromiso. En este caso le recomendamos que enve un E-Mail a info@lacaixa.es solicitando dicho contacto.
3. Caractersticas del Cyberpac
3.1. Tipos de pago

El Cyberpac acepta los siguientes tipos de pago:
Tarjetas: se acepta cualquier tarjeta de crdito o dbito de la Caixa. Para aceptar tarjetas de otras entidades se debe solicitar en una oficina de la Caixa.
Tarjetas de la Caixa: Para garantizar la mxima seguridad en las ventas, la configuracin estndard del Cyberpac de la Caixa no admite pagos realizados con cualquier tarjeta de crdito o dbito. Slo se puede pagar con tarjetas de la Caixa, donde se solicita el PIN y comprueba la titularidad del comprador, evitando el fraude. Estas tarjetas permiten fraccionar los pagos. Esta prestacin consiste en que el cliente que compre en el comercio y efectue el pago con una tarjeta de crdito de la Caixa, podr fraccionar el importe de la compra en diferentes plazos. Cybertarjeta: Tarjeta prepago de la Caixa exclusiva para realizar compras en Internet (para todo tipo de pagos, incluidos micropagos). Esta tarjeta es recargable por Internet mediante una tarjeta emitida por la Caixa, aunque est domiciliada en cualquier otra entidad bancaria, o por cualquier tarjeta desde cajero automtico. Para ms informacin visite http://www.lacaixa.es/tarjetas. Tarjetas emitidas por otras entidades bancarias: Tarjetas Visa, Mastercard, JCB y 6000 de otras entidades. Debe solicitar esta opcin en su oficina de la Caixa.
Transferencia bancaria: el comprador puede elegir entre su procedimiento habitual o la Lnea Abierta Web de la Caixa, en caso de que sea cliente. Si es cliente de la Caixa y tiene contratado el servicio Lnea Abierta Web, puede hacer la transferencia desde dicho servicio, al cual accede directamente, entrando el Identificador y el n secreto. Una vez enviada la transferencia, el comercio la recibir de forma online en su depsito asociado. Si no es cliente de la Caixa o no ha contratado el servicio Lnea Abierta, podr visualizar una nueva pantalla donde se encuentran todos los datos necesarios para llevar a cabo la transferencia desde su entidad. Podr imprimirse esta pantalla para facilitar as la transferencia.
Domiciliaciones: el comprador tendr que introducir el nmero de la cuenta y el nombre del titular. La domiciliacin se realizar automticamente. El comercio debe realizar los siguientes pasos para completar el pago: Escoger en la lista Tipo de Pago la opcin Domiciliaciones. Escoger en la lista Estado del Pago la opcin Domiciliado. Introducir el intervalo de fechas de los recibos que desee domiciliar. Crear el fichero de domiciliaciones. En Euros.
En la pantalla siguiente se informa de la creacin del fichero con todas las operaciones escogidas y posteriormente podr bajarse el fichero. Una vez se haya guardado el fichero de domiciliaciones, y en el momento que lo desee deber acceder al servicio Lnea Abierta Web y desde el apartado Transferencias de ficheros/Envo proceder al envo de dicho fichero. A partir de aqu, el fichero seguir el procedimiento de validacin y abono posterior segn el contrato TIR.
Para que un comercio pueda aceptar el pago a travs de domiciliaciones, debe cumplir los siguientes requisitos: Tener un contrato de Lnea Abierta Web Tener un contrato de la aplicacin TIR que es la que permite el envo de ficheros C19 con las operaciones a domiciliar.
Para darse de alta a estos contratos, puede solicitarlo a su oficina habitual. Vea las demostraciones de la opcin http://www.lacaixa.es/comercio. Contrareembolso: El cliente efectuar el pago del pedido realizado en el momento de entrega del producto, segn las condiciones establecidas por el comercio. El comercio pasar va Internet al Cyberpac los datos de envo del comprador ( los datos del comprador es obligatorio que se enven por parmetro si se desea que aparezca este tipo de pago en el Cyberpac ). Al cliente se le mostrar una pantalla con estos datos para que lo confirme y se lo imprima si lo desea.
3.2. Notificacin del pago

El Cyberpac de la Caixa realiza diferentes notificaciones de pago, tanto al comprador como al comercio: Notificacin al comprador: Se le enviar un correo electrnico en el caso de que lo haya solicitado en la pgina inicial del Cyberpac. Notificacin al comercio: Debe configurarlo en www.lacaixa.es/tpv, gestin del comercio. E-Mail online, se enva un E-Mail a la direccin especificada en el cuadro de texto, comunicando hora, nmero de pedido, importe, moneda y resultado de la operacin de pago. Se enva despus de cada pago realizado correctamente. E-Mail batch, se enva un E-Mail a la direccin especificada en el cuadro de texto, comunicndole una URL donde tendr que dirigirse para consultar el resumen diario de pagos. URL fija o notificacin HTTP, es un mdulo (macro, cgi, rutina, asp, ) diseado por el comercio en el que el Cyberpac notifica, en mtodo post, la finalizacin del
pago mediante una sesin HTTP establecida en el momento del mismo. Esta notificacin sirve para que el comercio pueda tener ms control sobre su base de datos de productos y pueda actualizar el stock automticamente despus de realizar cada pedido. la Caixa llama a la URL especificada en este cuadro de texto, pasando los siguientes parmetros (la URL fija no puede ser https y debe finalizar con un ?): idpedido=idcomanda&importe=import&moneda=<XEU>&estado=<0/1/1/3/10/11/16>&diahora=dia-hora&label=n label&huella=huella
donde estado=1 es pago realizado correctamente, estado=0 equivale al pago pendiente, estado=3 equivale al pago caducado (la transferencia por Lnea Abierta Web no se ha finalizado), estado=10 equivale al pago realizado mediante domiciliacin, estado=11 equivale a transferencia a ingresar, estado=16 equivale a pago pendienet de contrareembolso y estado=-1 se refiere a pago errneo. El parmetro dia-hora no se est utilizando actualmente.
La notificacin automtica y online de estos datos, permite al comercio hacer un tratamiento especfico de ese pedido (actualizar existencias y datos de pedidos en curso, generar procesos de comprobacin y distribucin, explotar y/o actualizar el registro de usuario, etc.) y, de ese modo, sincronizar su sistema de acuerdo con el resultado del pago. El mdulo elegido por el comercio debe devolver OK o NOK mediante una sesin HTTP y con la instruccin correspondiente de la salida estndard (printf, output, ). De este modo, el sistema del Cyberpac guardar registro de sus respuestas a las notificaciones. Es aconsejable que la URL fija que se vaya a utilizar para automatizar el comercio no contenga ninguna instruccin de cdigo HTML. El notificador realiza 3 intentos con intervalos de 3 minutos. Si no recibe respuesta registrar un timeout. Ver ejemplos en el apndice 2. En la notificacin online una vez finalizado el pago, el parmetro estado nicamente podr tomar el valor 1, 3, 10 o 11 o 16, es decir, que la URL fija recibir notificacin para todos los pedidos, a excepcin de los pendientes y los errneos. El Cyberpac suministra la utilidad local Java CheckNOTtpv para que se valide, si se desea, la autenticidad de la notificacin de pago (ver descripcin en el captulo de Utilidades del Cyberpac).
El uso de la URL fija requiere tener activa la opcin E-Mail online. -
Activar notificacin del Pago diferido, al tener activada esta opcin los pedidos que se realicen mediante pago diferido (XML), el resultado de los mismos se notificar a la URL fija o notificacin HTML.
3.3. Solicitud de notificacin de pago

En el caso de que se produjera un error en la sesin HTTP y la URL fija no recibiera los parmetros, se podra confirmar el estado de un pago realizando una consulta del estado del
mismo mediante el mdulo Java CrURLtpv. Para diferenciar un pago de una consulta se utilizar el parmetro action. La invocacin al CrURLtpv consistir, en el caso de una consulta, en pasarle los parmetros idpedido y action=c. En este caso, el valor del parmetro estado si que podr ser <0/1/3/10/11/16/-1>, es decir, se notifican todos los pedidos incluidos los pendientes y los errneos.
Para el caso de un pago no se introduca el parmetro action, siendo el mdulo CrURLtpv el que lo generaba (action=p) dinmicamente al interpretar la ausencia de ste como la creacin de un enlace para efectuar un pago.
jre -cp directorio_inst\tpv.zip;CrURLtpv tpv_path idpedido:1234 action:c Resultado: https://www.lacaixa.es/cgibin/totpvcaixa?idcom=XXX&idpedido=1234&action=c&label=5&datos=dd3441718bcfce83 e617351c38bce4af Cuando el Cyberpac recibe una peticin de consulta, valida el campo datos, y notifica el estado del pago a la URL fija. Adems, muestra OK o NOK por navegacin segn si ha habido algn error en el proceso de consulta. El motivo de mostrar estos valores es servir la peticin que se genera al llamar al Cyberpac y evitar as un tiempo de espera indefinido por parte del comercio. El Cyberpac suministra la utilidad local Java CheckNOTtpv para que se valide, si se desea, la autenticidad de la notificacin de pago (ver descripcin en el captulo 5.7).
El uso de la URL fija requiere tener activa la opcin E-Mail online.
4. Instalacin
Debe descargar en su servidor el paquete del Cyberpac adecuado a su sistema operativo y proceder a su instalacin. Los sistemas operativos para los que existe paquete de instalacin son: Windows NT y UNIX. Podr encontrarlos en la aplicacin de gestin de la pgina web: http://www.lacaixa.es/tpv.html a la que podr acceder con el usuario y contrasea dados por el administrador del Cyberpac. Puede customizar el autoinstalador para cualquier sistema operativo. El nico requisito del Cyberpac es el mdulo Java 1.1.5. Nota: Para versiones superiores del jdk posiblemente se debern editar los archivos CrURLtpv y CheckNOTtpv. En lugar de hacer la llamada al archivo ejecutable jre del jdk, en versiones superiores el ejecutable es el archivo Java.
4.1. Instalacin en Windows NT

Para poder utilizar esta aplicacin, debe tener instalado Windows NT y el intrprete de Java 1.1.5, que podr descargar junto con el autoinstalador.
4.2. Instalacin en UNIX

Para poder utilizar esta aplicacin, debe tener instalado AIX 4.x y el intrprete de Java 1.1.6. La aplicacin slo est homologada para la versin 1.1.5 del Java Runtime Environment, aunque es posible que funcione correctamente para versiones superiores de Java. En caso de utilizar Linux, Solaris u otra versin de sistema operativo, debe editar el autoinstalador y modificarlo para los parmetros concretos de su software. En el caso de Linux Intel la versin correcta de jdk es la 1.2.2. Se recomienda la ejecucin de la instalacin como usuario 'root'. Copie el fichero tpv.tar.Z en el directorio donde desee descomprimir los ficheros. Ejecute el comando 'uncompress tpv.tar.Z' para descomprimir el archivo. Se generar el fichero tpv.tar. Para descomprimir los archivos, ejecute el comando 'tar -xvf tpv.tar'. A continuacin deber ejecutar la shell script de instalacin: tpvinstall. Debe seguir las instrucciones que se le indican en el proceso de la instalacin. Se asume que el path para la korn shell es /usr/bin/ksh; en caso contrario, deber modificar la primera lnea del script tpvinstall y sustituir /usr/bin/ksh por el path correspondiente. El comando lslpp debe estar accesible en el path. Puede ser necesario (sobre todo en Linux) descomprimir el fichero tpv.zip e insertar los ficheros de clases .class en el fichero classes.zip global del sistema, despus de instalar el Cyberpac.
10
Una vez finalizada la instalacin y antes de ejecutar la aplicacin, deber aadir a la variable de entorno CLASSPATH de su sistema el path del directorio de instalacin.
Nota: En Linux y con Netscape 4.06, el cambio de claves de acceso al repositorio no funciona correctamente.
4.3. Parmetros de instalacin

Los parmetros que se describen a continuacin se almacenarn en un fichero de configuracin, una vez concluida la instalacin. En cualquier caso, estos parmetros deben coincidir con los que usted indique para su comercio en el Cyberpac, mediante la aplicacin de administracin que se suministra en www.lacaixa.es/tpv.html Identificador de comercio
Es el cdigo que le identifica en el servidor de pagos del Cyberpac. Suministrado en la notificacin de la Caixa. Cifrado
Debe indicar que desea cifrado para que la utilidad CrURLtpv genere una firma o huella que se enviar con el resto de los datos de pago. El sistema de pagos Cyberpac de "la Caixa" la utilizar para comprobar que los datos de pago no han sido modificados y que proceden de su comercio. Es obligatorio que esta opcin est activada. Claves
El programa de instalacin le pedir que introduzca las 5 claves de (mnimo) 16 a 32 caracteres numricos que va a utilizar para generar la firma criptogrfica. Debe introducir al menos una, pero es recomendable que introduzca las cinco. Estas claves deben ser las mismas que introduzca desde el men de administracin de su comercio, en el sistema de datos del Cyberpac en www.lacaixa.es/tpv.html La utilidad CrURLtpv escoger, aleatoriamente, una en cada operacin de pago. URL de error de datos
Esta URL ser la que la utilidad CrURLtpv escribir en el enlace de pago, en el caso de que se le indique algn parmetro incorrecto o se cometa cualquier otro error al invocarla. Si no se indica ninguna, la utilidad CrURLtpv utilizar la URL de error de datos de defecto del Cyberpac de "la Caixa". Ver el apartado Resolucin de problemas al final de esta gua.
11
Proxy y puerto
En caso de que utilice alterno para acceder a Internet, deber indicarlo durante el proceso de instalacin. Debe introducir el nombre del proxy, no su direccin IP. En caso de error 8003 puede ser debido a un excesivo tratamiento de seguridad en el puerto 8003 de su sistema.
Tiempo de reserva de un pago
Si quiere utilizar un tiempo mximo de reserva para sus pagos, existen dos campos para configurarlo. Uno de ellos es el tiempo mximo de reserva (en minutos) y el otro es la diferencia horaria respecto al Meridiano de Greenwich (GMT). Si consulta en su sistema operativo la franja horaria de su ciudad, puede averiguar la diferencia horaria. (Por ejemplo: Barcelona est en GMT+1, el valor de este campo sera +1). La utilidad tiene en cuenta el cambio horario. El tiempo de reserva es comprobado justo antes de realizar el pago en la Caixa. El orden de prioridad de comprobacin es el siguiente: Se consulta la fecha y hora de la URL de invocacin. En el caso de que no existiera, se realizara el siguiente paso. Se consulta la fecha y hora en la tabla del comerciante de la base de datos. Si tampoco existiera este dato, se realizara el siguiente paso. Se consulta la fecha y hora en el fichero de configuracin general del Cyberpac, que por defecto, es de 30 minutos a partir de la primera invocacin para realizar el pago.
Por seguridad, se recomienda que el tiempo de reserva sea limitado.
4.4. Reinstalacin y desinstalacin

Una vez instalada la aplicacin en el directorio elegido, puede modificar alguno de los parmetros de configuracin mediante la reinstalacin al mismo directorio. No intente editar el fichero de configuracin para modificar sus datos. Utilice siempre la instalacin para cambiar cualquier parmetro. Recuerde que los valores que configure localmente deben de coincidir, obligatoriamente, con los que haya configurado para el mismo comercio a travs de la aplicacin de administracin del Cyberpac en http://www.lacaixa.es/tpv.html Si no es as, sus rdenes de pago generarn errores cuando el Cyberpac verifique sus datos, y stas no podrn concluir correctamente.
12
Si desea reinstalar el Cyberpac en un directorio distinto, deber desinstalarlo primero y volver a instalar en el nuevo destino. Desinstalacin sobre Windows NT Si desea desinstalar la aplicacin "Cyberpac", abra la opcin de "Agregar o quitar programas", que encontrar en Configuracin - Panel de Control. Seleccione "Cyberpac" y pulse "Agregar o quitar programas".
4.5. Contenido de la instalacin

La instalacin crea un fichero de configuracin tpv.cnf que es nico para cada comercio. tpv.zip tpv.cnf leeme.txt Uninst.isu CrURLtpv.bat CheckNOTtpv.bat Clases Java empaquetadas. Fichero de configuracin. Informacin sobre el producto. Informacin para desinstalar el producto. Ejemplo de llamada a CrURLtpv. Ejemplo de llamada a CheckNOTtpv.
Fichero de configuracin tpv.cnf Contiene lneas con el formato variable=valor 1. TPVcgi_name=totpvcaixa? 2. TPV_secure=1 3. TPV_merchant_ID=id comercio (consltelo en el repositorio, pero normalmente coincide con el
usuario recibido en la notificacin de la Caixa). 4. 5.
6. 7. 8. 9.
10.
URL_ERROR_DATOS=https://(...)cgi-bin/modulo1/error (opcional) TPV_SEEDn=xxxxxxxxxx (Claves 1 a 5 para cifrado en formato propio) (*) proxy=true/false port=n de puerto/false timeout=n de minutos (actualmente este parmetro est obsoleto y est en desuso) timeoutreserva=n de minutos de reserva desde que realiza el pedido hasta que lo paga. diferenciahoraria=n de horas de diferencia con el GMT (si se pone cualquier otra ref. no
funciona. Debe contener algn valor).
13
4.6. CrURLtpv
Esta utilidad sirve para generar el enlace de llamada al Cyberpac. La respuesta es la URL que debe insertar en la pgina de pago de su comercio. La llamada debe generarla en la lnea de comandos (o mediante el shell de su lenguaje de programacin), con una serie de parmetros (unos obligatorios y otros optativos), y capturar el resultado. La aplicacin devuelve, por la salida estndard del sistema, la URL de pago cifrada en MD5 para garantizar su no manipulacin. Ponga esa URL en el enlace del botn de compra y obtendr su conexin con el Cyberpac de "la Caixa". Las pginas de pago del Cyberpac aparecern en la ventana en curso, y al finalizar se llamar a la URL de fin de pago de OK, NOK o CANCEL, segn el resultado de la operacin. Debe haber configurado su comercio para ejecutarse en la misma sesin y con pgina completa (sin frames), de otra manera se pueden dar resultados indeseados puesto que la aplicacin puede verificar dinmicamente este valor, pero no corregir una llamada incorrecta. En caso de que se introduzca algn parmetro errneo, la utilidad genera un RETURN_CODE, que puede ser capturado dinmicamente por su sistema. Si no se aborta la ejecucin, se genera una llamada a la URL de error de datos (ver el apartado "Resolucin de problemas para ms informacin y la lista de errores identificados). Si prefiere no utilizar las funciones java del autoinstalador, puede generarlas en C. En los siguientes ficheros del autoinstalador encontrar ejemplos e informacin. prueba.c Md5.c Md5.h - Ejemplos de llamada en C al MD5. - Algoritmo de cifrado. - Algoritmo de cifrado.
La firma o huella de autenticacin se genera a partir de los parmetros del pago, del identificador de comercio proporcionado por la notificacin de la Caixa y que la utilidad CrURLtpv lee del fichero de configuracin, y de la eleccin aleatoria de una de las claves instaladas por el administrador del comercio. Se aade al enlace dinmico de pago la referencia de la etiqueta de la clave utilizada. El fichero CrURLtpv.bat puede modificarse segn sus necesidades. El formato de los parmetros es el siguiente: nombre_parmetro:contenido El orden de los parmetros es irrelevante, excepto el de los dos primeros parmetros obligatorios, que deben de ser indicados en este orden: directorio_inst\tpv.zip - Path y fichero del paquete de clases internas. tpv_path - Path del fichero de configuracin del Cyberpac.
14
idpedido - Identificador del pedido.
La longitud del cdigo de pedido debe tener entre 4 y 12 caracteres alfanumricos, y las 4 primeras posiciones deben ser obligatoriamente numricas. En caso de que el Cyberpac reciba un identificador de pedido inferior o superior a 4 o 12 caracteres alfanumricos respectivamente, o las primeras 4 posiciones no sean numricas, provocar un error i no se podr realizar la operacin. No se podr reutilizar el mismo nmero de pedido independientemente del estado definitivo del mismo. moneda - Divisa utilizada en el pago.
"XEU" para Euros.
importe - Importe del pago.
Debe ser numrico. Dos decimales obligatorios. La separacin entre el nmero entero y los decimales tiene que ser un punto, por ejemplo: 83424.32
idioma - Idioma utilizado en la operacin.

"cat" para cataln, "esp" para castellano y "eng" para ingls.
Los parmetros opcionales son los siguientes: URLs de fin de pago En caso que no se especifiquen en la aplicacin de administracin www.lacaixa.es/tpv.html. Los parmetros son: url_post_ok, url_post_ko, url_post_cancel. Si no se especifica la URL y no existe ninguna en la configuracin del comercio, el pago se intentar igualmente, pero no se podr volver por navegacin a las pginas del comercio. Las URLs deben escribirse con el nombre completo, especificando "http://". El Cyberpac aade dinmicamente, a la URL correspondiente, los parmetros: idpedido, idcom, idioma, de modo que el comercio puede personalizar el regreso del cliente a su web. mailcomp - Direccin E-Mail del comprador. Si el comercio lo ha obtenido previamente mediante su formulario de datos, puede especificarlo en la llamada al Cyberpac. Si no lo hace, las pginas de pago del Cyberpac conceden al comprador la posibilidad de indicar su direccin E-Mail. El Cyberpac enviar un E-Mail al comprador informando del resultado del pago.
15
mpago Preinformacin del mtodo de pago. Es un string de longitud 20, esta cadena de letras que se pasa a maysculas donde cada letra identifica un medio de pago diferente. Las diferentes letras pueden ser: T: Tarjeta A: Ajenas R: Transferencias D: Domiciliaciones K: Contrareembolso No se comprueban las letras, por tanto, se podrn aadir nuevos medios ms adelante, la variable viaja al Cyberpac en la URL y se acaba de llenar con X por la derecha, para formar 20 caracteres de longitud.
Parmetros opcionales para personalizar el pago (ver apartado 5.6.1) y el parmetro para configurar los pedidos con preautorizacin (ver apartado 5.6.2).
Antes de la invocacin al CrURLtpv debe editar en el repositorio www.lacaixa.es/tpv.html los campos correspondientes a: Icono, Claves (les 5 que haya editado en el fichero de configuracin), tipo de notificacin (E-mail online, E-mail batch, URL fija) y las URL's de fin de pago.
Durante las pruebas se puede utilizar cualquier tarjeta de la Caixa, pues el cargo en la cuenta no se realizar. Si no dispone de una tarjeta de la Caixa, teclee la siguiente numeracin: 4548032003933011. La fecha de caducidad y el PIN pueden ser cualquiera.
4.6.1. Formulario de datos del comprador

El comercio puede pedir los datos de envo del comprador directamente desde el Cyberpac. De esta forma, no hace falta crear un formulario y una base de datos de gestin del mismo. La base de datos del Cyberpac la podr utilizar para guardar la informacin del envo y de los clientes. En la pgina del Cyberpac se pedir el nombre, apellidos, direccin, cdigo postal, etc. del cliente referente al destino del envo del pedido. Para realizarlo debe pasar los siguientes parmetros en la URL de enlace al Cyberpac de la Caixa: nombre, apellido1, apellido2, direccion, ciudad, cp, provincia y pais de residencia del comprador. Donde se enviar el producto. telefono: Nmero de telfono del comprador. titulo: seor/seora (castellano), senyor/senyora (cataln), mr./mrs. (ingls).
16
pedmodif: Segn si el comerciante quiere dejar modificar o no al comprador los datos personales asociados al pago. Debe marcar si/no. En el caso de utilizar este parmetro, con el valor no debe ir acompaado de algn parmetro referente al comprador (nombre, apellido1, etc.), para que dichos datos no se puedan modificar. Si pedmodif se omite, se toma pedmodif:si por defecto. action: Este parmetro es obligatorio si se quiere indicar al Cyberpac que viajen los datos personales. De marcarse action:s, el Cyberpac, solicitar al comprador que rellene los parmetros que no se hayan cumplimentado, siendo obligatorio para el comprador cumplimentar todos los datos personales, a excepcin del E-Mail o el telfono. Uno de los dos se puede omitir.
Los distintos parmetros pueden contener caracteres especiales, o estar compuestos por varias palabras. Por ejemplo: nombre: Jos Lus, o direccin: Av. Diagonal, 571 4 2. La longitudes mximas de estos parmetros son: Nombre: 40 Apellido1: 30 Apellido2: 30 Direccion: 50 CP: 5 Ciudad: 20 Provincia: 30 Pais: 30 Telefono: 12 Cada parmetro que se le pase a la utilidad de creacin de enlaces debe estar compuesto de un nico string y se debe hacer el URLEncode (funcin escape de javascript) de cada parmetro antes de pasarlo. Con esto se consigue transformar varios strings en uno slo, y transformar tambin los caracteres especiales en una notacin comn. La clase java.net.URLEncode es una clase java que viene en cualquier jdk y por lo tanto fcilmente accesible. Ver ejemplos en el Apndice 1. Si conoce los datos financieros del comprador, puede pasarlos al Cyberpac mediante los siguientes parmetros. De esta forma, el comercio puede facilitar los pagos de sus usuarios registrados, realizar actualizacin de suscripciones, etc. pan Nmero de tarjeta con el que se realizar el pago. mes - Mes de la fecha de caducidad de la tarjeta. Sern como mximo dos dgitos. any - Ao de la fecha de caducidad de la tarjeta. Sern como mximo dos dgitos. tarmodif - Se deber marcar si el comerciante quiere dejar modificar o no al comprador los datos de la tarjeta. Los valores posibles son: si/no. Se recomienda que sean
17
modificables, ya que en ese caso se realizar una verificacin del nmero de tarjeta en la pgina de pago, y de esta manera se asegura que no se enven nmeros de tarjeta invlidos en la transaccin a la Caixa. En caso de enviar alguno de los parmetros de informacin de tarjeta (pan, mes o any) se deber enviar este parmetro obligatoriamente.
4.6.2. Preautorizaciones
Para indicar al Cyberpac que el pedido que se va a realizar ser una preautorizacin se debe de indicar mediante el parmetro pautor. La posibilidad de preautorizar un pago slo est disponible para el mtodo de pago de Tarjeta. pautor: Preautorizacin de la tarjeta del pago.
Nmero 1/0, esta variable viaja al Cyberpac en la URL slo en caso de que sea 1, aunque si llega como 0 no da error. Sirve para preautorizar el pago, es decir, que ste no se realizar, sin que se autoriza su realizacin a posterior.
4.6.3 Ejemplos de llamada al CrURLtpv

Donde XXX = identificador de comercio, nico para cada tienda. XXX se sustituye automticamente por el dato TPV_merchant_ID = id comercio del fichero de configuracin.
1. Invocacin correcta al .bat crURLtpv crURLtpv idpedido:1234 importe:1000.00 moneda:XEU idioma:esp mailcomp:nombre@mail.com Resultado: https://www.lacaixa.es/cgibin/totpvcaixa?idcom=XXX&idpedido=1234&moneda=XEU&importe=1000.00&idioma=es p&url_post_ok=&url_post_ko=&url_post_cancel=&mailcomp=nombre@mail.com&action= p&datatimeout=&label=3&datos=6b7bae7bc90e43948632f7eaa440d3ca En Linux debe ejecutarse como jre CrURLtpv path_instalacin idpedido:1234 importe:1000.00 moneda:XEU idioma:esp mailcomp:nombre@mail.com
2. Invocacin correcta al .bat crURLtpv, en idioma Ingls y moneda Euros Invocacin: crURLtpv idpedido:1234 importe:1000.00 moneda:XEU idioma:eng
18
Resultado: https://www.lacaixa.es/cgibin/totpvcaixa?idcom=XXX&idpedido=1234&moneda=XEU&importe=1000.00&idioma=en g&url_post_ok=&url_post_ko=&url_post_cancel=&mailcomp=&label=1&datos=8efbac963 d0f7e4e8c606c65a54e2e74
3. Invocacin correcta con los datos de pedido y de tarjeta Invocacin: jre -cp directorio_inst\tpv.zip; CrURLtpv tpv_path idpedido:1234 importe:10.00 moneda:XEU idioma:esp url_post_ok:http://www.micomercio.com/cgi-ok url_post_cancel:http://www.micomercio.com/cgi-cancel url_post_ko:http://www.micomercio.com/cgi-ko mailcomp:pepe@mail.com pan:4548032003933011 mes:03 any:03
Resultado: https://www.lacaixa.es/cgibin/totpvcaixa?idcom=XXX&idpedido=1234&moneda=XEU& importe=10.00&idioma=esp&url_post_ok=http%3A%2F%2Fwww.micomercio.com%2Fcgi ok.cgi&url_post_ko=http%3A%2F%2Fwww.micomercio.com%2Fcgiko&url_post_cancel=h ttp%3A%2F%2Fwww.micomercio.com%2Fcgicancel&mailcomp=nombre@mail.com&actio n=p&datatimeout=&pan=4548032003933011&mes=03&any=03tarmodif=si&label=2&datos =4fdadd4fabb3edd53c5320091aabdcc1
4. Invocacin correcta al .bat crURLtpv, con el parmetro de preautorizacin e indicando que el pago es con tarjeta de la Caixa Invocacin: crURLtpv idpedido:40404 importe:10.00 moneda:XEU idioma:esp pautor:1 mpago:T Resultado: https://www.lacaixa.es/cgibin/totpvcaixa?idcom=XXX&idpedido=40404&moneda=XEU&importe=10.00&idioma=esp &mpago=TXXXXXXXXXXXXXXXXXXX&pautor=1&label=5&datos=0987c2daaffa64a3 019541e489da884e
5. Invocacin correcta con los parmetros del cliente ( posibilidad de pago mediante contrareembolso )
Previamente a la generacin de la URL para llamar al Cyberpac debe utilizar la clase java.net.URLEncode para los parmetros que contengan un string o la funcin escape de javascript, por ejemplo: String nombre = java.net.URLEncoder.encode(Jos Lus); String nombre = escape(Jos Lus); 19
String direccion = java.net.URLEncoder.encode(Av. Diagonal, 571 4 2); String direccion = escape(Av. Diagonal, 571 4 2);
Con lo cual lo que en realidad utilizaramos: nombre:Jos%E9+Lu%EDs direccin:Av.Diagonal%2C+571+4%BA+2%AA Adems, para el parmetro ttulo tendramos un caso especial cuando el idioma es castellano, ya que la es un carcter especial. As, en lugar de pasar seor/seora, pasaramos se%F1or/se%F1ora.
Invocacin: jre -cp directori_inst\tpv.zip; CrURLtpv tpv_path idpedido:1234 importe:100.00 moneda:XEU idioma:esp url_post_ok:http://www.micomercio.com/ok.html url_post_cancel:http://www.micomercio.com/cancel.html url_post_ko:http://www.micomercio.com/ko.html mailcomp:nombre@mail.com pan:4548032003933011 mes:03 any:03 tarmodif:si nombre:Jos%E9+Lu%EDs apellido1:Garcia apellido2:Lopez direccion:Av.Diagonal%2C+571+4%BA+2%AA ciudad:Barcelona cp:08080 provincia:Barcelona pais:Espa%F1a telefono:934112233 titulo:se%F1or pedmodif:si action:s
Resultado: https://www.lacaixa.es/cgibin/totpvcaixa?idcom=CaixaTST&idpedido=1234&moneda=XEU&importe=100.00&idioma =esp&url_post_ok=http%3A%2F%2Fwww.micomercio.com%2Fok.html&url_post_ko=http %3A%2F%2Fwww.micomercio.com%2Fko.html&url_post_cancel=http%3A%2F%2Fwww. micomercio.com%2Fcancel.html&mailcomp=nombre@mail.com&action=s&datatimeout=& pan=4548032003933011&mes=03&any=03&tarmodif=si&nombre=Jos%E9+Lu%EDs&apel lido1=Garcia&apellido2=Lopez&direccion=Av.Diagonal%2C+571+4%BA+2%AA&ciudad =Barcelona&cp=08080&provincia=Barcelona&pais=Espa%F1a&telefono=934112233&titul o=Se%F1or&pedmodif=si&label=1&datos=41dec55d22b516db958580f5f141f925
6. Invocacin incorrecta por error de parmetro (URL de error de datos prpia, definida en la instalacin). jre -cp directori_inst\tpv.zip; CrURLtpv moneda:xeu idioma:esp importe:14.77 idpedido:1234
20
Resultado: https://www.lacaixa.es/cgi-bin/tpvwww/url_error.mac/report?error_code=6 debido

que el valor del parmetro moneda tiene que ser maysculas.
Ver ejemplo1 en el apndice 2. El Cyberpac verifica que el pago procede de su comercio generando la misma firma o huella. Para ello es imprescindible que las claves de cifrado de su comercio coincidan completamente en su sistema local y en el repositorio del Cyberpac en www.lacaixa.es/tpv.html. Si el comerciante elige poner un tiempo mximo de reserva, la aplicacin realiza los clculos oportunos para enviar la fecha y la hora, sincronizada con la de Barcelona.
4.7. CheckNOTtpv: Verificacin de la notificacin HTTP

Slo en comercio complejo con MD5. Una vez recibida la notificacin del pago en esta URL fija, el comercio puede verificar la autenticidad del mensaje y su procedencia mediante la invocacin de la utilidad CheckNOTtpv con los parmetros recibidos. Para validar la firma MD5 de una notificacin de pagos recibida desde el Cyberpac de "la Caixa", puede llamar a CheckNOTtpv con los parmetros siguientes, en este orden: input: Parte a cifrar. Es el contenido de los campos moneda, importe, idpedido recibidos del Cyberpac "la Caixa" concatenados. label: Contenido del campo label recibido de "la Caixa". Es la etiqueta de la clave con la que se gener la firma o huella de los datos. huella: Huella a validar. Contenido del campo huella recibido de "la Caixa".
No devuelve nada si la huella o firma MD5 es correcta, es decir, si los datos no han sido alterados y provienen de la Caixa. En caso contrario devuelve en la entrada estndard del programa que la ha llamado: 1 Huella incorrecta. Los datos han sido alterados o no provienen del Cyberpac. 2 Error en checkNOTtpv. Error interno. Revisar fichero de configuracin.
En Unix, se tienen que validar los return codes para que haga el echo correspondiente. Para capturar el cdigo de retorno deben hacer echo $.
Pueden verse ejemplos activos en las demostraciones de la pgina de Internet www.lacaixa.es/tpv.html
21
Ejemplos de llamada a CheckNOTtpv Invocacin: CheckNOTtpv XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35 Invocacin: jre -cp directori_inst\tpv.zip; CheckNOTtpv XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35 Invocacin en Linux: jre -cp directori_inst\tpv.zip; CheckNOTtpv tpv_path XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35
22
5. Configuracin de su comercio en el repositorio

El repositorio del Cyberpac de la Caixa son unas pginas de Internet que le permiten visualizar unas demostraciones y obtener el software de la aplicacin. Puede tambin bajar copias de este documento gua, configurar el usuario y su comercio, y visualizar los datos de las ventas realizadas. Encontrar estas pginas en la direccin: http://www.lacaixa.es/tpv.html Usuario y password
En primer lugar, usted debe acceder a la pgina de logon, en la que debe indicar el usuario que se le ha asignado y la password del mismo. Puede modificar su password si as lo desea. Control de acceso
En todos los accesos al servidor del Cyberpac desde la aplicacin de gestin se genera una clave nica de acceso. Esta clave garantiza que slo puede existir una sesin activa del usuario administrador de su comercio. Cualquier otro intento genera un error de Acceso denegado. Como consecuencia de este control, usted no puede marcar una pgina de la aplicacin en su lista de favoritos, ni utilizar las teclas de Atrs, Adelante o Recargarde su navegador, sin que obligatoriamente debe utilizar los enlaces de navegacin de la aplicacin. Una vez validada su password, usted puede elegir una de las siguientes opciones: Modificar datos del comercio Modificar datos del usuario Gestionar usuarios del comercio Consultas/Devoluciones de pago Consultas/Devoluciones de pago en histrico Introduccin manual de pagos Pagos preautorizados
Tenga en cuenta que todos los accesos estn autenticados por la clave nica. Nadie ms que el usuario administrador - y eso desde una nica sesin - puede tener acceso a la administracin del Cyberpac.
23
5.1. Modificar datos del comercio

Usted accede a la consulta y/o modificacin de los siguientes datos de configuracin de su comercio. Los cambios son efectivos en la primera operacin despus de la modificacin.
Los marcados en cursiva slo pueden ser modificados por el administrador del Cyberpac.
Identificador de comercio
Identifica su comercio en las llamadas dinmicas de pago al Cyberpac. Nombre del comercio
Nombre que aparece identificando su comercio en las pginas del Cyberpac. Icono del comercio
Mediante esta opcin, usted puede exportar al sistema del Cyberpac el logotipo de su comercio que quiere que aparezca en las pginas del Cyberpac visualizadas por el comprador. El nico formato soportado es el GIF. Puede cambiar el icono siempre que lo desee. Tipo de seguridad
Indicador de que su comercio enva, validacin de los datos de pago por firma o huella criptogrfica (encriptacin de MD5). Claves
Slo en el caso de comercio complejo con MD5. Mediante la opcin Editar claves, usted puede introducir las 5 claves, de 16 a 32 caracteres, que introdujo en local durante la instalacin. Cualquier cambio, en cualquiera de las claves de cifrado, debe actualizarse tanto aqu como en su configuracin local. Para ello, debe reinstalar el Cyberpac en su sistema. Tipos de notificacin
Sistemas utilizados por el Cyberpac para comunicar al comercio la finalizacin de un pago (como ya se ha visto en el apartado 3.3). URL's de fin de pago
En estos campos se indican las URLs del comercio a las que volver el comprador despus de finalizar el proceso de pago. Las URLs de fin de pago posibles son: Pago correcto: Pgina a la que volver si el pago concluye correctamente. Pago incorrecto: Pgina a la que volver si el pago no concluye correctamente. Pago cancelado: Pgina a la que volver si el pago es cancelado por el usuario.
24
Nota: Es responsabilidad de la URL de fin de pago el manejo de los frames del comercio, si los hubiera.
Estas URLs de fin de pago pueden ser documentos html estticos o documentos dinmicos. Las URLs dinmicas permiten la personalizacin del retorno del comprador al web del comercio. Para esto, el Cyberpac aade los parmetros particulares de la operacin: idpedido=idpedido&idioma=idioma&idcom=idcom El Cyberpac admite 2 tipos de URLs de fin de pago: Variable: Especificada en cada llamada, invocacin de pago al Cyberpac. Fija: Configurada en el repositorio e igual para todas las llamadas desde ese comercio.
Estado del comercio
El defecto tras el alta es TEST. Contacte, mediante un E-Mail con referencia Cyberpac, con el administrador del Cyberpac si desea modificarlo. Test: Los pagos no se efectan realmente en la Caixa, sino que son simulados. No se valida la fecha de caducidad ni el PIN. No se produce cargo en cuenta del comprador. Durante las pruebas se puede utilizar cualquier tarjeta de la Caixa. Si no dispone de una tarjeta de la Caixa, teclee la siguiente numeracin: 4548032003933011. La fecha de caducidad y el PIN pueden ser cualquiera.
Nota: Para emular los pagos incorrectos, cuyo identificador de pedido acaba en cero. se devuelve error en todos los pagos
Produccin: Los pagos se efectan realmente en la Caixa. Se produce cargo en cuenta del comprador en el momento del pago.
Modo de llamada al pago
Se recomienda que la sesin de pago en el Cyberpac corra en la misma sesin que la navegacin por el comercio, y adems, que la pgina de llamada al Cyberpac de la Caixa no contenga frames, de esta forma el usuario tendr activo el candado de seguridad del navegador, correspondiente al servidor seguro de la Caixa.
En caso de que su servidor est en entorno seguro, esta recomendacin no es necesaria, y los botones Salir/Cancelar respetan el frame. Si se abre ventana nueva, la llamada debe ser: function tpvlink(dir) { ventana=window.open(dir,ttulo de la ventana,toolbar=no, directories=no, menubar=no, status=yes, scrollbars=yes, width=620, height=540, resizable=yes); }
25
Es importante especificar correctamente el modo de llamada, para que la conclusin de la sesin de pago en el Cyberpac no genere error en el navegador del comprador.
Tiempo mximo de espera para una reserva
Tiempo mximo de espera por el Cyberpac para realizar un pedido.
5.2. Modificar datos de usuario

Usted puede indicar los parmetros siguientes del usuario conectado utilizando la aplicacin de gestin del Cyberpac www.lacaixa.es/tpv.html Parmetros: Nombre y Apellidos, Direccin, Provncia, Ciudad y Pas, Telfono y E-mail, Idioma (Cataln / Espaol).
5.3. Gestin de usuarios

El usuario administrador del comercio puede crear usuarios para que puedan acceder al comercio. Estos usuarios tendrn el acceso limitado a las pginas del repositorio del Cyberpac. Nuevo usuario
Crea un usuario que podr acceder al repositorio del comercio. Los parmetros que se piden son: tipo de usuario (operador/helpdesk)2*, contrasea (alfanumrica entre 6 y 8 caracteres), validacin de la contrasea, descripcin del usuario, nombre, apellidos, direccin, ciudad, provincia, telfono, pas, idioma (cataln/espaol) y E-mail. El identificador que se crea para el nuevo usuario es el mismo que el del administrador pero aadiendole dos dgitos numricos.
Modificar
Permite modificar los datos que se han introducido cuando se ha creado el usuario a excepcin de la descripcin del usuario y del password. Tambin permite modificar su estado (alta/baja).
El usuario operador tiene acceso a todas las opciones a excepcin de la configuracin del Cyberpac y administracin de usuarios. El usuario helpdesk nicament tiene acceso a la consulta de pagos.
26
Cambiar password
Cambia la contrasea del usuario indicado, introducindole el nuevo password y la validacin del mismo (alfanumrico entre 6 y 8 caracteres). Dar de baja
Modifica el estado del usuario seleccionado. Fsicamente no se elimina el usuario en la base de datos del Cyberpac, por si el administrador del comercio quiere reactivar el usuario.
5.4. Consulta/Devoluciones de pagos

Usted puede consultar y realizar devoluciones de los pagos realizados en su comercio del ltimo mes inmediatamente despus de su realizacin, a excepcin de los pedidos preautorizados que estaran 3 meses. Tambin tiene la opcin de consultar los pagos del ltimo ao accediendo a la opcin de Consulta/Devolucin de pagos en histrico, a excepcin de los pedidos pendientes y errneos que nicamente estaran los de los 2 y 3 ltimos meses de su realizacin. Es la Caixa quien rellena estos datos, as que puede tener total seguridad de los mismos. Para consultarlos debe indicar los criterios de seleccin de su consulta: Comercio
En el caso que un usuario tuviera dos o ms comercios asociados debera seleccionar el comercio con el que quiere realizar la consulta. Referencia del pedido
El identificador de su pedido en la pgina de pago. De este modo, slo puede consultar los detalles de un pedido concreto. Tipo de pago
De este modo, puede consultar los pagos realizados con un tipo de pago concreto. Los tipos de pago consultables son: Todos, Tarjetas, Transferencias, Domiciliaciones, Transf. Lnea Abierta, Contrareembolso.
Estado de los pedidos
De este modo, puede consultar los detalles de los pedidos que cumplan una serie de condiciones comunes. Los estados consultables son: Pendientes, Pagados, Denegados,
27
Domiciliados, A ingresar (por transferencia), Preautorizados, Todos (incluye todos los anteriores). Los pedidos que tengan estado A ingresar no cambian nunca de estado. El propio comercio ser el encargado de mirar en su cuenta corriente, que el texto del concepto del ingreso corresponda con el pedido de dicho cliente. Una vez comprobado, el comercio podr cambiar el estado del pedido a pagado. Fecha del pedido
Puede establecer cota inferior y/o superior en su consulta, teniendo en cuenta la fecha de llamada al Cyberpac para ese pago.
Nota: Tenga en cuenta que un pedido reintentado varios das tiene la fecha del ltimo acceso vlido al Cyberpac.
Si deja los campos de Fecha inicio y Fecha fin en blanco, se listarn todos los pedidos en el estado seleccionado. Tipo de informe Crear fichero domiciliaciones en euros: El importe de los pedidos est en euros. Ver pedidos: Puede generar un listado que se visualice en su navegador o imprimir el resultado. Crear fichero: Puede generar un fichero con los resultados de su consulta y descargarlo en su mquina. El formato del fichero es TEXTO, con campos delimitados por punto y coma, por lo que se puede visualizar con la hoja de clculo que se desee.
El resultado ofrece la siguiente informacin ordenada por das: Fecha, Hora, Referencia del pedido, Devolucin (Si/No), Comercio, Importe, Estado, Razn (0 cuando el pedido est como pendiente, 1 cuando el pedido est pagado y diferente de 0 y 1 cuando ha habido un error), E-Mail, Mtodo de pago. Al seleccionar un pedido de la lista donde el Cyberpac haya solicitado los datos del comprador, tambin se visualizarn los datos del mismo: Nombre, Primer Apellido, Segundo Apellido, Direccin, Ciudad, Cdigo Postal, Provincia, Pas, Telfono y Ttulo (Seor/Seora).
5.4.1. Devoluciones
Se pueden realizar devoluciones de los pedidos pagados con tarjeta, transferencias y domiciliaciones. Para realizar una devolucin primero debe seleccionar la operacin u operaciones de las que desea efectuar una devolucin, por lo que deber clicar el botn Ver listado en la pgina de Consultas/Devoluciones de pagos.
28
Le aparecer una pantalla con la operacin u operaciones seleccionadas y deber sealar en la referencia del pedido al que se quiera aplicar la devolucin. Posteriormente le aparecer una pantalla con el detalle del pedido. Si se quiere realizar la devolucin por el importe igual a la operacin slo se deber clicar el botn Devolucin, y si se quiere realizar por un importe inferior, se deber introducir el importe deseado en la casilla correspondiente. Una vez realizado el anterior paso, le aparecer otra pantalla en la que se le pedir la confirmacin de la devolucin. Para realizar las devoluciones de pedidos pagados con transferencias o domiciliaciones, deber introducir su identificador de Lnea Abierta.
5.5. Introduccin manual de pagos

Si el comercio no quiere utilizar el Cyberpac como una pasarela de pagos estndard, es decir, que una de sus pginas web enlace con el Cyberpac y el comprador introduzca sus datos de la tarjeta a la pgina del Cyberpac, tambin tendr la posibilidad de introducir los pagos manualmente mediante la opcin de Introduccin manual de pagos. Para poder utilizar esta modalidad de pago del Cyberpac, lo deber solicitar en su oficina.
Mediante esta opcin el comercio podr realizar pedidos sin necesidad de que el comprador tenga que acceder a la pgina web del comercio. Para hacerlo el comercio deber solicitar al comprador que le facilite los datos de la tarjeta (nmero de tarjeta y la fecha de caducidad). Con estos datos el comercio deber introducir en la Aplicacin de Gestin del Cyberpac, el identificador del pedido (*) y el importe del mismo. Posteriormente, se deber confirmar dicho pedido para que se realice la transaccin.. (*) Que siempre debe ser diferente , de un mnimo de 4 y un mximo de 12 posiciones y las 4 primeras nmericas.
5.6. Gestin de pagos preautorizados
Mediante la opcin de pagos el comercio podr decidir la finalizacin de la transaccin de los pagos preautorizados realizados en su comercio. Para realizar la transaccin de un pago preautorizado, puede realizarlo de dos maneras diferentes, o bien, introducir la referencia del pedido directamente o en caso de desconocerla es preferible utilizar la opcin de Listar pedidos introduciendo el rango de fechas que prefiera para limitar la bsqueda, posteriormente deber seleccionar el pedido que desee.
29
Cuando tenga introducida la referencia del pedido preautorizado deber pulsar el botn Aceptar. En la siguiente pgina se le mostrarn los datos de la preautorizacin por si quiere modificarlos (comercio, referencia del pedido, importe definitivo del pedido, tipo de moneda, n de tarjeta y fecha de caducidad) y posteriormente deber confirmarlos pulsando el botn Aceptar.
30
6. Paso a Produccin
Notificar al administrador, mediante un E-Mail a info@lacaixa.es y con referencia Cyberpac, la URL del comercio y el inters por pasar los pagos del comercio a produccin, de forma que se realicen los cargos en cuenta. Durante un corto periodo de tiempo, el administrador comprobar el correcto funcionamiento del enlace entre el comercio y el Cyberpac, borrar todos los pagos realizados en Test y cambiar el estado del Cyberpac, notificando al comercio la finalizacin del estado Test. En caso de errores, el administrador del Cyberpac se pondr en contacto con el comercio via mail para ofrecer soluciones. No se deben realizar cambios ni pruebas durante este tiempo. Notificar al administrador del Cyberpac el nombre comercial de la tienda y una pequea descripcin, pues los datos sern facilitados a VISA Espaa y VISA Internacional para que los incorpore en su web. Tambin se listar el comercio en las pginas de la Caixa destinadas a tal efecto: http://www.lacaixa.es/comercio
Recuerde, que segn la legislacin actual, si su comercio trabaja con tarjetas que no son de la Caixa, y por lo tanto, con las que no se podr comprobar la titularidad del comprador mediante el PIN, si el cliente afirma no haber recibido la mercanca o servicio solicitado o, por cualquier razn, devuelve uno o varios de los productos o servicios con el fin de cancelar total o parcialmente su pedido, el establecimiento quedar obligado a extender nota de abono por el valor de los productos o servicios ofertados y a depositarla de inmediato en "la Caixa"
31
7. Resolucin de problemas
Si hace tiempo que baj el autoinstalador, obtngalo de nuevo y reinstlelo para asegurar que su versin es la correcta. Pueden producirse excepciones en varios puntos del proceso de pago. Invocacin a la CrURLtpv desde el sistema del comercio
Se efectan, entre otras, las siguientes comprobaciones: Que no falta ningn parmetro obligatorio. Los parmetros son formalmente correctos. El fichero de configuracin no ha sido modificado sin reinstalar. Es obligatorio que los datos del fichero de configuracin local y los datos del repositorio (http://www.lacaixa.es/tpv.html ) sean iguales. Cualquier modificacin que se efecte en este fichero debe ser mediante la reinstalacin de Cyberpac. El fichero de configuracin no debe ser editado directamente.
La utilidad CrURLtpv devuelve un RETURN_CODE, en funcin del parmetro errneo obtenido. Este RETURN_CODE puede ser capturado dinmicamente por el sistema del comercio para su anlisis. Si el sistema del comercio no captura el RETURN_CODE, o lo captura pero decide generar la pgina igualmente, sta se genera con el enlace de llamada al Cyberpac dirigido a una URL de error: "https://www.lacaixa.es/url_error_datos)?error_code=XXX&numped=1234(...) La URL de error de datos prpia del comercio ser la especificada durante el proceso de instalacin. En caso de que no se haya especificado ninguna, el Cyberpac escribir la que tiene por defecto; en este caso, la URL de error de datos de "la Caixa". La variable error_code recoge el valor del RETURN_CODE generado. Una excepcin puede ser capturada en 3 puntos distintos: En el momento de generacin de la pgina dinmica de pago. En el sistema del comercio, en la URL definida como URL de error de datos. En el sistema del Cyberpac (que posteriormente la redirigir a la URL de error del comercio). Llamada a la Caixa desde el Cyberpac para efectuar el pago
Se efectan, entre otras, las siguientes comprobaciones: - Los datos del comercio son correctos. - El nmero secreto personal y la fecha de caducidad son correctos. - Existe saldo suficiente en la cuenta del comprador.
32
Cualquiera que sea el error generado en los dos puntos anteriores, se efecta una redireccin a una pgina de error, en la que se indican el cdigo de retorno y el cdigo de razn. En dicha pgina aparece un botn de Continuar, que apunta a la URL de error que el comercio haya especificado en su llamada dinmica al Cyberpac o, en su defecto, a la URL de error del comercio en el repositorio del Cyberpac.
Tiempo de reserva en el cambio horario
Si su comercio realiza reservas que si no se pagan las ha de anular, utilizando el parmetro datatimeout del Cyberpac, y debido al cambio horario (verano-invierno), detecta diferencias, puede ser que el cdigo de la utilidad de creacin del enlace al comercio (CrURLtpv) y no est funcionando correctamente debido al cambio de hora. La utilidad no est teniendo en cuenta el cambio a horario de verano a la hora de generar la hora de timeout (datatimeout). 1) Windows trabaja con el sistema horario basado en el Meridiano de Greenwich y hay que sumar una hora al estar en horario de verano. 2) En Unix se utiliza el sistema horario del Centro de Europa y hay que restar una hora en horario de verano. Si su error no es ninguno de los casos anteriores, o los descritos en la tabla del Apndice 1, enve un E-Mail con referencia Cyberpac a info@lacaixa.es. Comunquenos:
La URL donde se encuentra la pgina de pago con el enlace al Cyberpac. La URL que genera para visualizar las pginas del Cyberpac. El usuario y password de acceso a su repositorio. El error o problema detectado.
33
Apndice 1: Errores devueltos por el Cyberpac

La siguiente tabla incluye todos los cdigos de error susceptibles de ser devueltos por el Cyberpac en cualquiera de los puntos mencionados en el captulo Resolucin de problemas.
CDIGO 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 18 19 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 41 42 43 43 44 45 46 53 57 58 59 60 61 CAUSA Operacin aceptada. Error en el fichero tpv.cnf Nmero de parmetros incorrecto Formato de parmetros incorrecto Parmetro desconocido Falta o es incorrecto el parmetro idpedido o longitud incorrecte Falta o es incorrecto el parmetro moneda Falta o es incorrecto el parmetro importe Falta o es incorrecto el parmetro idioma Parmetro mailcomp incorrecto Parmetro url_post_ok incorrecto Parmetro url_post_ko incorrecto Parmetro url_post_cancel incorrecto Falta o es incorrecto el parmetro MONEDA Falta o es incorrecto el parmetro IMPORTE Falta o es incorrecto el parmetro IDIOMA Error en el envo de parmetros Parmetro action incorrecto Parmetro pan incorrecto Parmetro mes incorrecto Parmetro any incorrecto Parmetro nombre incorrecto Parmetro apellido1 incorrecto Parmetro apellido2 incorrecto Parmetro direccion incorrecto Parmetro ciudad incorrecto Parmetro cp incorrecto Parmetro provincia incorrecto Parmetro pais incorrecto Parmetro telefono incorrecto Parmetro titulo incorrecto Parmetro tarmodif incorrecto Parmetro pedmodif incorrecto Falta parmetro action:s para datos de pago Parmetro idportal incorrecto Parmetro gnportal incorrecto Parmetro gnportal recibido sin idportal Parmetro Telefon2 no recibido o formato incorrecto Parmetro Horaent no recibido cuando contrareem=si Parmetro Contrarem recibido con formato incorrecto Falta algn Parmetro de datos de usuario y contrarem=si Llamada al Cyberpac incorrecta (falta de parmetros) Parmetre idportal no donat d'alta a la taula de portals Parmetro gnportal recibido sin idportal Parmetro idportal incorrecto (longitud <=4) Parmetro gnportal incorrecto (longitud <=4) Parmetro telefon2 no recibido cuando contrareem=si Accin recomendada Su operacin ha sido aceptada. Revisar instalacin Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv Revisar llamada al crURLtpv
34
62 81 85 90 91 92 93 94 95 101 140 160 400 1000 1062 1063 1100 1122 1125 1152 1155 1157 1163 1193 1194 1200 1250 1300 1301 1400 1500 1551 1600 1700
Parmetre horaent no recibido cuando contrareem=si Falta respuesta del Cyberpac por Time-out u otro motivo Falta respuesta del Cyberpac por Time-out u otro motivo No hay comunicaciones con el Cyberpac No hay sesiones con el Cyberpac Falta respuesta de host por Time-out u otro motivo Excepcin sistema Error en comunicaciones Lu6.2 Error de instruccin SQL Error interno del Cyberpac (Bind del cgi) El pedido se ha realizado por un medio de pago que no est soportado por el comercio Provocado por una caida de las comunicaciones del SAT Error por parmetro Time-out Comercio no existe en TPVMERCH Fecha de caducidad ilgica. No se permite fecha de caducidad. Pago con mvil Error en autentificacin de datos La operacin que solicit no es conocida por nuestro sistema. El PIN slo se permite para tarjetas de "la Caixa". El importe tecleado contiene smbolos inadecuados No estan permitidos importe < a 2 Ptas / 0,01 Euros Se ha tecleado un importe no numrico o demasiado grande El nmero de operacin es ilgico La fecha es errnea La hora es errnea Pago ya realizado correctamente para este pedido Idpedido utilizado con anterioridad No existe la etiqueta indicada para ese comercio Comercio con MD5 activo Tipo de pago no permitido Error en acceso al servidor El formato del mensaje es invlido Respuesta negativa del servidor Pago no aceptado por el Cyberpac
Revisar llamada al crURLtpv Probar ms tarde Probar ms tarde Probar ms tarde o reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Probar ms tarde Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Cancelar el pago Probar ms tarde Obtener de nuevo el autoinstalador Reportar al administrador del Cyberpac La fecha de caducidad tecleada es errnea. Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Existe una incidencia en la aplicacin. La operacin no requiere el nmero secreto personal. Volver a introducir el importe Reportar al administrador del Cyberpac Cancelar el pago Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Volver a generar el idpedido Reportar al administrador del Cyberpac Solicitar el cambio al adm. del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del
35
1783 1800 1900 2000 2001 2002 2003 2010 2012 2020 2030 2031 2035 2046 2060 2075 2100 2101 2102 2103 2104 2200 2201 2202 2203 2300 2301 2302 2303 2304 2305 2440 2441 2600 2610 2620 2644
Cyberpac La fecha tecleada es errnea Reportar al administrador del Faltan datos de pago Cyberpac Reportar al administrador del Pago no aceptado por el Cyberpac Cyberpac Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada Funcin temporalmente desactivada. Funcin temporalmente desactivada No hay conexin con la entidad emisora de la tarjeta. Funcin temporalmente desactivada. No hay conexin con la entidad emisora de la tarjeta. Funcin temporalmente desactivada. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Cuenta cancelada Cancelar el pago Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Su entidad ha denegado la operacion por motivos no detallados. Su entidad financiera ha denegado la Contacte con su entidad. operacin por motivos no detallados. Saldo disponible insuficiente Cancelar el pago Tarjeta no operativa Cancelar el pago Superado el lmite de disponibilidad Cancelar el pago Importe superior al lmite de la tarjeta Cancelar el pago Por favor, avise a "la Caixa" tan pronto como pueda. En breve Funcin temporalmente desactivada. quedar resuelto su problema. No se encontr su comercio en nuestros archivos. En breve se Existe una incidencia en la resolver su problema. aplicacin. No se encontr su comercio en nuestros archivos. Por favor, Existe una incidencia en la avise a "la Caixa". aplicacin. Reportar al administrador del Su comercio est dado de baja en nuestros archivos Cyberpac Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. No se encontr su terminal definido en nuestros archivos. Por Existe una incidencia en la favor, En breve se resolver su problema. aplicacin. Su Terminal est dado de baja en nuestros archivos. Por favor, Existe una incidencia en la En breve se resolver su problema. aplicacin. Reportar al administrador del Pago no aceptado por totpvcaixa Cyberpac Reportar al administrador del No podemos atender su peticin Cyberpac La tarjeta del cliente est marcada como bloqueada para la La tarjeta es invlida. Contacte con operativa con terminales de nuestra entidad. su entidad financiera. La tarjeta del cliente est marcada como perdida o robada en La tarjeta es invlida. Contacte con nuestros archivos. su entidad financiera. Reportar al administrador del Tarjeta marcada como falsificada en nuestros archivos Cyberpac Reportar al administrador del Tarjeta cancelada por terminales de la Caixa Cyberpac Reportar al administrador del Moneda no permitida por este comercio Cyberpac La moneda empleada en la operacin no est permitida para esta Moneda no permitida para esta fase de introduccin del Euro. operacin Tipo de tarjeta an no soportado por nuestra operativa. Contacte La tarjeta es invlida. Contacte con con "la Caixa". su entidad financiera. Reportar al administrador del Caducidad de la tarjeta superada Cyberpac Reportar al administrador del La operacin requiere el nmero secreto personal Cyberpac Tarj. Amex o Hispamer (Eurocard). Op. no autorizada Consultar entidad emisora de la La fecha tecleada es ilgica. (errnea)
36
2647 2648 2800 2801 2802 2900 3111 3113 3114 3118 3200 3202 3204 3211 3214 3215 3216 3499 3500 3550 3600 4002 4010 4012 4013 4014 4015 4016 4017 4018
4019 4020
tarjeta Corregir Cancelar el pago Funcin temporalmente desactivada. Existe una incidencia en la Venta fraccionada no permitida por la entidad o para la tarjeta. aplicacin. Existe una incidencia en la Cdigo de fraccionamiento inexistente. aplicacin. Reportar al administrador del Operacin no permitida Cyberpac Reportar al administrador del Superado nmero mximo de reintentos de PIN Cyberpac Fecha de caducidad incorrecta Corregir Nmero de tarjeta incorrecto Corregir Consultar entidad emisora de la Tarjeta 4B. Op. no autorizada tarjeta Reportar al administrador del La operacin no existe en nuestros archivos Cyberpac La operacin no se puede anular porque no se lleg a realizar Existe una incidencia en la completamente. aplicacin. Existe una incidencia en la No pueden anularse las operaciones no autorizadas. aplicacin. Est intentando anular una operacin con una tarjeta diferente a Existe una incidencia en la la de la operacin original. aplicacin. Est intentando anular una operacin con importe diferente al Existe una incidencia en la empleado en la operacin original. Y la tarjeta del cliente no es aplicacin. una 6000 de nuestra entidad. Est intentando anular una operacin con una moneda diferente Existe una incidencia en la a la que se utiliz para la operacin original. aplicacin. Est intentando anular una operacin con un comercio diferente Existe una incidencia en la a la que se utiliz para la operacin original "la Caixa". aplicacin. Por favor, avise a "la Caixa" tan pronto como pueda. En breve Funcin temporalmente desactivada. quedar resuelto su problema. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Por favor, avise a "la Caixa" tan pronto como pueda. En breve Funcin temporalmente desactivada. quedar resuelto su problema. Por favor, avise a "la Caixa" tan pronto como pueda. En breve Funcin temporalmente desactivada. quedar resuelto su problema. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Por favor, avise a "la Caixa" inmediatamente. Funcin temporalmente desactivada. Reportar al administrador del Tarjeta marcada como perdida o robada Cyberpac La tarjeta es invlida. Contacte con La tarjeta del cliente est cancelada. Contacte con "la Caixa". su entidad financiera. El importe es errneo o supera el El cliente ha sobrepasado el importe lmite por operacin. lmite por operacin. No hay conexin con la entidad emisora de la tarjeta. Funcin temporalmente desactivada. Reportar al administrador del Se ha tecleado incorrectamente el nmero secreto Cyberpac Su entidad financiera ha denegado la La operacin fue denegada por la entidad emisora de la tarjeta operacin por motivos no detallados. del cliente. Contacte con la entidad emisora. Contacte con su entidad. Su entidad financiera ha denegado la La operacin fue denegada por la entidad emisora de la tarjeta operacin por motivos no detallados. del cliente. Contacte con la entidad emisora. Contacte con su entidad. La tarjeta es invlida. Contacte con Tarjeta del cliente a retener. su entidad financiera. PIN incorrecto Superado lmite. Saldo disponible insuficiente No hay conexin con la entidad emisora de la tarjeta.
37
4021 4022 4024 4025 4026 4027 4028 4029 4030 4031 4032 4033 4034 4035 4036 4037 4038 4039 4040 4041 4042 4043 4044 4045 4046 4047 4048 4049 4050 4051 4052
La operacin fue denegada por la entidad emisora de la tarjeta del cliente. Contacte con la entidad emisora. La operacin fue denegada por la entidad emisora de la tarjeta del cliente. Contacte con la entidad emisora. No hay comunicacin con CECA, centro autorizado de su tarjeta No hay comunicacin con SEMP, centro autorizado de su tarjeta No hay comunicacin con el centro 2 de "la Caixa". La red dbito de la Caixa no est operativa La red a crdito de "la Caixa" no est operativa. Operacin no realizable por su entidad Su entidad o centro autorizador est fuera de servicio. Comercio no operativo en su centro autorizado La tarjeta de supervisor del comercio es invlida La tarjeta tiene la operativa restringida por su entidad. La tarjeta del cliente est inactiva o es desconocida La tarjeta no es valida para la red 6000. La tarjeta no es valida para intercambio. La tarjeta ha sido retenida Tarjeta bloqueada por su entidad La tarjeta est mal grabada El emisor de la tarjeta no es conocido. Su entidad o centro autorizado excede el tiempo lmite de respuesta El importe de la operacin supera el lmite establecido por su entidad. El importe de la operacin es menor que el lmite inferior establecido por su entidad. Operacin no autorizada por su entidad El importe supera el lmite disponible de la tarjeta. El importe supera el lmite disponible por el comercio. El importe supera el lmite disponible por operaciones internacionales Error en la fecha de caducidad de la tarjeta de cliente. Error en el formato criptogrfico del nmero personal El nmero personal tecleado es erroneo. Se ha excedido el nmero de errores del nmero personal. El formato de la transaccin es errneo
Su entidad financiera ha denegado la operacin por motivos no detallados. Contacte con su entidad. Su entidad financiera ha denegado la operacin por motivos no detallados. Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Funcin temporalmente desactivada. Reportar al administrador del Cyberpac Funcin temporalmente desactivada. Reportar al administrador del Cyberpac Funcin temporalmente desactivada. Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Su entidad financiera ha denegado la operacin por motivos no detallados. Contacte con su entidad. Cancelar pago La tarjeta es invlida. Contacte con su entidad financiera. La tarjeta es invlida. Contacte con su entidad financiera. Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Consulte a su entidad La tarjeta es invlida. Contacte con su entidad financiera. Reportar al administrador del Cyberpac El importe es errneo o supera el lmite disponible de la tarjeta. El importe de la operacin es menor que el lmite inferior establecido por su entidad. Cancelar pago El importe es errneo o supera el lmite disponible de la tarjeta. Existe una incidencia en la aplicacin. Reportar al administrador del Cyberpac La fecha de caducidad de la tarjeta tecleada es errnea. Reportar al administrador del Cyberpac El nmero secreto personal tecleado es errneo. Se ha excedido el nmero de errores mximo de nmero personal. Existe una incidencia en la aplicacin.
38
4053 4054 4055 4056 4057 4058 4059 4060 4061 4062 4063 4064 4065 4068 4100 4101 4102 4201 4500 4512 4600 4601 4602 4603 4606 4680 4683 4684 4687 4690 4691 4692
Reportar al administrador del Cyberpac La tarjeta del cliente est caducada Cancelar el pago La tarjeta es invlida. Contacte con La tarjeta del cliente no es procesable por el emisor. su entidad financiera. Reportar al administrador del La anulacin no es vlida por la operacin original Cyberpac Se ha producido una incidencia temporal en la aplicacin Reintentar o trucar al servei tcnic Su entidad ha denegado la operacin por motivos no detallados Consulte a su entidad El elevado trfico en las lneas impide que se pueda realizar la Reportar al administrador del operacin Cyberpac No hay comunicacin con CECA, centro autorizado de su Reportar al administrador del tarjeta, por problemas de saturacin Cyberpac No se ha tecleado el nmero secreto No se ha tecleado PIN. personal. Existe una incidencia en la La modalidad de pago fraccionado seleccionado no existe. aplicacin. El comercio o la tarjeta no tiene permitido pago fraccionado de Existe una incidencia en la operaciones. aplicacin. Existe una incidencia en la El comercio no est operativo en SEMP, su centro autorizador. aplicacin. Su entidad ha denegado la operacin por motivos no detallados Consulte a su entidad El importe de la operacin supera el lmite establecido por Cancelar el pago operacin La operacin fue denegada por la entidad emisora de la tarjeta Reportar al administrador del del cliente Cyberpac La operacin fue denegada por la entidad emisora de la tarjeta Su entidad financiera ha denegado la del cliente. Contacte con la entidad emisora. operacin por motivos no detallados. La operacin fue denegada por la entidad emisora de la tarjeta Su entidad financiera ha denegado la del cliente. Contacte con la entidad emisora. operacin por motivos no detallados. La tarjeta est bloqueada o caducada, o la entidad emisora de la Reportar al administrador del tarjeta no est permitida Cyberpac Existe una incidencia en la Por favor, avise a "la Caixa" inmediatamente. aplicacin. No hay conexin con el centro autorizador SEMP. Funcin temporalmente desactivada. Existe una incidencia en la Funcin temporalmente desactivada aplicacin. Reportar al administrador del No disponible recuperar la transaccin original Cyberpac Reportar al administrador del Nmero de referencia invlido Cyberpac Reportar al administrador del Nmero de referencia i pan incompatibles Cyberpac Reportar al administrador del Su peticin no puede ser cumplimentada Cyberpac Existe una incidencia en la Identificativo de mensaje no soportado por la aplicacin. aplicacin. Existe una incidencia en la Movimiento no cumple especificaciones de formato. aplicacin. Reportar al administrador del RTS no vlido Cyberpac Reportar al administrador del Mensaje no editable Cyberpac Reportar al administrador del Incidencia operativa en caixer Cyberpac Reportar al administrador del Telfono no soportado por el sistema Cyberpac Reportar al administrador del Intentos de telecode excedidos Cyberpac El terminal no est operativo en CECA, su centro autorizado
39
4693 8003 9999 100100
Denegada por diversos motivos Exceso de restriccin al puerto del PROXY Pruebas Test (referencia del pedido acabada en cero) No coinciden configuraciones ventana nueva/activa
Reportar al administrador del Cyberpac Reportar al administrador de su sistema Ver llamada y repositorio.
Errores posibles durante las devoluciones ( no estan exentos de producirse algunos de los anteriores):
CDIGO 30 32 300 301 302 303 304 305
CAUSA Error genrico Error en la validacin de usuario No existe un pago asociado a esta devolucin El importe de la devolucin supera el importe del pedido original El pedido original no est pagado El medio de pago original no soporta este tipo de devolucin Devolucin ya finalizada correctamente en una operacin anterior No existe ningn dato previo asociado a esta devolucin
Accin recomendada Volver a intentar Volver a intentar Reportar al administrador del Cyberpac Volver a intentar con un importe inferior Seleccionar un pedido pagado Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac Reportar al administrador del Cyberpac
40
ERRORES QUE PROVIENEN DE SIS

101 - Tarjeta caducada 102 - Tarjeta en excepcin transitoria o bajo sospecha de fraude 104 - OPeracin no permitida para esa tarjeta o terminal 106 - Intentos de PIN excedidos 107 - Contactar con el emisor 109 - Identificacin invalida de terminal o establecimiento. 112 - Se requiere PIN obligatorio 116 - Disponible insuficiente 117 - PIN Incorrecto 118 - Tarjeta no registrada 121 - Excede el limite de importe en anticipos de efectivo 126 - Bloque de PIN invlido 129 - Tarjeta no operativa (erro en CVV1/CVC1 o CVV2/CVC2 180 - Tarjeta ajena al servicio 181 - Tarjeta con restricciones dbito (Cuenta corriente) 182 - Tarjeta con restricicones crdito (Cuenta de crdito) 183 - Tarjeta con restricciones dbito (Cuenta de ahorro) 190 - Denegacin sin especificin de motivo 191 - Fecha de caducidad errnea
41
Apndice 2: Ejemplos vlidos de integracin de la llamada al Cyberpac

Los siguientes ejemplos se proporcionan a modo de ayuda, y de ningn modo forman parte del producto Cyberpac ni estn sujetos a mantenimiento. 1. Llamada a la CrURLtpv desde Net.Data (idem WNT y Unix) para MD5
%DEFINE { SHOWSQL="NO" CREAURL= %EXEC "D:/IBM/NetCommerce3/cgi-bin/URL/CrURLtpv.bat $(jped) $(jimp) $(jmoneda) $(jidioma) $(jmailcomp) > D:/IBM/NetCommerce3/macro/en_US/$(jped).inc %} (...) %HTML_REPORT{ <HTML><HEAD> <META HTTP-EQUIV=Expires CONTENT="Mon, 01 Jan 1996 01:01:01 GMT"> <script language="javascript"> function tpvlink(){ var nova=document.compra1.action; alert (nova) finestra=window.open(nova,"Servidor_la_Caixa","toolbar=no,directories=no,menuba r=no,status=yes,scrollbars=yes,width=620,height=540,resizable=yes");} </script> <BODY> @DTW_assign(jped,ordernum1) @DTW_assign(jimp,"3") @DTW_assign(jmoneda,"XEU") @DTW_assign(jidioma,"esp") @DTW_assign(jmailcomp,"pepe@mail.com") <form name="compra1" method=post ACTION='$(CREAURL)%include$(jped).inc> <tr><td><INPUT TYPE="button" value="Comprar" onClick="javascript:tpvlink()"></td> </tr></form></table> </BODY></HTML>
La Shell ejecuta: /usr/bin/jre -cp /usr/lpp/db2www/macro/tiendastpv/tpv.zip CrURLtpv / usr/lpp/db2www/macro/tiendastpv/ idpedido:$1 importe:$2 moneda:$3 idioma:$4 mailcomp:$5
2. Llamada a la CrURLtpv desde Perl para MD5
$ARG1="idpedido:1234"; $ARG2="importe:10.00"; $ARG... open (JRE, "/../jre -cp ddd $ARG1 $ARG2 $ARG... |"); $RESULTAT = chop(<JRE>);
42
print "$RESULTAT\n"; close(JRE);
3. Respuesta al notificador de la URL fija (Ejemplo para NT)

// Si la invocacin de CheckNOTtpv devuelve algo distinto de cero, Error=1 if error="1" then Response.Write("OK") else Response.Write("NOK")
4. Respuesta al notificador de la URL fija (Ejemplo para UNIX)

// Si la invocacin de CheckNOTtpv devuelve algo distinto de cero, Error if ($error!=0){ // sacamos por pantalla NOK printf "NOK\n"; else{ // sacamos por pantalla OK printf "OK\n"; }
5. Llamada a CheckNOTtpv desde C

#include <stdio.h> #include <fcntl.h> #include <sys/stat.h> #include <string.h> #include <stdlib.h> #include <time.h> #include <errno.h> #define LOWLONG 50 #define HIGHLONG 254 #define HHIGHLONG 1024 #define FILE_NAME.myfile.cnf" /* Declaracin de variables globales */ char adrremot[254]; char varURLwelcome[HIGHLONG]; char varURLerror[HIGHLONG]; char varServer[HIGHLONG], varLog[HIGHLONG], varPath[HIGHLONG]; char *bb[LOWLONG],*valor[HIGHLONG],*valorconf[HIGHLONG]; int GetCampo(char *URL,char *campo,char valor[255]) { char *result; int i,p=0,l=0; int cont=0,v=0; memset(valor,'\0',sizeof(valor)); if ((result=strstr(URL,campo))==NULL) { return 10002; } for (i=0;result[i]!='=';i++); for (p=i+1;result[p]!='&' && result[p]!='\0';p++) { valor[l]=result[p]; l++; }
43
return 0; } /*Fin GetCampo()*/
void pagina_error(char *b,int n) { char bb[HIGHLONG]; /* value[4] es el idioma de la URL */ /* se formatea el cdigo de error */ n=abs(n); sprintf(bb,"%s%d",b,n); printf ("Content-type: text/html%c%c",10,10); printf ("<HTML><HEAD><TITLE>CODE ERROR - %s:%d</TITLE>\n",b,n); printf ("</HEAD></HTML>\n"); exit(1); } void main() { char *chURL; char buffer[HIGHLONG],result[HIGHLONG],aux[HIGHLONG],resultaux[HIGHLONG]; char comandjava[255]; int nn,nn1,lon,cl,i,fin,auxr; char *auxcampo, *salida; char label[255], huella[255]; /* int jj=0; while(jj==0); */ strcpy(varURLerror,"/url_error/report?"); /* Referenciado con GET mtodo */ printf ("Content-type: text/html%c%c",10,10); if((getenv("REQUEST_METHOD"))==NULL) { pagina_error("000",40); } if(!memcmp(getenv("REQUEST_METHOD"),"GET",3)) { if((lon=strlen(getenv("QUERY_STRING")))==0) pagina_error("000",40); if((chURL=(char *)malloc(lon+1))==NULL) pagina_error("000",30); memset(chURL,'\0',lon+1); strcpy((char *)chURL,getenv("QUERY_STRING")); } /* end if referenced with a GET method */ /* Referenciado con POST mtodo */ if(!memcmp(getenv("REQUEST_METHOD"),"POST",4)) { if((cl=atoi(getenv("CONTENT_LENGTH")))==0) pagina_error("000",40); if((chURL=(char *)malloc(cl+1))==NULL) pagina_error("000",30); memset(chURL,'\0',lon+1); if ((fread(chURL,sizeof(char),cl,stdin))!=cl) pagina_error("000",41);
44
} /* end if referenced with a POST method */
if((getenv("REMOTE_ADDR"))==NULL) { pagina_error("000",40); } strcpy(adrremot,getenv("REMOTE_ADDR"));
salida=(char *)malloc(255); auxcampo=(char *)malloc(255); GetCampo(chURL,"moneda",auxcampo); strcpy(salida,auxcampo); /* printf("moneda:*%s*\n",auxcampo); */ free(auxcampo); auxcampo=(char *)malloc(255); GetCampo(chURL,"importe",auxcampo); strcat(salida,auxcampo); /* printf("importe:*%s*\n",auxcampo); */ free(auxcampo); auxcampo=(char *)malloc(255); GetCampo(chURL,"idpedido",auxcampo); strcat(salida,auxcampo); /* printf("idpedido:*%s*\n",auxcampo); */ free(auxcampo); auxcampo=(char *)malloc(255); GetCampo(chURL,"estado",auxcampo); /* printf("estado:*%s*\n",auxcampo); */ free(auxcampo); auxcampo=(char *)malloc(255); GetCampo(chURL,"diahora",auxcampo); /* printf("diahora:*%s*\n",auxcampo); */ free(auxcampo); auxcampo=(char *)malloc(255); GetCampo(chURL,"label",auxcampo); /* printf("label:*%s*\n",auxcampo); */ strcpy(label,auxcampo); free(auxcampo); auxcampo=(char *)malloc(255); GetCampo(chURL,"huella",auxcampo); strcpy(huella,auxcampo); /* printf("huella:*%s*\n",auxcampo); */ free(auxcampo); printf("<BR>parte para comprobar:%s label:%s huella:%s\n",salida,label,huella); sprintf(comandjava,"/usr/bin/jre -cp /usr/lpp/db2www/macro/tiendastpv/tpv.zip CheckNOTtpv /usr/lpp/db2www/macro/en_US/tiendastpv %s %s %s > /usr/lpp/internet/server_root/pub/cgi-bin/salirjava 2>&1",salida,label,huella); auxr=system(comandjava); printf("<BR>->%d",auxr); if(auxr==0) printf("OK"); else if(auxr==1) printf("NOK"); else if(auxr==2) printf("NOK"); else printf("NOK"); /*El cgi devuelve OK/NOK al tpvNotify*/ free(salida); /*printf("</BODY></HTML>"); */ free(valorconf[0]);
45
free(valor[0]); free(bb[0]); }
46

Tpvguia Cyberpac Caixa - Esp

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Tpvguia Cyberpac Caixa - Esp

Enviado por

Direitos autorais:

Formatos disponíveis

Cyberpac Gua de uso del comercio

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

2. Contratacin y alta de su comercio en el Cyberpac

9736 Gestin y Desarrollo de Banca Electrnica

3. Caractersticas del Cyberpac

3.1. Tipos de pago

9736 Gestin y Desarrollo de Banca Electrnica

3.2. Notificacin del pago

9736 Gestin y Desarrollo de Banca Electrnica

3.3. Solicitud de notificacin de pago

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

4.1. Instalacin en Windows NT

4.2. Instalacin en UNIX

9736 Gestin y Desarrollo de Banca Electrnica

4.3. Parmetros de instalacin

9736 Gestin y Desarrollo de Banca Electrnica

Tiempo de reserva de un pago

Por seguridad, se recomienda que el tiempo de reserva sea limitado.

4.4. Reinstalacin y desinstalacin

9736 Gestin y Desarrollo de Banca Electrnica

4.5. Contenido de la instalacin

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

idpedido - Identificador del pedido.

importe - Importe del pago.

idioma - Idioma utilizado en la operacin.

9736 Gestin y Desarrollo de Banca Electrnica

4.6.1. Formulario de datos del comprador

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

4.6.3 Ejemplos de llamada al CrURLtpv

9736 Gestin y Desarrollo de Banca Electrnica

Resultado: https://www.lacaixa.es/cgibin/totpvcaixa?idcom=XXX&idpedido=1234&moneda=XEU&importe=1000.00&idioma=en g&url_post_ok=&url_post_ko=&url_post_cancel=&mailcomp=&label=1&datos=8efbac963 d0f7e4e8c606c65a54e2e74

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

Resultado: https://www.lacaixa.es/cgi-bin/tpvwww/url_error.mac/report?error_code=6 debido

4.7. CheckNOTtpv: Verificacin de la notificacin HTTP

Pueden verse ejemplos activos en las demostraciones de la pgina de Internet www.lacaixa.es/tpv.html

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

5. Configuracin de su comercio en el repositorio

9736 Gestin y Desarrollo de Banca Electrnica

5.1. Modificar datos del comercio

9736 Gestin y Desarrollo de Banca Electrnica

Estado del comercio

Modo de llamada al pago

9736 Gestin y Desarrollo de Banca Electrnica

Tiempo mximo de espera para una reserva

Tiempo mximo de espera por el Cyberpac para realizar un pedido.

5.2. Modificar datos de usuario

5.3. Gestin de usuarios

9736 Gestin y Desarrollo de Banca Electrnica

5.4. Consulta/Devoluciones de pagos

Estado de los pedidos

9736 Gestin y Desarrollo de Banca Electrnica

9736 Gestin y Desarrollo de Banca Electrnica

5.5. Introduccin manual de pagos

5.6. Gestin de pagos preautorizados

9736 Gestin y Desarrollo de Banca Electrnica

return 0; } /Fin GetCampo()/