tpvguia cyberpac caixa_esp

Cyberpac

Guía de uso del comercio

Marzo 2003

9736 – Gestión y Desarrollo de Banca Electrónica

Contenido

Contenido ................................................................................................................................................ 2

1. Introducción ......................................................................................................................................... 3

2. Contratación y alta de su comercio en el Cyberpac ........................................................................... 5

3. Características del Cyberpac .............................................................................................................. 6

3.1. Tipos de pago ................................................................................................................................ 6

3.2. Notificación del pago ...................................................................................................................... 7

3.3. Solicitud de notificación de pago ................................................................................................... 8

4. Instalación ......................................................................................................................................... 10

4.1. Instalación en Windows NT ......................................................................................................... 10

4.2. Instalación en UNIX ..................................................................................................................... 10

4.3. Parámetros de instalación ........................................................................................................... 11

4.4. Reinstalación y desinstalación ..................................................................................................... 12

4.5. Contenido de la instalación .......................................................................................................... 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: Verificación de la notificación HTTP ................................................................... 21

5. Configuración de su comercio en el repositorio ................................................................................ 23

5.1. Modificar datos del comercio ....................................................................................................... 24

5.2. Modificar datos de usuario ........................................................................................................... 26

5.3. Gestión de usuarios ..................................................................................................................... 26

5.4. Consulta/Devoluciones de pagos ................................................................................................ 27

5.4.1. Devoluciones ........................................................................................................................... 28

5.5. Introducción manual de pagos ..................................................................................................... 29

5.6. Gestión de pagos preautorizados ................................................................................................ 29

6. Paso a Producción ............................................................................................................................ 31

7. Resolución de problemas.................................................................................................................. 32

Apéndice 1: Errores devueltos por el Cyberpac ................................................................................... 34

ERRORES QUE PROVIENEN DE SIS ................................................................................................ 41

Apéndice 2: Ejemplos válidos de integración de la llamada al Cyberpac ............................................ 42


3

1. Introducción

Con el Cyberpac de “la Caixa” cualquier comercio virtual autorizado puede generar, desde

sus páginas 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 botón de pago se establece conexión segura, en SSL3 de 128 bits, con el

Cyberpac. El servidor del comercio no tiene porque estar en servidor seguro. Sí lo están las

páginas 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 envío del producto desde la aplicación de gestión del Cyberpac.

Los detalles de la operación relativos a los datos de pago del comprador (número de tarjeta,

fecha de caducidad, número secreto, etc.), no son visibles desde el Cyberpac por el

comercio. Del mismo modo, “la Caixa” desconoce cuáles son los productos adquiridos y,

dependiendo de la opción escogida, los datos personales del comprador, la dirección de

entrega o cualquier otro dato requerido por el comercio para formalizar la compra.

En las páginas del Cyberpac se visualiza el nombre y logo de la entidad, el número 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 confirmación del pago, en el caso que nos lo solicite, y será informado del

resultado de la operación mediante una página html. Finalmente, el cliente sigue la

navegación por las páginas del comercio. Es posible, para el comerciante, indicar páginas de

retorno diferentes, dependiendo de que el pago se haya realizado correctamente, haya

acabado con algún error o haya sido cancelado por el comprador.

El comercio puede recibir información online vía E-Mail y/o vía HTTP de cada pago

efectuado, recibirla en E-Mail de resumen diario o acceder, en cualquier momento, al menú

de administración de la aplicación 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 través de la opción de Tarjeta, Transferencias o Domiciliaciones,

desde la propia aplicación de gestión del Cyberpac.


4

El Cyberpac ofrece la opción al comprador de fraccionar el pago en la página de petición 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 opción de

fraccionamiento sólo está disponible en el caso de que el comprador introduzca una tarjeta de

crédito de “la Caixa”.

Mediante el Cyberpac se podrán 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 envía una

transacción segura al servidor de “la Caixa” para hacer una validación 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 envía la segunda

transacción, que es la que se cargará al cliente.

El Cyberpac soporta multiidioma (catalán, castellano e inglés) y multimoneda, aunque

actualmente sólo está operativa la moneda Euro, y no tiene incompatibilidad el resto de

pasarelas de pago por Internet de otras entidades.

También 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 página web del

comercio. Esta opción es la Introducción manual de pagos o reentry (vea el apartado 6.5

Introducción manual de pagos).


5

2. Contratación y alta de su comercio en el Cyberpac

Le informamos que para obtener el software y copias del manual de instalación 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 operación. Las

condiciones económicas se concretarán con la oficina de “la Caixa” con la que esté

vinculado.

El comercio recibe, via mail, del administrador del Cyberpac un código de usuario, una

password y un identificador de comercio. La password puede ser modificada en cada

conexión.

Este usuario será el utilizado para acceder a la aplicación de administración de su comercio

en el Cyberpac. Esta aplicación 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 efectúa una simulación del mismo. El objetivo es que usted pueda realizar las pruebas

de integración de su comercio en el Cyberpac.

El abono de las liquidaciones al comercio respecto a los pagos con tarjeta se efectúa según la

periodicidad acordada (diaria, semanal, quincenal o mensual) y, simultáneamente se efectúa

el cargo de los descuentos correspondientes. El cargo de las operaciones del Cyberpac se

abonan igual que con los TPV físicos.

El abono de las domiciliaciones se efectúa después de enviar el fichero, que crea el Cyberpac

en la consulta de pagos, con el servicio de Línea Abierta Web.

El abono de las transferencias realizadas por Línea Abierta es on line. Respecto a las

transferencias de clientes que no utilizan la Línea Abierta, el abono se efectúa cuando éste la

realiza. En este momento, el comercio puede actualizar, el estado de la operación a “pagado”.

También se puede modificar el estado de los pedidos que se realizan mediante

contrareembolso a “pagado”.

El Cyberpac es de fácil instalación, pero necesita de una figura informática que sepa adaptar

la tienda al sistema de pago. Es responsabilidad del comercio aportar este conocimiento, bien

por experiencia propia, o por la contratación 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 ningún tipo de compromiso. En este

caso le recomendamos que envíe un E-Mail a [email protected] solicitando dicho contacto.

http://www.lacaixa.es/tpv.html

https://www3.lacaixa.es/[email protected]


6

3. Características del Cyberpac

3.1. Tipos de pago

El Cyberpac acepta los siguientes tipos de pago:

Tarjetas: se acepta cualquier tarjeta de crédito o débito 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 máxima seguridad en las ventas, la configuración estándard

del Cyberpac de “la Caixa” no admite pagos realizados con cualquier tarjeta de crédito o débito. Sólo 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 prestación consiste en que el cliente que compre en el

comercio y efectue el pago con una tarjeta de crédito 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 automático. Para más información visite http://www.lacaixa.es/tarjetas.

Tarjetas emitidas por otras entidades bancarias: Tarjetas Visa, Mastercard, JCB y 6000 de otras

entidades. Debe solicitar esta opción en su oficina de “la Caixa”.

Transferencia bancaria: el comprador puede elegir entre su procedimiento habitual o la

Línea Abierta Web de “la Caixa”, en caso de que sea cliente.

- Si es cliente de “la Caixa” y tiene contratado el servicio Línea 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 depósito asociado.

- Si no es cliente de “la Caixa” o no ha contratado el servicio Línea 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 número de la cuenta y el nombre

del titular. La domiciliación se realizará automáticamente. El comercio debe realizar los

siguientes pasos para completar el pago:

- Escoger en la lista “Tipo de Pago” la opción “Domiciliaciones”.

- Escoger en la lista “Estado del Pago” la opción “Domiciliado”.

- Introducir el intervalo de fechas de los recibos que desee domiciliar.

- Crear el fichero de domiciliaciones. En Euros.


7

- En la pantalla siguiente se informa de la creación 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 Línea Abierta Web y desde el apartado

“Transferencias de ficheros/Envío” proceder al envío de dicho fichero.

- A partir de aquí, el fichero seguirá el procedimiento de validación y abono posterior

según el contrato TIR.

Para que un comercio pueda aceptar el pago a través de domiciliaciones, debe cumplir los

siguientes requisitos:

- Tener un contrato de Línea Abierta Web

- Tener un contrato de la aplicación TIR que es la que permite el envío 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 opción http://www.lacaixa.es/comercio.

Contrareembolso: El cliente efectuará el pago del pedido realizado en el momento de

entrega del producto, según las condiciones establecidas por el comercio. El comercio

pasará vía Internet al Cyberpac los datos de envío del comprador ( los datos del

comprador es obligatorio que se envíen por parámetro 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. Notificación del pago

El Cyberpac de “la Caixa” realiza diferentes notificaciones de pago, tanto al comprador como

al comercio:

Notificación al comprador: Se le enviará un correo electrónico en el caso de que lo haya

solicitado en la página inicial del Cyberpac.

Notificación al comercio: Debe configurarlo en www.lacaixa.es/tpv, gestión del

comercio.

- E-Mail online, se envía un E-Mail a la dirección especificada en el cuadro de texto,

comunicando hora, número de pedido, importe, moneda y resultado de

la operación de pago. Se envía después de cada pago realizado correctamente.

- E-Mail batch, se envía un E-Mail a la dirección especificada en el cuadro de texto,

comunicándole una URL donde tendrá que dirigirse para consultar el resumen diario

de pagos.

- URL fija o notificación HTTP, es un módulo (macro, cgi, rutina, asp, …) diseñado

por el comercio en el que el Cyberpac notifica, en método post, la finalización del

http://www.lacaixa.es/comercio

http://www.lacaixa.es/tpv


8

pago mediante una sesión HTTP establecida en el momento del mismo. Esta

notificación sirve para que el comercio pueda tener más control sobre su base de datos

de productos y pueda actualizar el stock automáticamente después de realizar cada

pedido. “la Caixa” llama a la URL especificada en este cuadro de texto, pasando los

siguientes parámetros (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 Línea Abierta Web no se ha finalizado), estado=10

equivale al pago realizado mediante domiciliación, estado=11 equivale a transferencia a ingresar,

estado=16 equivale a pago pendienet de contrareembolso y estado=-1 se refiere a pago erróneo. El

parámetro dia-hora no se está utilizando actualmente.

La notificación automática y online de estos datos, permite al comercio hacer un

tratamiento específico de ese pedido (actualizar existencias y datos de pedidos en curso,

generar procesos de comprobación y distribución, explotar y/o actualizar el registro de

usuario, etc.) y, de ese modo, sincronizar su sistema de acuerdo con el resultado del

pago.

El módulo elegido por el comercio debe devolver ‘OK’ o ‘NOK’ mediante una sesión

HTTP y con la instrucción correspondiente de la salida estándard (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 instrucción de código HTML. El notificador realiza 3

intentos con intervalos de 3 minutos. Si no recibe respuesta registrará un timeout.

Ver ejemplos en el apéndice 2.

En la notificación online una vez finalizado el pago, el parámetro estado únicamente

podrá tomar el valor 1, 3, 10 o 11 o 16, es decir, que la URL fija recibirá notificación

para todos los pedidos, a excepción de los pendientes y los erróneos.

El Cyberpac suministra la utilidad local Java CheckNOTtpv para que se valide, si se

desea, la autenticidad de la notificación de pago (ver descripción en el capítulo de

“Utilidades del Cyberpac”).

El uso de la URL fija requiere tener activa la opción E-Mail online.

- Activar notificación del Pago diferido, al tener activada esta opción los pedidos que

se realicen mediante pago diferido (XML), el resultado de los mismos se notificará a la

URL fija o notificación HTML.

3.3. Solicitud de notificación de pago

En el caso de que se produjera un error en la sesión HTTP y la URL fija no recibiera los

parámetros, se podría confirmar el estado de un pago realizando una consulta del estado del


9

mismo mediante el módulo Java CrURLtpv. Para diferenciar un pago de una consulta se

utilizará el parámetro ’action’. La invocación al CrURLtpv consistirá, en el caso de una

consulta, en pasarle los parámetros ‘idpedido’ y ‘action=c”.

En este caso, el valor del parámetro ‘estado’ si que podrá ser <0/1/3/10/11/16/-1>, es decir, se

notifican todos los pedidos incluidos los pendientes y los erróneos.

Para el caso de un pago no se introducía el parámetro action, siendo el módulo CrURLtpv el que lo generaba

(action=p) dinámicamente al interpretar la ausencia de éste como la creación 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/cgi-

bin/totpvcaixa?idcom=XXX&idpedido=1234&action=c&label=5&datos=dd3441718bcfce83

e617351c38bce4af

Cuando el Cyberpac recibe una petición de consulta, valida el campo datos, y notifica el

estado del pago a la URL fija. Además, muestra OK o NOK por navegación según si ha

habido algún error en el proceso de consulta. El motivo de mostrar estos valores es servir la

petición 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 notificación de pago (ver descripción en el capítulo 5.7).

El uso de la URL fija requiere tener activa la opción E-Mail online.


10

4. Instalación

Debe descargar en su servidor el paquete del Cyberpac adecuado a su sistema operativo y

proceder a su instalación. Los sistemas operativos para los que existe paquete de instalación

son: Windows NT y UNIX.

Podrá encontrarlos en la aplicación de gestión de la página web:

http://www.lacaixa.es/tpv.html a la que podrá acceder con el usuario y contraseña dados por

el administrador del Cyberpac.

Puede customizar el autoinstalador para cualquier sistema operativo. El único requisito del

Cyberpac es el módulo Java 1.1.5.

Nota: Para versiones superiores del jdk posiblemente se deberán 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. Instalación en Windows NT

Para poder utilizar esta aplicación, debe tener instalado Windows NT y el intérprete de Java

1.1.5, que podrá descargar junto con el autoinstalador.

4.2. Instalación en UNIX

Para poder utilizar esta aplicación, debe tener instalado AIX 4.x y el intérprete de Java 1.1.6.

La aplicación sólo está homologada para la versión 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 versión de sistema operativo, debe editar el

autoinstalador y modificarlo para los parámetros concretos de su software. En el caso de

Linux Intel la versión correcta de jdk es la 1.2.2.

Se recomienda la ejecución de la instalación 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 continuación deberá

ejecutar la shell script de instalación: tpvinstall. Debe seguir las instrucciones que se le

indican en el proceso de la instalación. Se asume que el path para la korn shell es

/usr/bin/ksh; en caso contrario, deberá modificar la primera línea 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, después de instalar el

Cyberpac.



11

Una vez finalizada la instalación y antes de ejecutar la aplicación, deberá añadir a la variable

de entorno CLASSPATH de su sistema el path del directorio de instalación.

Nota: En Linux y con Netscape 4.06, el cambio de claves de acceso al repositorio no funciona correctamente.

4.3. Parámetros de instalación

Los parámetros que se describen a continuación se almacenarán en un fichero de

configuración, una vez concluida la instalación.

En cualquier caso, estos parámetros deben coincidir con los que usted indique para su

comercio en el Cyberpac, mediante la aplicación de administración que se suministra en

www.lacaixa.es/tpv.html

Identificador de comercio

Es el código que le identifica en el servidor de pagos del Cyberpac. Suministrado en la

notificación 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 opción esté activada.

Claves

El programa de instalación le pedirá que introduzca las 5 claves de (mínimo) 16 a 32

caracteres numéricos que va a utilizar para generar la firma criptográfica. Debe introducir al

menos una, pero es recomendable que introduzca las cinco.

Estas claves deben ser las mismas que introduzca desde el menú de administración de su

comercio, en el sistema de datos del Cyberpac en www.lacaixa.es/tpv.html

La utilidad CrURLtpv escogerá, aleatoriamente, una en cada operación 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 algún parámetro 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 “Resolución de problemas” al final de esta guía.


12

Proxy y puerto

En caso de que utilice alterno para acceder a Internet, deberá indicarlo durante el proceso de

instalación. Debe introducir el nombre del proxy, no su dirección 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 máximo de reserva para sus pagos, existen dos campos para

configurarlo. Uno de ellos es el tiempo máximo 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 sería +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 comprobación es el siguiente:

- Se consulta la fecha y hora de la URL de invocación. En el caso de que no existiera,

se realizaría 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 realizaría el siguiente paso.

- Se consulta la fecha y hora en el fichero de configuración general del Cyberpac, que

por defecto, es de 30 minutos a partir de la primera invocación para realizar el pago.

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

4.4. Reinstalación y desinstalación

Una vez instalada la aplicación en el directorio elegido, puede modificar alguno de los

parámetros de configuración mediante la reinstalación al mismo directorio.

No intente editar el fichero de configuración para modificar sus datos. Utilice siempre la

instalación para cambiar cualquier parámetro. Recuerde que los valores que configure

localmente deben de coincidir, obligatoriamente, con los que haya configurado para el mismo

comercio a través de la aplicación de administración del Cyberpac en

http://www.lacaixa.es/tpv.html Si no es así, sus órdenes de pago generarán errores cuando el

Cyberpac verifique sus datos, y éstas no podrán concluir correctamente.



13

Si desea reinstalar el Cyberpac en un directorio distinto, deberá desinstalarlo primero y

volver a instalar en el nuevo destino.

Desinstalación sobre Windows NT

Si desea desinstalar la aplicación "Cyberpac", abra la opción de "Agregar o quitar

programas", que encontrará en Configuración - Panel de Control. Seleccione "Cyberpac" y

pulse "Agregar o quitar programas".

4.5. Contenido de la instalación

La instalación crea un fichero de configuración tpv.cnf que es único para cada comercio.

tpv.zip - Clases Java empaquetadas.

tpv.cnf - Fichero de configuración.

leeme.txt - Información sobre el producto.

Uninst.isu - Información para desinstalar el producto.

CrURLtpv.bat - Ejemplo de llamada a CrURLtpv.

CheckNOTtpv.bat - Ejemplo de llamada a CheckNOTtpv.

Fichero de configuración tpv.cnf

Contiene líneas con el formato variable=valor

1. TPVcgi_name=totpvcaixa?

2. TPV_secure=1

3. TPV_merchant_ID=id comercio (consúltelo en el repositorio, pero normalmente coincide con el

usuario recibido en la notificación de “la Caixa”).

4. URL_ERROR_DATOS=”https://(...)cgi-bin/modulo1/error” (opcional)

5. TPV_SEEDn=xxxxxxxxxx (Claves 1 a 5 para cifrado en formato propio) (*)

6. proxy=true/false

7. port=nº de puerto/false

8. timeout=nº de minutos (actualmente este parámetro está obsoleto y está en desuso)

9. timeoutreserva=nº de minutos de reserva desde que realiza el pedido hasta que lo paga.

10. diferenciahoraria=nº de horas de diferencia con el GMT (si se pone cualquier otra ref. no

funciona. Debe contener algún valor).


14

4.6. CrURLtpv

Esta utilidad sirve para generar el enlace de llamada al Cyberpac. La respuesta es la URL que

debe insertar en la página de pago de su comercio.

La llamada debe generarla en la línea de comandos (o mediante el shell de su lenguaje de

programación), con una serie de parámetros (unos obligatorios y otros optativos), y capturar

el resultado. La aplicación devuelve, por la salida estándard del sistema, la URL de pago

cifrada en MD5 para garantizar su no manipulación. Ponga esa URL en el enlace del botón de

compra y obtendrá su conexión con el Cyberpac de "la Caixa".

Las páginas de pago del Cyberpac aparecerán en la ventana en curso, y al finalizar se llamará

a la URL de fin de pago de OK, NOK o CANCEL, según el resultado de la operación. Debe

haber configurado su comercio para ejecutarse en la misma sesión y con página completa (sin

frames), de otra manera se pueden dar resultados indeseados puesto que la aplicación puede

verificar dinámicamente este valor, pero no corregir una llamada incorrecta.

En caso de que se introduzca algún parámetro erróneo, la utilidad genera un

RETURN_CODE, que puede ser capturado dinámicamente por su sistema. Si no se aborta la

ejecución, se genera una llamada a la URL de error de datos (ver el apartado "Resolución de

problemas” para más información 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 información.

prueba.c - Ejemplos de llamada en C al MD5.

Md5.c - Algoritmo de cifrado.

Md5.h - Algoritmo de cifrado.

La firma o huella de autenticación se genera a partir de los parámetros del pago, del

identificador de comercio proporcionado por la notificación de “la Caixa” y que la utilidad

CrURLtpv lee del fichero de configuración, y de la elección aleatoria de una de las claves

instaladas por el administrador del comercio. Se añade al enlace dinámico de pago la

referencia de la etiqueta de la clave utilizada.

El fichero CrURLtpv.bat puede modificarse según sus necesidades.

El formato de los parámetros es el siguiente: nombre_parámetro:contenido

El orden de los parámetros es irrelevante, excepto el de los dos primeros parámetros

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 configuración del Cyberpac.


15

idpedido - Identificador del pedido.

La longitud del código de pedido debe tener entre 4 y 12 caracteres alfanuméricos, y las 4

primeras posiciones deben ser obligatoriamente numéricas. En caso de que el Cyberpac

reciba un identificador de pedido inferior o superior a 4 o 12 caracteres alfanuméricos

respectivamente, o las primeras 4 posiciones no sean numéricas, provocará un error i no se

podrá realizar la operación.

No se podrá reutilizar el mismo número de pedido independientemente del estado definitivo

del mismo.

moneda - Divisa utilizada en el pago.

"XEU" para Euros.

importe - Importe del pago.

Debe ser numérico. Dos decimales obligatorios. La separación entre el número entero y los decimales tiene que

ser un punto, por ejemplo: 83424.32

idioma - Idioma utilizado en la operación.

"cat" para catalán, "esp" para castellano y "eng" para inglés.

Los parámetros opcionales son los siguientes:

URLs de fin de pago – En caso que no se especifiquen en la aplicación de administración

www.lacaixa.es/tpv.html. Los parámetros son: url_post_ok, url_post_ko, url_post_cancel.

Si no se especifica la URL y no existe ninguna en la configuración del comercio, el pago

se intentará igualmente, pero no se podrá volver por navegación a las páginas del

comercio.

Las URLs deben escribirse con el nombre completo, especificando "http://".

El Cyberpac añade dinámicamente, a la URL correspondiente, los parámetros: idpedido,

idcom, idioma, de modo que el comercio puede personalizar el regreso del cliente a su

web.

mailcomp - Dirección 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 páginas de pago del Cyberpac

conceden al comprador la posibilidad de indicar su dirección E-Mail.

El Cyberpac enviará un E-Mail al comprador informando del resultado del pago.



16

mpago – Preinformación del método de pago.

Es un string de longitud 20, esta cadena de letras que se pasa a mayúsculas 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 podrán añadir nuevos medios más 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.

Parámetros opcionales para personalizar el pago (ver apartado 5.6.1) y el parámetro para

configurar los pedidos con preautorización (ver apartado 5.6.2).

Antes de la invocación 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

configuración), tipo de notificación (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 numeración: 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 envío del comprador directamente desde el Cyberpac.

De esta forma, no hace falta crear un formulario y una base de datos de gestión del mismo.

La base de datos del Cyberpac la podrá utilizar para guardar la información del envío y de los

clientes. En la página del Cyberpac se pedirá el nombre, apellidos, dirección, código postal,

etc. del cliente referente al destino del envío del pedido.

Para realizarlo debe pasar los siguientes parámetros 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: Número de teléfono del comprador.

titulo: señor/señora (castellano), senyor/senyora (catalán), mr./mrs. (inglés).


17

pedmodif: Según 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 parámetro,

con el valor “no” debe ir acompañado de algún parámetro 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 parámetro 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

parámetros que no se hayan cumplimentado, siendo obligatorio para el comprador

cumplimentar todos los datos personales, a excepción del E-Mail o el teléfono. Uno de

los dos se puede omitir.

Los distintos parámetros pueden contener caracteres especiales, o estar compuestos por varias

palabras.

Por ejemplo: nombre: José Luís, o dirección: Av. Diagonal, 571 4º 2ª.

La longitudes máximas de estos parámetros son:

Nombre: 40

Apellido1: 30

Apellido2: 30

Direccion: 50

CP: 5

Ciudad: 20

Provincia: 30

Pais: 30

Telefono: 12

Cada parámetro que se le pase a la utilidad de creación de enlaces debe estar compuesto de

un único string y se debe hacer el URLEncode (función escape de javascript) de cada

parámetro antes de pasarlo. Con esto se consigue transformar varios strings en uno sólo, y

transformar también los caracteres especiales en una notación común. La clase

java.net.URLEncode es una clase java que viene en cualquier jdk y por lo tanto fácilmente

accesible. Ver ejemplos en el Apéndice 1.

Si conoce los datos financieros del comprador, puede pasarlos al Cyberpac mediante los

siguientes parámetros. De esta forma, el comercio puede facilitar los pagos de sus usuarios

registrados, realizar actualización de suscripciones, etc.

pan – Número de tarjeta con el que se realizará el pago.

mes - Mes de la fecha de caducidad de la tarjeta. Serán como máximo dos dígitos.

any - Año de la fecha de caducidad de la tarjeta. Serán como máximo dos dígitos.

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


18

modificables, ya que en ese caso se realizará una verificación del número de tarjeta en la

página de pago, y de esta manera se asegura que no se envíen números de tarjeta

inválidos en la transacción a “la Caixa”. En caso de enviar alguno de los parámetros de

información de tarjeta (pan, mes o any) se deberá enviar este parámetro obligatoriamente.

4.6.2. Preautorizaciones

Para indicar al Cyberpac que el pedido que se va a realizar será una preautorización se debe

de indicar mediante el parámetro pautor. La posibilidad de preautorizar un pago sólo está

disponible para el método de pago de Tarjeta.

pautor: Preautorización de la tarjeta del pago.

Número 1/0, esta variable viaja al Cyberpac en la URL sólo 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 realización a posterior.

4.6.3 Ejemplos de llamada al CrURLtpv

Donde XXX = identificador de comercio, único para cada tienda. XXX se sustituye

automáticamente por el dato TPV_merchant_ID = id comercio del fichero de configuración.

1. Invocación correcta al .bat crURLtpv

crURLtpv idpedido:1234 importe:1000.00 moneda:XEU idioma:esp

mailcomp:[email protected]

Resultado:


bin/totpvcaixa?idcom=XXX&idpedido=1234&moneda=XEU&importe=1000.00&idioma=es

p&url_post_ok=&url_post_ko=&url_post_cancel=&[email protected]&action=

p&datatimeout=&label=3&datos=6b7bae7bc90e43948632f7eaa440d3ca

En Linux debe ejecutarse como jre CrURLtpv path_instalación idpedido:1234

importe:1000.00 moneda:XEU idioma:esp mailcomp:[email protected]

2. Invocación correcta al .bat crURLtpv, en idioma Inglés y moneda Euros

Invocación: crURLtpv idpedido:1234 importe:1000.00 moneda:XEU idioma:eng


19

Resultado:


bin/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. Invocación correcta con los datos de pedido y de tarjeta

Invocación: 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


pan:4548032003933011 mes:03 any:03

Resultado: https://www.lacaixa.es/cgi-

bin/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&[email protected]&actio

n=p&datatimeout=&pan=4548032003933011&mes=03&any=03tarmodif=si&label=2&datos

=4fdadd4fabb3edd53c5320091aabdcc1

4. Invocación correcta al .bat crURLtpv, con el parámetro de preautorización e

indicando que el pago es con tarjeta de “la Caixa”

Invocación: crURLtpv idpedido:40404 importe:10.00 moneda:XEU idioma:esp pautor:1

mpago:T


bin/totpvcaixa?idcom=XXX&idpedido=40404&moneda=XEU&importe=10.00&idioma=esp

&mpago=TXXXXXXXXXXXXXXXXXXX&pautor=1&label=5&datos=0987c2daaffa64a3

019541e489da884e

5. Invocación correcta con los parámetros del cliente ( posibilidad de pago mediante

contrareembolso )

Previamente a la generación de la URL para llamar al Cyberpac debe utilizar la clase java.net.URLEncode para

los parámetros que contengan un string o la función escape de javascript, por ejemplo:

String nombre = java.net.URLEncoder.encode(“José Luís”);

String nombre = escape(“José Luís”);


20

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 utilizaríamos:

nombre:Jos%E9+Lu%EDs

dirección:Av.Diagonal%2C+571+4%BA+2%AA

Además, para el parámetro título tendríamos un caso especial cuando el idioma es castellano, ya que la ‘ñ’ es un

carácter especial. Así, en lugar de pasar señor/señora, pasaríamos se%F1or/se%F1ora.

Invocación: 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


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


bin/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&[email protected]&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. Invocación incorrecta por error de parámetro (URL de error de datos própia, definida

en la instalación).

jre -cp directori_inst\tpv.zip; CrURLtpv moneda:xeu idioma:esp importe:14.77

idpedido:1234


21

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

que el valor del parámetro moneda tiene que ser mayúsculas.

Ver ejemplo1 en el apéndice 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 máximo de reserva, la aplicación realiza los cálculos

oportunos para enviar la fecha y la hora, sincronizada con la de Barcelona.

4.7. CheckNOTtpv: Verificación de la notificación HTTP

Sólo en comercio complejo con MD5.

Una vez recibida la notificación del pago en esta URL fija, el comercio puede verificar la

autenticidad del mensaje y su procedencia mediante la invocación de la utilidad

CheckNOTtpv con los parámetros recibidos.

Para validar la firma MD5 de una notificación de pagos recibida desde el Cyberpac de "la

Caixa", puede llamar a CheckNOTtpv con los parámetros 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 estándard 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 configuración.

En Unix, se tienen que validar los return codes para que haga el echo correspondiente. Para capturar el código

de retorno deben hacer echo $.

1 Pueden verse ejemplos activos en las demostraciones de la página de Internet www.lacaixa.es/tpv.html


22

Ejemplos de llamada a CheckNOTtpv

Invocación: CheckNOTtpv XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35

Invocación: jre -cp directori_inst\tpv.zip; CheckNOTtpv XEU1000.001234 2

3af706254e5dfd353af706254e5dfd35

Invocación en Linux: jre -cp directori_inst\tpv.zip; CheckNOTtpv tpv_path

XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35


23

5. Configuración de su comercio en el repositorio

El repositorio del Cyberpac de “la Caixa” son unas páginas de Internet que le permiten

visualizar unas demostraciones y obtener el software de la aplicación. Puede también bajar

copias de este documento guía, configurar el usuario y su comercio, y visualizar los datos de

las ventas realizadas.

Encontrará estas páginas en la dirección: http://www.lacaixa.es/tpv.html

Usuario y password

En primer lugar, usted debe acceder a la página 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 aplicación de gestión se genera una

clave única de acceso. Esta clave garantiza que sólo puede existir una sesión 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 página de la aplicación en su

lista de favoritos, ni utilizar las teclas de “Atrás”, “Adelante” o “Recargar”de su navegador,

sinó que obligatoriamente debe utilizar los enlaces de navegación de la aplicación.

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 histórico

- Introducción manual de pagos

- Pagos preautorizados

Tenga en cuenta que todos los accesos están autenticados por la clave única. Nadie más que

el usuario administrador - y eso desde una única sesión - puede tener acceso a la

administración del Cyberpac.



24

5.1. Modificar datos del comercio

Usted accede a la consulta y/o modificación de los siguientes datos de configuración de su

comercio. Los cambios son efectivos en la primera operación después de la modificación.

Los marcados en cursiva sólo pueden ser modificados por el administrador del Cyberpac.

Identificador de comercio

Identifica su comercio en las llamadas dinámicas de pago al Cyberpac.

Nombre del comercio

Nombre que aparece identificando su comercio en las páginas del Cyberpac.

Icono del comercio

Mediante esta opción, usted puede exportar al sistema del Cyberpac el logotipo de su

comercio que quiere que aparezca en las páginas 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 envía, validación de los datos de pago por firma o huella

criptográfica (encriptación de MD5).

Claves

Sólo en el caso de comercio complejo con MD5. Mediante la opción “Editar claves”, usted

puede introducir las 5 claves, de 16 a 32 caracteres, que introdujo en local durante la

instalación. Cualquier cambio, en cualquiera de las claves de cifrado, debe actualizarse tanto

aquí como en su configuración local. Para ello, debe reinstalar el Cyberpac en su sistema.

Tipos de notificación

Sistemas utilizados por el Cyberpac para comunicar al comercio la finalización 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 después de

finalizar el proceso de pago. Las URLs de fin de pago posibles son:

- Pago correcto: Página a la que volver si el pago concluye correctamente.

- Pago incorrecto: Página a la que volver si el pago no concluye correctamente.

- Pago cancelado: Página a la que volver si el pago es cancelado por el usuario.


25

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 estáticos o documentos dinámicos.

Las URL’s dinámicas permiten la personalización del retorno del comprador al web del

comercio. Para esto, el Cyberpac añade los parámetros particulares de la operación:

idpedido=idpedido&idioma=idioma&idcom=idcom

El Cyberpac admite 2 tipos de URLs de fin de pago:

- Variable: Especificada en cada llamada, invocación 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 efectúan 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 numeración:

4548032003933011. La fecha de caducidad y el PIN pueden ser cualquiera.

Nota: Para emular los pagos incorrectos, se devuelve error en todos los pagos

cuyo identificador de pedido acaba en cero.

- Producción: Los pagos se efectúan 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 sesión de pago en el Cyberpac corra en la misma sesión que la

navegación por el comercio, y además, que la página 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 recomendación 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,”título de la ventana”,”toolbar=no, directories=no, menubar=no, status=yes,

scrollbars=yes, width=620, height=540, resizable=yes”);

}


26

Es importante especificar correctamente el modo de llamada, para que la conclusión de la sesión de pago en el

Cyberpac no genere error en el navegador del comprador.

Tiempo máximo de espera para una reserva

Tiempo máximo de espera por el Cyberpac para realizar un pedido.

5.2. Modificar datos de usuario

Usted puede indicar los parámetros siguientes del usuario conectado utilizando la aplicación

de gestión del Cyberpac www.lacaixa.es/tpv.html

Parámetros: Nombre y Apellidos, Dirección, Província, Ciudad y País, Teléfono y E-mail,

Idioma (Catalán / Español).

5.3. Gestión de usuarios

El usuario administrador del comercio puede crear usuarios para que puedan acceder al

comercio. Estos usuarios tendrán el acceso limitado a las páginas del repositorio del

Cyberpac.

Nuevo usuario

Crea un usuario que podrá acceder al repositorio del comercio. Los parámetros que se piden

son: tipo de usuario (operador/helpdesk)2*, contraseña (alfanumérica entre 6 y 8 caracteres),

validación de la contraseña, descripción del usuario, nombre, apellidos, dirección, ciudad,

provincia, teléfono, país, idioma (catalán/español) y E-mail. El identificador que se crea para

el nuevo usuario es el mismo que el del administrador pero añadiendole dos dígitos

numéricos.

Modificar

Permite modificar los datos que se han introducido cuando se ha creado el usuario a

excepción de la descripción del usuario y del password. También permite modificar su estado

(alta/baja).

2 El usuario operador tiene acceso a todas las opciones a excepción de la configuración del Cyberpac y

administración de usuarios. El usuario helpdesk únicament tiene acceso a la consulta de pagos.


27

Cambiar password

Cambia la contraseña del usuario indicado, introduciéndole el nuevo password y la validación

del mismo (alfanumérico entre 6 y 8 caracteres).

Dar de baja

Modifica el estado del usuario seleccionado. Físicamente 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 después de su realización, a excepción de los pedidos

preautorizados que estaran 3 meses. También tiene la opción de consultar los pagos del

último año accediendo a la opción de Consulta/Devolución de pagos en histórico, a

excepción de los pedidos pendientes y erróneos que únicamente estaran los de los 2 y 3

últimos meses de su realización. Es “la Caixa” quien rellena estos datos, así que puede tener

total seguridad de los mismos.

Para consultarlos debe indicar los criterios de selección de su consulta:

Comercio

En el caso que un usuario tuviera dos o más comercios asociados debería seleccionar el

comercio con el que quiere realizar la consulta.

Referencia del pedido

El identificador de su pedido en la página de pago. De este modo, sólo 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.

Línea 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,


28

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 días tiene la fecha del último acceso válido al

Cyberpac.

Si deja los campos de Fecha inicio y Fecha fin en blanco, se listarán 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 máquina. El formato del fichero es TEXTO, con campos delimitados

por punto y coma, por lo que se puede visualizar con la hoja de cálculo que se desee.

El resultado ofrece la siguiente información ordenada por días: Fecha, Hora, Referencia del

pedido, Devolución (Si/No), Comercio, Importe, Estado, Razón (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,

Método de pago. Al seleccionar un pedido de la lista donde el Cyberpac haya solicitado los

datos del comprador, también se visualizarán los datos del mismo: Nombre, Primer Apellido,

Segundo Apellido, Dirección, Ciudad, Código Postal, Provincia, País, Teléfono y Título

(Señor/Señora).

5.4.1. Devoluciones

Se pueden realizar devoluciones de los pedidos pagados con tarjeta, transferencias y

domiciliaciones. Para realizar una devolución primero debe seleccionar la operación u

operaciones de las que desea efectuar una devolución, por lo que deberá clicar el botón “Ver

listado” en la página de Consultas/Devoluciones de pagos.


29

Le aparecerá una pantalla con la operación u operaciones seleccionadas y deberá señalar en la

referencia del pedido al que se quiera aplicar la devolución.

Posteriormente le aparecerá una pantalla con el detalle del pedido. Si se quiere realizar la

devolución por el importe igual a la operación sólo se deberá clicar el botón “Devolución”, 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 confirmación de la devolución.

Para realizar las devoluciones de pedidos pagados con transferencias o domiciliaciones,

deberá introducir su identificador de Línea Abierta.

5.5. Introducción manual de pagos

Si el comercio no quiere utilizar el Cyberpac como una pasarela de pagos estándard, es decir,

que una de sus páginas web enlace con el Cyberpac y el comprador introduzca sus datos de la

tarjeta a la página del Cyberpac, también tendrá la posibilidad de introducir los pagos

manualmente mediante la opción de “Introducción manual de pagos”. Para poder utilizar esta

modalidad de pago del Cyberpac, lo deberá solicitar en su oficina.

Mediante esta opción el comercio podrá realizar pedidos sin necesidad de que el comprador

tenga que acceder a la página web del comercio. Para hacerlo el comercio deberá solicitar al

comprador que le facilite los datos de la tarjeta (número de tarjeta y la fecha de caducidad).

Con estos datos el comercio deberá introducir en la “Aplicación de Gestión del Cyberpac”,

el identificador del pedido (*) y el importe del mismo. Posteriormente, se deberá confirmar

dicho pedido para que se realice la transacción..

(*) Que siempre debe ser diferente , de un mínimo de 4 y un máximo de 12 posiciones y las

4 primeras númericas.

5.6. Gestión de pagos preautorizados

Mediante la opción de pagos el comercio podrá decidir la finalización de la transacción de los

pagos preautorizados realizados en su comercio.

Para realizar la transacción 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 opción de “Listar pedidos” introduciendo el rango de fechas que

prefiera para limitar la búsqueda, posteriormente deberá seleccionar el pedido que desee.


30

Cuando tenga introducida la referencia del pedido preautorizado deberá pulsar el botón

“Aceptar”. En la siguiente página se le mostrarán los datos de la preautorización 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 botón

“Aceptar”.


31

6. Paso a Producción

Notificar al administrador, mediante un E-Mail a [email protected] y con referencia Cyberpac,

la URL del comercio y el interés por pasar los pagos del comercio a producción, 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 finalización 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 pequeña

descripción, pues los datos serán facilitados a VISA España y VISA Internacional para que

los incorpore en su web. También se listará el comercio en las páginas de “la Caixa”

destinadas a tal efecto: http://www.lacaixa.es/comercio

Recuerde, que según la legislación 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 mercancía o servicio solicitado o, por cualquier razón, 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"

../../../../../../dades/[email protected]

http://www.lacaixa.es/comercio


32

7. Resolución de problemas

Si hace tiempo que bajó el autoinstalador, obténgalo de nuevo y reinstálelo para asegurar que

su versión es la correcta.

Pueden producirse excepciones en varios puntos del proceso de pago.

Invocación a la CrURLtpv desde el sistema del comercio

Se efectúan, entre otras, las siguientes comprobaciones:

- Que no falta ningún parámetro obligatorio.

- Los parámetros son formalmente correctos.

- El fichero de configuración no ha sido modificado sin reinstalar. Es obligatorio que los

datos del fichero de configuración local y los datos del repositorio

(http://www.lacaixa.es/tpv.html ) sean iguales. Cualquier modificación que se efectúe en este

fichero debe ser mediante la reinstalación de Cyberpac. El fichero de configuración no

debe ser editado directamente.

La utilidad CrURLtpv devuelve un RETURN_CODE, en función del parámetro erróneo

obtenido. Este RETURN_CODE puede ser capturado dinámicamente por el sistema del

comercio para su análisis. Si el sistema del comercio no captura el RETURN_CODE, o lo

captura pero decide generar la página 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 própia del comercio será la especificada durante el proceso de

instalación. 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 excepción puede ser capturada en 3 puntos distintos:

- En el momento de generación de la página dinámica 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 efectúan, entre otras, las siguientes comprobaciones:

- Los datos del comercio son correctos.

- El número secreto personal y la fecha de caducidad son correctos.

- Existe saldo suficiente en la cuenta del comprador.



33

Cualquiera que sea el error generado en los dos puntos anteriores, se efectúa una redirección

a una página de error, en la que se indican el código de retorno y el código de razón.

En dicha página aparece un botón de “Continuar”, que apunta a la URL de error que el

comercio haya especificado en su llamada dinámica 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 parámetro

datatimeout del Cyberpac, y debido al cambio horario (verano-invierno), detecta diferencias,

puede ser que el código de la utilidad de creación 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 Apéndice 1,

envíe un E-Mail con referencia Cyberpac a [email protected]. Comuníquenos:

- La URL donde se encuentra la página de pago con el enlace al Cyberpac.

- La URL que genera para visualizar las páginas del Cyberpac.

- El usuario y password de acceso a su repositorio.

- El error o problema detectado.


34

Apéndice 1: Errores devueltos por el Cyberpac

La siguiente tabla incluye todos los códigos de error susceptibles de ser devueltos por el

Cyberpac en cualquiera de los puntos mencionados en el capítulo “Resolución de

problemas”.

CÓDIGO CAUSA Acción recomendada

0 Operación aceptada. Su operación ha sido aceptada.

1 Error en el fichero tpv.cnf Revisar instalación

2 Número de parámetros incorrecto Revisar llamada al crURLtpv

3 Formato de parámetros incorrecto Revisar llamada al crURLtpv

4 Parámetro desconocido Revisar llamada al crURLtpv

5 Falta o es incorrecto el parámetro idpedido o longitud incorrecte Revisar llamada al crURLtpv

6 Falta o es incorrecto el parámetro moneda Revisar llamada al crURLtpv

7 Falta o es incorrecto el parámetro importe Revisar llamada al crURLtpv

8 Falta o es incorrecto el parámetro idioma Revisar llamada al crURLtpv

9 Parámetro mailcomp incorrecto Revisar llamada al crURLtpv

10 Parámetro url_post_ok incorrecto Revisar llamada al crURLtpv

11 Parámetro url_post_ko incorrecto Revisar llamada al crURLtpv

12 Parámetro url_post_cancel incorrecto Revisar llamada al crURLtpv

13 Falta o es incorrecto el parámetro MONEDA Revisar llamada al crURLtpv

14 Falta o es incorrecto el parámetro IMPORTE Revisar llamada al crURLtpv

15 Falta o es incorrecto el parámetro IDIOMA Revisar llamada al crURLtpv

18 Error en el envío de parámetros Revisar llamada al crURLtpv

19 Parámetro action incorrecto Revisar llamada al crURLtpv

22 Parámetro pan incorrecto Revisar llamada al crURLtpv

23 Parámetro mes incorrecto Revisar llamada al crURLtpv

24 Parámetro any incorrecto Revisar llamada al crURLtpv

25 Parámetro nombre incorrecto Revisar llamada al crURLtpv

26 Parámetro apellido1 incorrecto Revisar llamada al crURLtpv

27 Parámetro apellido2 incorrecto Revisar llamada al crURLtpv

28 Parámetro direccion incorrecto Revisar llamada al crURLtpv

29 Parámetro ciudad incorrecto Revisar llamada al crURLtpv

30 Parámetro cp incorrecto Revisar llamada al crURLtpv

31 Parámetro provincia incorrecto Revisar llamada al crURLtpv

32 Parámetro pais incorrecto Revisar llamada al crURLtpv

33 Parámetro telefono incorrecto Revisar llamada al crURLtpv

34 Parámetro titulo incorrecto Revisar llamada al crURLtpv

35 Parámetro tarmodif incorrecto Revisar llamada al crURLtpv

36 Parámetro pedmodif incorrecto Revisar llamada al crURLtpv

37 Falta parámetro action:s para datos de pago Revisar llamada al crURLtpv

41 Parámetro idportal incorrecto Revisar llamada al crURLtpv

42 Parámetro gnportal incorrecto Revisar llamada al crURLtpv

43 Parámetro gnportal recibido sin idportal Revisar llamada al crURLtpv

43 Parámetro Telefon2 no recibido o formato incorrecto Revisar llamada al crURLtpv

44 Parámetro Horaent no recibido cuando contrareem=si Revisar llamada al crURLtpv

45 Parámetro Contrarem recibido con formato incorrecto Revisar llamada al crURLtpv

46 Falta algún Parámetro de datos de usuario y contrarem=si Revisar llamada al crURLtpv

… 53 Llamada al Cyberpac incorrecta (falta de parámetros) Revisar llamada al crURLtpv

57 Paràmetre idportal no donat d'alta a la taula de portals Revisar llamada al crURLtpv

58 Parámetro gnportal recibido sin idportal Revisar llamada al crURLtpv

59 Parámetro idportal incorrecto (longitud <=4) Revisar llamada al crURLtpv

60 Parámetro gnportal incorrecto (longitud <=4) Revisar llamada al crURLtpv

61 Parámetro telefon2 no recibido cuando contrareem=si Revisar llamada al crURLtpv


35

62 Paràmetre horaent no recibido cuando contrareem=si Revisar llamada al crURLtpv

81 Falta respuesta del Cyberpac por Time-out u otro motivo Probar más tarde

85 Falta respuesta del Cyberpac por Time-out u otro motivo Probar más tarde

90 No hay comunicaciones con el Cyberpac Probar más tarde o reportar al

administrador del Cyberpac

91 No hay sesiones con el Cyberpac Reportar al administrador del

Cyberpac

92 Falta respuesta de host por Time-out u otro motivo Probar más tarde

93 Excepción sistema Reportar al administrador del

Cyberpac

94 Error en comunicaciones Lu6.2 Reportar al administrador del

Cyberpac

95 Error de instrucción SQL Reportar al administrador del

Cyberpac

101 Error interno del Cyberpac (‘Bind’ del cgi) Reportar al administrador del

Cyberpac

140 El pedido se ha realizado por un medio de pago que no está

soportado por el comercio Cancelar el pago

160 Provocado por una caida de las comunicaciones del SAT Probar más tarde

400 Error por parámetro Time-out Obtener de nuevo el autoinstalador

1000 Comercio no existe en TPVMERCH Reportar al administrador del

Cyberpac

1062 Fecha de caducidad ilógica. La fecha de caducidad tecleada es

errónea.

1063 No se permite fecha de caducidad. Pago con móvil Reportar al administrador del

Cyberpac

1100 Error en autentificación de datos Reportar al administrador del

Cyberpac

1122 La operación que solicitó no es conocida por nuestro sistema. Existe una incidencia en la

aplicación.

1125 El PIN sólo se permite para tarjetas de "la Caixa". La operación no requiere el número

secreto personal.

1152 El importe tecleado contiene símbolos inadecuados Volver a introducir el importe

1155 No estan permitidos importe < a 2 Ptas / 0,01 Euros Reportar al administrador del

Cyberpac

1157 Se ha tecleado un importe no numérico o demasiado grande Cancelar el pago

1163 El número de operación es ilógico Reportar al administrador del

Cyberpac

1193 La fecha es errónea Reportar al administrador del

Cyberpac

1194 La hora es errónea Reportar al administrador del

Cyberpac

1200 Pago ya realizado correctamente para este pedido Reportar al administrador del

Cyberpac

1250 Idpedido utilizado con anterioridad Volver a generar el idpedido

1300 No existe la etiqueta indicada para ese comercio Reportar al administrador del

Cyberpac

1301 Comercio con MD5 activo Solicitar el cambio al adm. del

Cyberpac

1400 Tipo de pago no permitido Reportar al administrador del

Cyberpac

1500 Error en acceso al servidor Reportar al administrador del

Cyberpac

1551 El formato del mensaje es inválido Reportar al administrador del

Cyberpac

1600 Respuesta negativa del servidor Reportar al administrador del

Cyberpac

1700 Pago no aceptado por el Cyberpac Reportar al administrador del


36

Cyberpac

1783 La fecha tecleada es ilógica. (errónea) La fecha tecleada es errónea

1800 Faltan datos de pago Reportar al administrador del

Cyberpac

1900 Pago no aceptado por el Cyberpac Reportar al administrador del

Cyberpac

2000 Por favor, avise a "la Caixa" inmediatamente. Función temporalmente desactivada

2001 Función temporalmente desactivada. Función temporalmente desactivada

2002 No hay conexión con la entidad emisora de la tarjeta. Función temporalmente desactivada.


2010 Por favor, avise a "la Caixa" inmediatamente. Función temporalmente desactivada.

2012 Cuenta cancelada Cancelar el pago



2031 Su entidad ha denegado la operacion por motivos no detallados.

Contacte con su entidad.

Su entidad financiera ha denegado la

operación por motivos no detallados.

2035 Saldo disponible insuficiente Cancelar el pago

2046 Tarjeta no operativa Cancelar el pago

2060 Superado el límite de disponibilidad Cancelar el pago

2075 Importe superior al límite de la tarjeta Cancelar el pago

2100 Por favor, avise a "la Caixa" tan pronto como pueda. En breve

quedará resuelto su problema. Función temporalmente desactivada.

2101 No se encontró su comercio en nuestros archivos. En breve se

resolverá su problema.

Existe una incidencia en la

aplicación.

2102 No se encontró su comercio en nuestros archivos. Por favor,

avise a "la Caixa".


aplicación.

2103 Su comercio está dado de baja en nuestros archivos Reportar al administrador del

Cyberpac




2202 No se encontró su terminal definido en nuestros archivos. Por

favor, En breve se resolverá su problema.


aplicación.

2203 Su Terminal está dado de baja en nuestros archivos. Por favor,

En breve se resolverá su problema.


aplicación.

2300 Pago no aceptado por totpvcaixa Reportar al administrador del

Cyberpac

2301 No podemos atender su petición Reportar al administrador del

Cyberpac

2302 La tarjeta del cliente está marcada como bloqueada para la

operativa con terminales de nuestra entidad.

La tarjeta es inválida. Contacte con

su entidad financiera.

2303 La tarjeta del cliente está marcada como perdida o robada en

nuestros archivos.



2304 Tarjeta marcada como falsificada en nuestros archivos Reportar al administrador del

Cyberpac

2305 Tarjeta cancelada por terminales de “la Caixa” Reportar al administrador del

Cyberpac

2440 Moneda no permitida por este comercio Reportar al administrador del

Cyberpac

2441 La moneda empleada en la operación no está permitida para esta

fase de introducción del Euro.

Moneda no permitida para esta

operación

2600 Tipo de tarjeta aún no soportado por nuestra operativa. Contacte

con "la Caixa".



2610 Caducidad de la tarjeta superada Reportar al administrador del

Cyberpac

2620 La operación requiere el número secreto personal Reportar al administrador del

Cyberpac

2644 Tarj. Amex o Hispamer (Eurocard). Op. no autorizada Consultar entidad emisora de la


37

tarjeta

2647 PIN incorrecto Corregir

2648 Superado límite. Saldo disponible insuficiente Cancelar el pago


2801 Venta fraccionada no permitida por la entidad o para la tarjeta. Existe una incidencia en la

aplicación.

2802 Código de fraccionamiento inexistente. Existe una incidencia en la

aplicación.

2900 Operación no permitida Reportar al administrador del

Cyberpac

3111 Superado número máximo de reintentos de PIN Reportar al administrador del

Cyberpac

3113 Fecha de caducidad incorrecta Corregir

3114 Número de tarjeta incorrecto Corregir

3118 Tarjeta 4B. Op. no autorizada Consultar entidad emisora de la

tarjeta

3200 La operación no existe en nuestros archivos Reportar al administrador del

Cyberpac

3202 La operación no se puede anular porque no se llegó a realizar

completamente.


aplicación.

3204 No pueden anularse las operaciones no autorizadas. Existe una incidencia en la

aplicación.

3211 Está intentando anular una operación con una tarjeta diferente a

la de la operación original.


aplicación.

3214

Está intentando anular una operación con importe diferente al

empleado en la operación original. Y la tarjeta del cliente no es

una 6000 de nuestra entidad.


aplicación.

3215 Está intentando anular una operación con una moneda diferente

a la que se utilizó para la operación original.


aplicación.

3216 Está intentando anular una operación con un comercio diferente

a la que se utilizó para la operación original "la Caixa".


aplicación.











4013 Tarjeta marcada como perdida o robada Reportar al administrador del

Cyberpac

4014 La tarjeta del cliente está cancelada. Contacte con "la Caixa". La tarjeta es inválida. Contacte con


4015 El cliente ha sobrepasado el importe límite por operación. El importe es erróneo o supera el

límite por operación.


4017 Se ha tecleado incorrectamente el número secreto Reportar al administrador del

Cyberpac

4018 La operación fue denegada por la entidad emisora de la tarjeta

del cliente. Contacte con la entidad emisora.









4020 Tarjeta del cliente a retener. La tarjeta es inválida. Contacte con



38










4024 No hay comunicación con CECA, centro autorizado de su

tarjeta

Reportar al administrador del

Cyberpac

4025 No hay comunicación con SEMP, centro autorizado de su

tarjeta


Cyberpac

4026 No hay comunicación con el centro 2 de "la Caixa". Función temporalmente desactivada.

4027 La red débito de “la Caixa” no está operativa Reportar al administrador del

Cyberpac

4028 La red a crédito de "la Caixa" no está operativa. Función temporalmente desactivada.

4029 Operación no realizable por su entidad Reportar al administrador del

Cyberpac

4030 Su entidad o centro autorizador está fuera de servicio. Función temporalmente desactivada.

4031 Comercio no operativo en su centro autorizado Reportar al administrador del

Cyberpac

4032 La tarjeta de supervisor del comercio es inválida Reportar al administrador del

Cyberpac

4033 La tarjeta tiene la operativa restringida por su entidad.




4034 La tarjeta del cliente está inactiva o es desconocida Cancelar pago

4035 La tarjeta no es valida para la red 6000. La tarjeta es inválida. Contacte con


4036 La tarjeta no es valida para intercambio. La tarjeta es inválida. Contacte con


4037 La tarjeta ha sido retenida Reportar al administrador del

Cyberpac

4038 Tarjeta bloqueada por su entidad Reportar al administrador del

Cyberpac

4039 La tarjeta está mal grabada Consulte a su entidad

4040 El emisor de la tarjeta no es conocido. La tarjeta es inválida. Contacte con


4041 Su entidad o centro autorizado excede el tiempo límite de

respuesta


Cyberpac

4042 El importe de la operación supera el límite establecido por su

entidad.

El importe es erróneo o supera el

límite disponible de la tarjeta.

4043 El importe de la operación es menor que el límite inferior

establecido por su entidad.

El importe de la operación es menor

que el límite inferior establecido por

su entidad.

4044 Operación no autorizada por su entidad Cancelar pago

4045 El importe supera el límite disponible de la tarjeta. El importe es erróneo o supera el

límite disponible de la tarjeta.

4046 El importe supera el límite disponible por el comercio. Existe una incidencia en la

aplicación.

4047 El importe supera el límite disponible por operaciones

internacionales


Cyberpac

4048 Error en la fecha de caducidad de la tarjeta de cliente. La fecha de caducidad de la tarjeta

tecleada es errónea.

4049 Error en el formato criptográfico del número personal Reportar al administrador del

Cyberpac

4050 El número personal tecleado es erroneo. El número secreto personal tecleado

es erróneo.

4051 Se ha excedido el número de errores del número personal. Se ha excedido el número de errores

máximo de número personal.

4052 El formato de la transacción es erróneo Existe una incidencia en la

aplicación.


39

4053 El terminal no está operativo en CECA, su centro autorizado Reportar al administrador del

Cyberpac

4054 La tarjeta del cliente está caducada Cancelar el pago

4055 La tarjeta del cliente no es procesable por el emisor. La tarjeta es inválida. Contacte con


4056 La anulación no es válida por la operación original Reportar al administrador del

Cyberpac

4057 Se ha producido una incidencia temporal en la aplicación Reintentar o trucar al servei tècnic

4058 Su entidad ha denegado la operación por motivos no detallados Consulte a su entidad

4059 El elevado tráfico en las líneas impide que se pueda realizar la

operación


Cyberpac

4060 No hay comunicación con CECA, centro autorizado de su

tarjeta, por problemas de saturación


Cyberpac

4061 No se ha tecleado PIN. No se ha tecleado el número secreto

personal.

4062 La modalidad de pago fraccionado seleccionado no existe. Existe una incidencia en la

aplicación.

4063 El comercio o la tarjeta no tiene permitido pago fraccionado de

operaciones.


aplicación.

4064 El comercio no está operativo en SEMP, su centro autorizador. Existe una incidencia en la

aplicación.

4065 Su entidad ha denegado la operación por motivos no detallados Consulte a su entidad

4068 El importe de la operación supera el límite establecido por

operación Cancelar el pago


del cliente


Cyberpac









4201 La tarjeta está bloqueada o caducada, o la entidad emisora de la

tarjeta no está permitida


Cyberpac

4500 Por favor, avise a "la Caixa" inmediatamente. Existe una incidencia en la

aplicación.

4512 No hay conexión con el centro autorizador SEMP. Función temporalmente desactivada.

4600 Función temporalmente desactivada Existe una incidencia en la

aplicación.

4601 No disponible recuperar la transacción original Reportar al administrador del

Cyberpac

4602 Número de referencia inválido Reportar al administrador del

Cyberpac

4603 Número de referencia i pan incompatibles Reportar al administrador del

Cyberpac

4606 Su petición no puede ser cumplimentada Reportar al administrador del

Cyberpac

4680 Identificativo de mensaje no soportado por la aplicación. Existe una incidencia en la

aplicación.

4683 Movimiento no cumple especificaciones de formato. Existe una incidencia en la

aplicación.

4684 RTS no válido Reportar al administrador del

Cyberpac

4687 Mensaje no editable Reportar al administrador del

Cyberpac

4690 Incidencia operativa en caixer Reportar al administrador del

Cyberpac

4691 Teléfono no soportado por el sistema Reportar al administrador del

Cyberpac

4692 Intentos de telecode excedidos Reportar al administrador del

Cyberpac


40

4693 Denegada por diversos motivos Reportar al administrador del

Cyberpac

8003 Exceso de restricción al puerto del PROXY Reportar al administrador de su

sistema

9999 Pruebas Test (referencia del pedido acabada en cero)

100100 No coinciden configuraciones ventana nueva/activa Ver llamada y repositorio.

Errores posibles durante las devoluciones ( no estan exentos de producirse algunos de los anteriores):

CÓDIGO CAUSA Acción recomendada

30 Error genérico Volver a intentar

32 Error en la validación de usuario Volver a intentar

300 No existe un pago asociado a esta devolución Reportar al administrador del Cyberpac

301 El importe de la devolución supera el importe del

pedido original Volver a intentar con un importe inferior

302 El pedido original no está pagado Seleccionar un pedido pagado

303 El medio de pago original no soporta este tipo de

devolución Reportar al administrador del Cyberpac

304 Devolución ya finalizada correctamente en una

operación anterior Reportar al administrador del Cyberpac

305 No existe ningún dato previo asociado a esta

devolución Reportar al administrador del Cyberpac


41

ERRORES QUE PROVIENEN DE SIS

101 - Tarjeta caducada

102 - Tarjeta en excepción transitoria o bajo sospecha de fraude

104 - OPeración no permitida para esa tarjeta o terminal

106 - Intentos de PIN excedidos

107 - Contactar con el emisor

109 - Identificación 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 inválido

129 - Tarjeta no operativa (erro en CVV1/CVC1 o CVV2/CVC2

180 - Tarjeta ajena al servicio

181 - Tarjeta con restricciones débito (Cuenta corriente)

182 - Tarjeta con restricicones crédito (Cuenta de crédito)

183 - Tarjeta con restricciones débito (Cuenta de ahorro)

190 - Denegación sin especifición de motivo

191 - Fecha de caducidad errónea


42

Apéndice 2: Ejemplos válidos de integración de la llamada al Cyberpac

Los siguientes ejemplos se proporcionan a modo de ayuda, y de ningún modo forman parte

del producto Cyberpac ni están 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,"[email protected]")

<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>);


43

print "$RESULTAT\n";

close(JRE);

3. Respuesta al notificador de la URL fija (Ejemplo para NT)

// Si la invocación 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 invocación 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"

/* Declaración 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++;

}


44

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 código 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 método */

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)


if((chURL=(char *)malloc(lon+1))==NULL)


memset(chURL,'\0',lon+1);

strcpy((char *)chURL,getenv("QUERY_STRING"));

}

/* end if referenced with a GET method */

/* Referenciado con POST método */

if(!memcmp(getenv("REQUEST_METHOD"),"POST",4))

{

if((cl=atoi(getenv("CONTENT_LENGTH")))==0)


if((chURL=(char *)malloc(cl+1))==NULL)


memset(chURL,'\0',lon+1);

if ((fread(chURL,sizeof(char),cl,stdin))!=cl)



45

}

/* end if referenced with a POST method */

if((getenv("REMOTE_ADDR"))==NULL)

{


}

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);


GetCampo(chURL,"importe",auxcampo);

strcat(salida,auxcampo); /* printf("importe:*%s*\n",auxcampo); */

free(auxcampo);


GetCampo(chURL,"idpedido",auxcampo);

strcat(salida,auxcampo); /* printf("idpedido:*%s*\n",auxcampo); */

free(auxcampo);


GetCampo(chURL,"estado",auxcampo); /* printf("estado:*%s*\n",auxcampo); */

free(auxcampo);


GetCampo(chURL,"diahora",auxcampo); /* printf("diahora:*%s*\n",auxcampo); */

free(auxcampo);


GetCampo(chURL,"label",auxcampo); /* printf("label:*%s*\n",auxcampo); */

strcpy(label,auxcampo);

free(auxcampo);


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]);


46

free(valor[0]);

free(bb[0]);

}

tpvguia cyberpac caixa_esp

Documents