Cyberpac

Cyberpac
Guía de uso del comercio
Noviembre 2003
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
4. Instalación .........................................................................................................................................10
4.1. Instalación en Windows ...............................................................................................................10
4.2. Instalación en UNIX .....................................................................................................................10
4.3. Parámetros de instalación ...........................................................................................................10
4.4. Reinstalación y desinstalación.....................................................................................................11
4.5. Contenido de la instalación..........................................................................................................12
4.6. CrURLtpv .....................................................................................................................................12
4.6.1. Formulario de datos del comprador ........................................................................................15
4.6.2. Preautorizaciones....................................................................................................................16
4.6.3 Ejemplos de llamada al CrURLtpv ...........................................................................................18
4.7. CheckNOTtpv: Verificación de la notificación HTTP ...................................................................21
4.8. CheckSEEDtpv: Verificación de las semillas...............................................................................23
5. Configuración de su comercio en el repositorio................................................................................24
5.1. Consulta/Devoluciones de pagos ................................................................................................25
5.1.1. Devoluciones ...........................................................................................................................26
5.2. Introducción manual de pagos.....................................................................................................26
5.3. Gestión de pagos preautorizados ................................................................................................27
5.4. Configurar datos del comercio .....................................................................................................27
6. Paso a Producción ............................................................................................................................30
7. Resolución de problemas..................................................................................................................31
Apéndice 1: Errores devueltos por el Cyberpac ...................................................................................33
ERRORES QUE PROVIENEN DE SIS ................................................................................................40
Apéndice 2: Ejemplos válidos de integración de la llamada al Cyberpac ............................................41
9736 – Gestión y Desarrollo de Banca Electrónica
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 contra
reembolso.
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 desde Línea Abierta (sistema e-banking de la Caixa) 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.
3
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 podrán 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 de la 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).
4
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.
Mediante el usuario de Línea Abierta podrá acceder a la aplicación de administración de su

comercio en el Cyberpac dentro de Línea Abierta de "la Caixa" (https://lo.lacaixa.es),
apartado "Servicios/Comercios/Administración Cyberpac".
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”, sino
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 contra
reembolso 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 cyberpac@lacaixa.es solicitando dicho
contacto.
5
3. Características del Cyberpac
3.1. Tipos de pago

El Cyberpac acepta los siguientes tipos de pago:
• Tarjeta
Con el fin de incrementar la seguridad en las compras realizadas a través de Internet, y proteger tanto al
titular de la tarjeta como al comercio de posibles actuaciones fraudulentas, Visa y MasterCard han
acordado ofrecer comercio seguro para las compras que se realicen por Internet.
El Cyberpac aceptará como seguras todas las operaciones que se realizan con tarjetas cuya entidad
financiera emisora efectúa identificación del titular de la tarjeta.
Se distinguen 2 tipos de tarjetas:
Tarjetas seguras: corresponde a operaciones realizadas con tarjetas emitidas por “la Caixa” o por
cualquier entidad financiera nacional y extranjera, en que se efectúa autentificación de la identidad
del titular de la tarjeta.
- Todos los comercios que operen por Internet y ofrezcan comercio seguro están protegidos ante
una posible retrocesión de la operación por el motivo “operación no autorizada por el titular de la
tarjeta”
- Los titulares de tarjetas, se deben identificar en el momento de realizar la operación a través de
alguno de los métodos considerados seguros, como el teléfono móvil, PIN, certificados digitales,
etc. La forma de identificación depende de cada entidad financiera.
Tarjetas no seguras: corresponde a operaciones realizadas con tarjetas, emitidas por cualquier
entidad financiera nacional o extranjera, en que No se efectúa autentificación de la identidad del
titular de la tarjeta, y en estos casos el titular de la tarjeta puede solicitar la retrocesión de la
operación. Para este tipo de tarjetas, el Cyberpac intentará siempre realizar la operación como
compra segura, y en caso que el titular de la tarjeta no se autentifique, se tramitará, automáticamente
y de forma transparente para el comercio y usuario, la operación como no segura.
El Cyberpac, por defecto sólo aceptará operaciones realizadas con tarjetas seguras.
Si desea aceptar tarjetas No seguras, debe solicitarlo a su oficina.
Funcionamiento del comercio seguro:
- El cliente, cuando haya decidido que artículos quiere comprar, tiene que teclear el numero y la
caducidad de la tarjeta.
- El paso siguiente es la comprobación de la titularidad del cliente por parte de la entidad emisora de la
tarjeta, ya sea por medio de una llamada automática al teléfono móvil del cliente; ya sea mediante la
solicitud del numero secreto del cliente; o bien por cualquier otro método de identificación segura
que escoja la entidad emisora de la tarjeta.
- Finalmente, si el cliente es identificado positivamente, se procesará la transacción de compra de
forma segura.
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
6
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. 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”, "Pte. Domiciliar" o
"Domiciliado/Pte. Domiciliar".
- Introducir el intervalo de fechas de los recibos que desee domiciliar.
- Crear el fichero de domiciliaciones. En Euros.
- Posteriormente puede elegir entre las opciones de descargar el fichero de
domiciliaciones creado o de proceder a enviarlo automáticamente.
- Si elige la opción de descargar el fichero en su sistema, en el momento que lo desee,
podrá acceder a Línea Abierta Web y desde el apartado "Ficheros/Transferencia de
ficheros/Envío" proceder al envío del mismo.
- Una vez enviado, 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://comercios.lacaixa.es.
Contra reembolso: 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
7
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 desde la gestión de su comercio en el

Cyberpac, en el apartado "Servicios/Comercios/Administración Cyberpac" dentro de
Línea Abierta Web.
- 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
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:
idpedido=idcomanda&importe=import&moneda=<XEU>&estado=<0/1/-1/3/10/11/15/16>&diahora=dia-
hora&label=nº label&huella=huella
donde estado=0 es pago pendiente de cobro, estado=16 es pago por contrareembolso pendiente de
contrareembolso, estado=11 indica pago por transferencia pendiente de ingresar, estado=1
corresponde a los pagos en estado pagado, estado=-1 indica pago no aceptado, estado=15 indica
preautorización aceptada, estado=-2 hace referencia a las preautorizaciones no aceptadas y estado=10
corresponde a los pagos por domiciliación en estado Domiciliado.
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ándar (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.
Ver ejemplos en el apéndice 2.
En la notificación online una vez finalizado el pago, el parámetro estado podrá tomar
los valores 0, 1, -1, 3, 10, 11, 15 o 16, es decir, que la URL fija recibirá notificación
para todos los pedidos, a excepción de los cancelados.
8
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”).
- 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.
9
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 y UNIX.
Podrá encontrarlos en el apartado "Servicios/Comercios/Administración Cyberpac" dentro de

Línea Abierta Web: https://lo.lacaixa.es a la que podrá acceder con el usuario y contraseña de
Línea Abierta.
El único requisito del Cyberpac es el módulo Java 1.3.1.
4.1. Instalación en Windows

Para poder utilizar esta aplicación, debe tener instalado Windows NT y el intérprete de Java
1.3.1, que podrá descargar junto con el auto instalador.
Una vez descargado el instalador deberá ejecutarlo y el programa le pedirá los parámetros
necesarios para finalizar la instalación.
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.3.1.
La aplicación sólo está homologada para la versión 1.3.1 del Java Runtime Environment,
aunque es posible que funcione correctamente para versiones superiores de Java.
Se recomienda la ejecución de la instalación como usuario 'root'.
Copie el fichero tpv.tar en el directorio donde desee descomprimir los ficheros. Ejecute el
comando 'tar -xvf tpv.tar' para descomprimir el archivo. 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.
Puede ser necesario (sobre todo en Linux) descomprimir el fichero tpv.jar e insertar los
ficheros de clases “.class” en el fichero classes.zip global del sistema, después de instalar el
Cyberpac.
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.
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
10
Línea Abierta Web, apartado "Servicios/Comercios/Administración Cyberpac" dentro de la

pestaña Empresas (https://lo.lacaixa.es).
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”. Corresponde al nº de comercio.
Claves
El programa de instalación le pedirá que introduzca las 2 claves de (mínimo) 16 a 32

caracteres numéricos que va a utilizar para generar la firma criptográfica. Debe introducir las
dos claves solicitadas.
Estas claves deben ser las mismas que introduzca desde el menú de administración de su
comercio, en el apartado "Servicios/Comercios/Administración Cyberpac" dentro de Línea
Abierta Web.
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.
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 el apartado
"Servicios/Comercios/Administración Cyberpac" dentro de Línea Abierta Web. Si no es así,
sus órdenes de pago generarán errores cuando el Cyberpac verifique sus datos, y éstas no
podrán concluir correctamente.
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
11
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.
licencia.txt - Condiciones del contrato de Cyberpac.

tpv.zip - Clases Java empaquetadas (en unix este archivo tiene extensión
.jar).
tpv.cnf - Fichero de configuración.
leeme.txt - Información sobre el producto.
CrURLtpv.bat - Ejemplo de llamada a CrURLtpv.
CheckNOTtpv.bat - Ejemplo de llamada a CheckNOTtpv.
CheckSEEDtpv.bat - Ejemplo de llamada a CheckSEEDtpv.
jce1_2_2.jar - Clases para la seguridad y encriptación de datos.
local_policy.jar - Clases para la seguridad y encriptación de datos.
sunjce_provider.jar - Clases para la seguridad y encriptación de datos.
US_export_policy.jar - Clases para la seguridad y encriptación de datos.
unwise.ini - Información para desinstalar el producto.
unwise.exe - Utilidad para la desinstalación del producto.
install.log - Log de instalación.
sha1.c - Módulo de encriptación.
sha1.h - Librería del módulo de encriptación.
prueba.c - Ejemplo de llamada a sha1.c.
EncriptacionWin.bat - Utilidad para la encriptación de las semillas durante la instalación.
Fichero de configuración tpv.cnf
Contiene líneas con el formato variable=valor

1. TPVcgi_name=totpvcaixa? (url de llamada al Cyberpac)
2. TPV_merchant_ID=id comercio (consúltelo en el repositorio).
3. TPV_cgi_err=”https://(...)cgi-bin/modulo1/error” (opcional, url llamada en caso de error)
4. TPV_SEED1=xxxxxxxxxx (Claves 1 para cifrado en formato propio)
5. TPV_SEED1=xxxxxxxxxx (Claves 2 para cifrado en formato propio)
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.
12
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ándar del sistema, la URL de pago
cifrada en SHA-1 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), informando el código
del error producido.
Si prefiere no utilizar las funciones java del auto instalador, puede generarlas en C. En los
siguientes ficheros del auto instalador encontrará ejemplos e información.
prueba.c - Ejemplos de llamada en C al SHA1.

sha1.c - Algoritmo de cifrado.
sha1.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 y fichero del fichero de configuración del Cyberpac.
idpedido - Identificador del pedido.
La longitud del código de pedido debe tener entre 4 y 12 caracteres alfanuméricos. En caso
de que el Cyberpac reciba un identificador de pedido incorrecto, provocará un error y no se
podrá realizar la operación. Los primeros 4 caracteres tienen que ser numéricos.
13
No se podrá reutilizar el mismo número de pedido, una vez enviado a Cyberpac,

independientemente del estado definitivo del mismo.
moneda - Divisa utilizada en el pago.
"XEU" o "EUR" 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, Cyberpac utilizará por defecto las
URL's configuradas en el repositorio. 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.
mpago – Preinformación del método de pago.
Es un string de longitud máxima 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
14
K: Contra reembolso
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.
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 la Línea Abierta Web, dentro del
apartado Servicios/Comercios/Administración Cyberpac los campos correspondientes a:
Icono, Claves (las 2 que haya introducido en el proceso de instalación), tipo de notificación
(E-mail online, E-mail batch, URL fija) y las URL's de fin de pago.
Durante las pruebas pueden usar el número de tarjeta 4548812049400004 con la fecha de
caducidad 12/05 y el código 123456.
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).
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 y se
almacenen en el repositorio de Cyberpac los datos personales del comprador. 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.
15
Por ejemplo: nombre: José Luís, o dirección: Av. Diagonal, 571 4º 2ª.
Las 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. 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, puede tomar los siguientes valores:
1 = la operación es una preautorización
16
0 = la operación no es una preautorización
17
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
Windows: CrURLtpv path_fichero_tpv.zip path_fichero_tpv.cnf idpedido:123456

importe:1000.00 moneda:XEU idioma:esp mailcomp:nombre@mail.com
Unix: CrURLtpv path_fichero_tpv.jar path_fichero_tpv.cnf idpedido:123456

importe:1000.00 moneda:XEU idioma:esp mailcomp:nombre@mail.com
Resultado:
https:// lo.lacaixa.es/GPeticiones?PN=ECY&PE=1&&DEMO=0&CANAL=K&
IDIOMA=02&idpedido=123456&importe=100000&moneda=XEU&idcom=XXX&
huella=4a3c2399c1c92085745319a72dc5b86a&label=2
En Unix debe ejecutarse como jre CrURLtpv path_fichero_tpv.jar path_fichero_tpv.cnf

idpedido:123456 importe:1000.00 moneda:XEU idioma:esp mailcomp:nombre@mail.com
2. Invocación correcta al .bat CrURLtpv, en idioma Inglés y moneda Euros
Invocación:
Windows: CrURLtpv path_fichero_tpv.zip path_fichero_tpv.cnf idpedido:123456

importe:1000.00 moneda:XEU idioma:eng
Unix: CrURLtpv path_fichero_tpv.jar path_fichero_tpv.cnf idpedido:123456

importe:1000.00 moneda:XEU idioma:eng
Resultado:
https://lo.lacaixa.es/GPeticiones?PN=ECY&PE=1&&DEMO=0&CANAL=K&IDIOMA=03
&idpedido=123456&importe=100000&moneda=XEU&idcom=XXX&huella=62f3946cb8ca
81fcdc7212d5bbbf1606&label=2
3. Invocación correcta con los datos de pedido y de tarjeta
Invocación: CrURLtpv path_fichero_tpv.zip path_fichero_tpv.cnf

idpedido:123456
importe:10.00
moneda:EUR idioma:esp
url_post_ok:http://www.micomercio.com/cgi-ok
18
mailcomp:pepe@mail.com
pan:4548812049400004 mes:12 any:05
Resultado:
https://lo.lacaixa.es/GPeticiones?PN=ECY&PE=1&DEMO=0&CANAL=K&IDIOMA=02&i
dpedido=123456&importe=1000&moneda=EUR&url_post_ok=http%3A%2F%2Fwww.mic
omercio.com%2Fcgi-ok&
url_post_cancel=http%3A%2F%2Fwww.micomercio.com%2Fcgi-cancel&
mailcomp=pepe@mail.com&pan=4548812049400004&mes=12&any=05&
idcom=XXX&huella=54badc95f8eaafd717e25dfbb8cc68e3&label=1
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 path_fichero_tpv.zip path_fichero_tpv.cnf

idpedido:404044 importe:10.00 moneda:XEU idioma:esp pautor:1 mpago:T
Resultado:
https://lo.lacaixa.es/GPeticiones?PN=ECY&PE=1&&DEMO=0&CANAL=K&IDIOMA=02
&idpedido=404044&importe=1000&moneda=XEU&pautor=1&mpago=T&idcom=XXX&h
uella=957a540f0ba63eff6406a73b69d4edd4&label=2
5. Invocación correcta con los parámetros del cliente ( posibilidad de pago mediante
contra reembolso )
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”);
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 titulo 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.
19
Invocación:
jre -cp directori_inst\tpv.zip;
CrURLtpv path_fichero_tpv.zip path_fichero_tpv.cnf
idpedido:123456
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:4548812049400004 mes:12 any:05 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:
http://lo.lacaixa.es/GPeticiones?PN=ECY&PE=1&&DEMO=0&CANAL=K&IDIOMA=02
&idpedido=123456&importe=10000&moneda=XEU&url_post_ok=http%3A%2F%2Fwww.
micomercio.com%2Fok.html&url_post_cancel=http%3A%2F%2Fwww.micomercio.com%2
Fcancel.html&url_post_ko=http%3A%2F%2Fwww.micomercio.com%2Fko.html&mailcom
p=nombre@mail.com&pan=4548812049400004&mes=12&any=05&tarmodif=si&nombre=J
os%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&tele
fono=934112233&titulo=se%F1or&pedmodif=si&idcom=XXX&huella=f688e6ff0ae2cc078
49c5041955e60de&label=2
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 path_fichero_tpv.zip path_fichero_tpv.cnf moneda:EUR idioma:ooo
importe:14.77 idpedido:123456
Resultado:
https://lo.lacaixa.es/GPeticiones?PN=ECY&PE=200&IDIOMA=02&DEMO=0&CANAL=K
&error_code=8 (debido que el valor del parámetro idioma es incorrecto)
Ver ejemplo en el apéndice 2.
20
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, configurado desde Línea
Abierta Web, apartado "Servicios/Comercios/Gestión del Cyberpac".
4.7. CheckNOTtpv: Verificación de la notificación HTTP

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 SHA1 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:
- directorio_inst\tpv.zip: Path y fichero del paquete de clases internas.

- tpv_path: Path y fichero del fichero de configuración del Cyberpac.
- 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 SHA1 es correcta, es decir, si los datos no han sido
alterados y provienen de “la Caixa”. En caso contrario devuelve en la entrada estándar 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 y reinstalar
si es necesario.
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 $.
Ejemplos de llamada a CheckNOTtpv
Invocación unix: CheckNOTtpv path_fichero_tpv.jar path_fichero_tpv.cnf

XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35
Invocación windows: java -cp directori_inst\tpv.zip; CheckNOTtpv path_fichero_tpv.zip

path_fichero_tpv.cnf XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35
21
Invocación en linux: jre -cp directori_inst\tpv.zip; CheckNOTtpv path_fichero_tpv

path_fichero_cnf XEU1000.001234 2 3af706254e5dfd353af706254e5dfd35
22
4.8. CheckSEEDtpv: Verificación de las semillas

Utilidad para validar que los valores de las semillas para el comercio son los que se
encuentran encriptados en el fichero tpv.cnf.
Parámetros de CheckSEEDtpv
directorio_inst\tpv.zip - Path y fichero del paquete de clases internas.

tpv_path - Path y fichero del fichero de configuración del Cyberpac.
Valor de la semilla 1
Valor de la semilla 2
Retorno
0=semillas correctas
1=semillas incorrectas
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 Línea Abierta Web, dentro del apartado
Servicios/Comercios/Administración Cyberpac: https://lo.lacaixa.es
Usuario y password
En primer lugar, usted debe acceder a la página de logon de Línea Abierta Web, en la que
debe indicar el usuario que se le ha asignado y la password del mismo.
Una vez dentro de Línea Abierta Windows deberá escoger el menú

"Servicios/Comercios/Administración Cyberpac" en la pestaña Empresas.
Control de acceso
En todos los accesos al servidor del Cyberpac desde la aplicación de gestión se genera una
sesión de usuario única.
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,
sino que obligatoriamente debe utilizar los enlaces de navegación de la aplicación.
Puede elegir una de las siguientes opciones:
- Consulta/Devoluciones de pagos
- Introducción manual de pagos
- Pagos preautorizados
- Configuración de los datos del comercio
- Validación de claves
- Descargar el instalador de Cyberpac
24
5.1. Consulta/Devoluciones de pagos
Usted puede consultar y realizar devoluciones de los pagos realizados en su comercio

inmediatamente después de su realización. Es “la Caixa” quien rellena estos datos, así que
puede tener total seguridad de los mismos.
Los pagos en modo test con fecha anterior a 3 meses son eliminados del sistema así como
también se borran los pagos en modo producción con fecha anterior a un año siempre y
cuando el estado de los mismos sea Cancelado o Denegado.
Para consultarlos debe indicar los criterios de selección de su 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, Contra
reembolso.
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,
Domiciliados, Pte. Domiciliar, A ingresar (por transferencia), Preautorizados, Todos
(incluye todos los anteriores).
Los pedidos que tengan estado “A ingresar” (pagos por transferencia) 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”.
Lo mismo ocurre con los pagos por contra reembolso que quedan en estado "pendiente" hasta
que el comercio cambia su estado 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.
Si deja los campos de Fecha inicio y Fecha fin en blanco, se listarán todos los pedidos en el
estado seleccionado.
25
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, Referencia del pedido,
Devolución (Si/No), Importe, Estado, Método de pago y modo de operación (Test o Real). 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.1.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
pedidos” en la página de Consultas/Devoluciones de pagos.
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 “Realizar
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.
5.2. Introducción manual de pagos
Si el comercio no quiere utilizar el Cyberpac como una pasarela de pagos estándar, 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”. Esta utilidad permitirá
solamente realizar los pagos por tarjeta. Para poder utilizar esta modalidad de pago del
Cyberpac, lo deberá solicitar en su oficina.
26
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 numéricas.
5.3. 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.
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”.
5.4. Configurar datos del comercio

Usted accede a la opción Configurar datos del comercio para actualizar los siguientes datos
de configuración de su comercio. Los cambios son efectivos en la primera operación después
de la modificación.
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.
27
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.
Claves
Mediante la opción “Editar claves”, usted puede introducir las 2 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.
Nota: Es responsabilidad de la URL de fin de pago el manejo de los frames del comercio, si los hubiera.
Estas URL's 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.
El Cyberpac admite 2 tipos de URLs de fin de pago (si ninguno de ellos está informado, se
utiliza la url de retorno por defecto de "la Caixa", www.lacaixa.es):
- 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
28
cuenta del comprador. Si no dispone de una tarjeta de “la Caixa”, teclee la siguiente
numeración: 4548812049400004. La fecha de caducidad y el PIN pueden ser
cualquiera.
- 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”);
}
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.
29
6. Paso a Producción
Notificar al administrador, mediante un E-Mail a cyberpac@lacaixa.es 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 vía
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, para que se liste el comercio en las páginas de “la Caixa” destinadas a tal efecto:
http://comercios.lacaixa.es
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"
30
7. Resolución de problemas
Si hace tiempo que bajó el auto instalador, 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 de Cyberpac
(introducidos por el comercio desde Línea Abierta Web) 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://lo.lacaixa.es/GPeticiones?PN=ECY&PE=200&IDIOMA=02&DEMO=0&CAN
AL=K&error_code=8
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.
31
- Existe saldo suficiente en la cuenta del comprador.
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.
32
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
39 Parámetro preautor incorrecto 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
47 Parámetro mpago incorrecto Revisar llamada al CrURLtvp
… 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
33
60 Parámetro gnportal incorrecto (longitud <=4) Revisar llamada al CrURLtpv
61 Parámetro telefon2 no recibido cuando contrareem=si Revisar llamada al CrURLtpv
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
Probar más tarde o reportar al
90 No hay comunicaciones con el Cyberpac
administrador del Cyberpac
Reportar al administrador del
91 No hay sesiones con el Cyberpac
Cyberpac
92 Falta respuesta de host por Time-out u otro motivo Probar más tarde
93 Excepción sistema
Cyberpac
94 Error en comunicaciones Lu6.2
Cyberpac
95 Error de instrucción SQL
Cyberpac
101 Error interno del Cyberpac (‘Bind’ del cgi)
Cyberpac
El pedido se ha realizado por un medio de pago que no está
140 Cancelar el pago
soportado por el comercio
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
Cyberpac
La fecha de caducidad tecleada es
1062 Fecha de caducidad ilógica.
errónea.
1063 No se permite fecha de caducidad. Pago con móvil
Cyberpac
1100 Error en autentificación de datos
Cyberpac
Existe una incidencia en la
1122 La operación que solicitó no es conocida por nuestro sistema.
aplicación.
La operación no requiere el número
1125 El PIN sólo se permite para tarjetas de "la Caixa".
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
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
Cyberpac
1193 La fecha es errónea
Cyberpac
1194 La hora es errónea
Cyberpac
1200 Pago ya realizado correctamente para este pedido
Cyberpac
1250 Idpedido utilizado con anterioridad Volver a generar el idpedido
1300 No existe la etiqueta indicada para ese comercio
Cyberpac
Solicitar el cambio al adm. del
1301 Comercio con SHA1 activo
Cyberpac
1400 Tipo de pago no permitido
Cyberpac
1500 Error en acceso al servidor
Cyberpac
1551 El formato del mensaje es inválido
Cyberpac
1600 Respuesta negativa del servidor Reportar al administrador del
34
Cyberpac
1700 Pago no aceptado por el Cyberpac
Cyberpac
1783 La fecha tecleada es ilógica. (errónea) La fecha tecleada es errónea
1800 Faltan datos de pago
Cyberpac
1900 Pago no aceptado por el Cyberpac
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
Su entidad ha denegado la operacion por motivos no detallados. Su entidad financiera ha denegado la
2031
Contacte con su entidad. 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
Por favor, avise a "la Caixa" tan pronto como pueda. En breve
2100 Función temporalmente desactivada.
quedará resuelto su problema.
No se encontró su comercio en nuestros archivos. En breve se Existe una incidencia en la
2101
resolverá su problema. aplicación.
No se encontró su comercio en nuestros archivos. Por favor, Existe una incidencia en la
2102
avise a "la Caixa". aplicación.
2103 Su comercio está dado de baja en nuestros archivos
Cyberpac
No se encontró su terminal definido en nuestros archivos. Por Existe una incidencia en la
2202
favor, En breve se resolverá su problema. aplicación.
Su Terminal está dado de baja en nuestros archivos. Por favor, Existe una incidencia en la
2203
En breve se resolverá su problema. aplicación.
2300 Pago no aceptado por totpvcaixa
Cyberpac
2301 No podemos atender su petición
Cyberpac
La tarjeta del cliente está marcada como bloqueada para la La tarjeta es inválida. Contacte con
2302
operativa con terminales de nuestra entidad. su entidad financiera.
La tarjeta del cliente está marcada como perdida o robada en La tarjeta es inválida. Contacte con
2303
nuestros archivos. su entidad financiera.
2304 Tarjeta marcada como falsificada en nuestros archivos
Cyberpac
2305 Tarjeta cancelada por terminales de “la Caixa”
Cyberpac
2440 Moneda no permitida por este comercio
Cyberpac
La moneda empleada en la operación no está permitida para esta Moneda no permitida para esta
2441
fase de introducción del Euro. operación
Tipo de tarjeta aún no soportado por nuestra operativa. Contacte La tarjeta es inválida. Contacte con
2600
con "la Caixa". su entidad financiera.
2610 Caducidad de la tarjeta superada
Cyberpac
2620 La operación requiere el número secreto personal Reportar al administrador del
35
Cyberpac
Consultar entidad emisora de la
2644 Tarj. Amex o Hispamer (Eurocard). Op. no autorizada
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.
aplicación.
2802 Código de fraccionamiento inexistente.
aplicación.
2900 Operación no permitida
Cyberpac
3111 Superado número máximo de reintentos de PIN
Cyberpac
3113 Fecha de caducidad incorrecta Corregir
3114 Número de tarjeta incorrecto Corregir
Consultar entidad emisora de la
3118 Tarjeta 4B. Op. no autorizada
tarjeta
3200 La operación no existe en nuestros archivos
Cyberpac
La operación no se puede anular porque no se llegó a realizar Existe una incidencia en la
3202
completamente. aplicación.
3204 No pueden anularse las operaciones no autorizadas.
aplicación.
Está intentando anular una operación con una tarjeta diferente a Existe una incidencia en la
3211
la de la operación original. aplicación.
Está intentando anular una operación con importe diferente al
3214 empleado en la operación original. Y la tarjeta del cliente no es
aplicación.
una 6000 de nuestra entidad.
Está intentando anular una operación con una moneda diferente Existe una incidencia en la
3215
a la que se utilizó para la operación original. aplicación.
Está intentando anular una operación con un comercio diferente Existe una incidencia en la
3216
a la que se utilizó para la operación original "la Caixa". aplicación.
4013 Tarjeta marcada como perdida o robada
Cyberpac
La tarjeta es inválida. Contacte con
4014 La tarjeta del cliente está cancelada. Contacte con "la Caixa".
su entidad financiera.
El importe es erróneo o supera el
4015 El cliente ha sobrepasado el importe límite por operación.
límite por operación.
4017 Se ha tecleado incorrectamente el número secreto
Cyberpac
Su entidad financiera ha denegado la
La operación fue denegada por la entidad emisora de la tarjeta
4018 operación por motivos no detallados.
del cliente. Contacte con la entidad emisora.
Contacte con su entidad.
36
4020 Tarjeta del cliente a retener.
La operación fue denegada por la entidad emisora de la tarjeta Su entidad financiera ha denegado la
4022
del cliente. Contacte con la entidad emisora. operación por motivos no detallados.
No hay comunicación con CECA, centro autorizado de su Reportar al administrador del
4024
tarjeta Cyberpac
No hay comunicación con SEMP, centro autorizado de su Reportar al administrador del
4025
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
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
Cyberpac
4030 Su entidad o centro autorizador está fuera de servicio. Función temporalmente desactivada.
4031 Comercio no operativo en su centro autorizado
Cyberpac
4032 La tarjeta de supervisor del comercio es inválida
Cyberpac
4033 La tarjeta tiene la operativa restringida por su entidad. operación por motivos no detallados.
4034 La tarjeta del cliente está inactiva o es desconocida Cancelar pago
4035 La tarjeta no es valida para la red 6000.
4036 La tarjeta no es valida para intercambio.
4037 La tarjeta ha sido retenida
Cyberpac
4038 Tarjeta bloqueada por su entidad
Cyberpac
4039 La tarjeta está mal grabada Consulte a su entidad
4040 El emisor de la tarjeta no es conocido.
Su entidad o centro autorizado excede el tiempo límite de Reportar al administrador del
4041
respuesta Cyberpac
El importe de la operación supera el límite establecido por su El importe es erróneo o supera el
4042
entidad. límite disponible de la tarjeta.
El importe de la operación es menor
El importe de la operación es menor que el límite inferior
4043 que el límite inferior establecido por
establecido por su entidad.
su entidad.
4044 Operación no autorizada por su entidad Cancelar pago
El importe es erróneo o supera el
4045 El importe supera el límite disponible de la tarjeta.
límite disponible de la tarjeta.
4046 El importe supera el límite disponible por el comercio.
aplicación.
El importe supera el límite disponible por operaciones Reportar al administrador del
4047
internacionales Cyberpac
La fecha de caducidad de la tarjeta
4048 Error en la fecha de caducidad de la tarjeta de cliente.
tecleada es errónea.
4049 Error en el formato criptográfico del número personal
Cyberpac
El número secreto personal tecleado
4050 El número personal tecleado es erroneo.
es erróneo.
Se ha excedido el número de errores
4051 Se ha excedido el número de errores del número personal.
máximo de número personal.
37
4052 El formato de la transacción es erróneo
aplicación.
4053 El terminal no está operativo en CECA, su centro autorizado
Cyberpac
4054 La tarjeta del cliente está caducada Cancelar el pago
4055 La tarjeta del cliente no es procesable por el emisor.
4056 La anulación no es válida por la operación original
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
El elevado tráfico en las líneas impide que se pueda realizar la Reportar al administrador del
4059
operación Cyberpac
No hay comunicación con CECA, centro autorizado de su Reportar al administrador del
4060
tarjeta, por problemas de saturación Cyberpac
No se ha tecleado el número secreto
4061 No se ha tecleado PIN.
personal.
4062 La modalidad de pago fraccionado seleccionado no existe.
aplicación.
El comercio o la tarjeta no tiene permitido pago fraccionado de Existe una incidencia en la
4063
operaciones. aplicación.
4064 El comercio no está operativo en SEMP, su centro autorizador.
aplicación.
4065 Su entidad ha denegado la operación por motivos no detallados Consulte a su entidad
El importe de la operación supera el límite establecido por
4068 Cancelar el pago
operación
La operación fue denegada por la entidad emisora de la tarjeta Reportar al administrador del
4100
del cliente Cyberpac
4101
4102
La tarjeta está bloqueada o caducada, o la entidad emisora de la Reportar al administrador del
4201
tarjeta no está permitida Cyberpac
4500 Por favor, avise a "la Caixa" inmediatamente.
aplicación.
4512 No hay conexión con el centro autorizador SEMP. Función temporalmente desactivada.
4600 Función temporalmente desactivada
aplicación.
4601 No disponible recuperar la transacción original
Cyberpac
4602 Número de referencia inválido
Cyberpac
4603 Número de referencia i pan incompatibles
Cyberpac
4606 Su petición no puede ser cumplimentada
Cyberpac
4680 Identificativo de mensaje no soportado por la aplicación.
aplicación.
4683 Movimiento no cumple especificaciones de formato.
aplicación.
4684 RTS no válido
Cyberpac
4687 Mensaje no editable
Cyberpac
4690 Incidencia operativa en caixer
Cyberpac
4691 Teléfono no soportado por el sistema
Cyberpac
38
4692 Intentos de telecode excedidos
Cyberpac
4693 Denegada por diversos motivos
Cyberpac
Reportar al administrador de su
8003 Exceso de restricción al puerto del PROXY
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
El importe de la devolución supera el importe del
301 Volver a intentar con un importe inferior
pedido original
302 El pedido original no está pagado Seleccionar un pedido pagado
El medio de pago original no soporta este tipo de
303 Reportar al administrador del Cyberpac
devolución
Devolución ya finalizada correctamente en una
operación anterior
No existe ningún dato previo asociado a esta
devolución
39
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)
184 - Error en la autenticación del titular
190 - Denegación sin especifición de motivo
191 - Fecha de caducidad errónea
902 - Transacción denegada
904 - Comercio no dado de alta
40
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 para SHA1
%DEFINE {
SHOWSQL="NO"
CREAURL= %EXEC "D:/NetCommerce3/cgi-bin/URL/CrURLtpv.bat
$(jped) $(jimp) $(jmoneda) $(jidioma) $(jmailcomp) >
D:/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
41
3. Respuesta al notificador de la URL fija
// 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++;
}
return 0;
} /*Fin GetCampo()*/
42
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)
}
/* end if referenced with a POST method */
43
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]);
free(valor[0]);
free(bb[0]);
}
44

Cyberpac

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Cyberpac

Încărcat de

Drepturi de autor:

Formate disponibile

Cyberpac

Guía de uso del comercio

El Cyberpac verifica, entre otros datos, la autenticidad de la entidad, el saldo y el estado de la

El Cyberpac permite realizar devoluciones totales o parciales, del importe de la compra

Mediante el Cyberpac se podrán realizar pedidos en los que el comercio, en el momento de

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

También existe la posibilidad de que el comercio introduzca manualmente los pagos en el

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

Mediante el usuario de Línea Abierta podrá acceder a la aplicación de administración de su

3. Características del Cyberpac

3.1. Tipos de pago

Funcionamiento del comercio seguro:

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

identificador y el nº secreto. Una vez enviada la transferencia, el comercio la recibirá

- Si no es cliente de “la Caixa” o no ha contratado el servicio Línea Abierta, podrá

Domiciliaciones: el comprador tendrá que introducir el número de la cuenta y el nombre

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

- Tener un contrato de Línea Abierta Web

Vea las demostraciones de la opción http://comercios.lacaixa.es.

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

3.2. Notificación del pago

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

Notificación al comercio: Debe configurarlo desde la gestión de su comercio en el

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

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

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

Ver ejemplos en el apéndice 2.

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

Podrá encontrarlos en el apartado "Servicios/Comercios/Administración Cyberpac" dentro de

El único requisito del Cyberpac es el módulo Java 1.3.1.

4.1. Instalación en Windows

4.2. Instalación en UNIX

4.3. Parámetros de instalación

Línea Abierta Web, apartado "Servicios/Comercios/Administración Cyberpac" dentro de la

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

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

La utilidad CrURLtpv escogerá, aleatoriamente, una en cada operación de pago.

URL de error de datos

Ver el apartado “Resolución de problemas” al final de esta guía.

4.4. Reinstalación y desinstalación

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

Desinstalación sobre Windows NT

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

4.5. Contenido de la instalación

licencia.txt - Condiciones del contrato de Cyberpac.

Fichero de configuración tpv.cnf

Contiene líneas con el formato variable=valor

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

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

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

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

directorio_inst\tpv.zip - Path y fichero del paquete de clases internas.

No se podrá reutilizar el mismo número de pedido, una vez enviado a Cyberpac,

moneda - Divisa utilizada en el pago.

"XEU" o "EUR" para Euros.

importe - Importe del pago.

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:

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

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

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