VIRTUAL

MANUAL COMERCIO

TPV

GRUPO
COOPERATIVO
CAJAMAR
 TPV VIRTUAL
MANUAL COMERCIO

CONTENIDO

1. Introducción 03

2. Consultas operativas y de funcionamiento 03

3. Funcionamiento del TPV virtual (SIS) y garantías de seguridad 04

4. Alta y configuración del TPV Virtual 06

5. Tipos de operativas del TPV 10

6. Conexión de la web con el TPV 14

7. Módulo de administración del TPV Virtual 15

8. Pruebas recomendadas 21

9. Identificación de anomalías durante el proceso de compra 22

02
 TPV VIRTUAL
MANUAL COMERCIO

1.
INTRODUCCIÓN

Esta guía recoge los aspectos a tener en cuenta por los comercios que deseen
utilizar el TPV Virtual SIS en la instrumentación de sus compras por Internet.

Este paquete resume el conjunto de funcionalidades que el SIS ofrece a los

comercios: perfiles de funcionamiento, tipos de peticiones de autorización, nivel de
seguridad de los pagos,...

Asimismo, expone las indicaciones técnicas necesarias para realizar la conexión

del comercio con el TPV Virtual, junto con otros servicios añadidos de consulta y
envío de transacciones vía XML.

Por último, se detallan las opciones disponibles en la aplicación de administración

del SIS, de gran utilidad de cara a la gestión de los pedidos del comercio.

2.
CONSULTA DE OPERACIONES
Y DE FUNCIONAMIENTO

Las consultas de los comercios relativas a solicitud de documentación del

TPV Virtual deberán ser siempre dirigidas a su entidad financiera.

Para las consultas de los comercios relativas a configuración del TPV Virtual,
Cajamar dispone de un Centro de Atención a Comercios disponible todos los días,
tanto por mail como por teléfono al cual pueden dirigirse también para realizar
consultas y dudas operativas.

Teléfono: 901 210 102

Mail: [email protected]

Observación: Este servicio no engloba la prestación de servicios de consultoría

detallada de los desarrollos informáticos que se deben realizar para crear la web.

03
 TPV VIRTUAL
MANUAL COMERCIO

3.
FUNCIONAMIENTO DEL TPV VIRTUAL (SIS)
Y GARANTÍAS DE SEGURIDAD

El TPV virtual (SIS) es un dispositivo preparado para trabajar en modo totalmente

seguro dentro de la operativa de ventas a través de Internet, es decir:

A. Si la Entidad Financiera adquirente así lo decide, el TPV intentará contactar con

el banco emisor de la tarjeta para solicitar la autenticación del titular (verificación de
su identidad). De esta forma se puede garantizar, que solo el titular genuino, dueño
de la tarjeta, podrá operar con ella.

B. Implementa SSL en todas las comunicaciones que impiden la interceptación de

la información por terceros. Por tanto, la confidencialidad está asegurada en
todas las comunicaciones que se establezcan durante la transacción.

C. También habilita mecanismos para verificar la autenticidad del origen de las

transacciones. Esto impide, la manipulación de datos por terceros y garantiza
la integridad de la transacción.

D. La información confidencial de las tarjetas normalmente no es conocida por el

comercio, salvo que su banco adquirente le autorice a ello. Con esto se evita que esta
información pueda ser robada al comercio posteriormente por terceros con fines
fraudulentos. La mejor manera de salvaguardar en el comercio una información sensible
de clientes es NO tenerla. La información de la tarjeta es almacenada convenientemente
por Redsys, por si fuera necesario reutilizarla, por ejemplo, en una devolución.
Por tanto, todas las transacciones que se realicen a través del TPV Virtual contarán
con todas las garantías de seguridad, confidencialidad e integridad para los agentes
participantes: titulares de tarjetas y sus entidades de GCC emisoras, y comercios y
sus entidades adquirentes.

El TPV Virtual estará adaptado a las últimas versiones de pago seguro que vayan
dictando los organismos reguladores internacionales.

En todo momento, el comercio recibe información puntual del estado de cada

transacción, permaneciendo a su disposición un histórico de 360 días para las consultas
de detalle, totales, gestión de devoluciones, etc. que el comercio pudiera necesitar.

04
 TPV VIRTUAL
MANUAL COMERCIO

E. El TPV Virtual incluye un módulo de administración para todos aquellos

comercios que no dispongan de los medios o los conocimientos para desarrollar
su propia herramienta de gestión de operaciones.

El siguiente gráfico resume el flujo de una transacción segura típica:

COMERCIO
TITULAR
1. Solicitud de Venta
DATOS DEL COMERCIO

4. AUTENTIFICACIÓN

2. TARJETA TPV
VIRTUAL
SERVIDOR
DE EMISOR 3. Solicitud de Autentificación

5. Solicitud de Autorización

HOST HOST
REDES DE
ENTIDAD ENTIDAD
MEDIOS DE PAGO
EMISORA ADQUIRIENTE

Resumidamente la transacción de pago con tarjeta transcurre de la siguiente forma:

Una vez que el titular tiene los productos en su cesta de la compra, y tras pulsar el
botón de “Pagar” (o similar) que el comercio tenga en la web, el comercio conectará
con el TPV Virtual, y en esa primera conexión, le facilitará al TPV los datos de la
transacción: el importe, la moneda, el identificativo y nombre del comercio.

Tras esto el TPV Virtual presentará una página al tiular solicitándole los datos de la
tarjeta al comprador, y una vez introducidos el TPV Virtual los enviará al banco del
comprador.

Nota: en función de la configuración del TPV se le podrá solicitar al titular que

introduzca su clave segura de comercio electrónico (cada banco emisor tiene la
suya; contraseña, envío de SMS al móvil, tarjeta de coordenadas,…).

05
 TPV VIRTUAL
MANUAL COMERCIO

Cuando el pago ha finalizado, el titular verá la siguiente pantalla con el resultado

de la operación. Esto es el recibo y en él figurará un número de pedido. Para
cualquier duda o aclaración deberá facilitarle al comercio este número de pedido.
> RESULTADO DE LA COMPRA

Importe 1,45 Euros

Comercio Comercio Pruebas
Código Comercio 999008881
Terminal 1
Número pedido 080806141511
Número Tarjeta ************0004
Hora 14 : 15
Url Comercio http://www.comercioDemo.com
Descripción producto Alfombrilla para ratón
Importe 10,50 euros

Gracias por su compra Imprimir Continuar

OPERACIÓN AUTORIZADA CON CÓDIGO: 815206

4.
ALTA Y CONFIGURACIÓN DEL TPV VIRTUAL

Cualquier comercio que necesite un TPV Virtual deberá ponerse en contacto con
una oficina del Grupo Cooperativo Cajamar para facilitarle los datos que la misma
le facilite. Será la propia entidad la que confirme directamente al comercio la
realización del alta.

El TPV tiene varios parámetros de configuración.

Monedas: una vez realizada el alta esta configuración no puede modificarse. Las
disponibles son:

840 (DOLAR U.S.A.) USD 356 (INDIAN RUPEE) INR 24 (ANGOLA KWANZA) AOK
826 (POUND STERLING) GBP 484 (MEXICAN PESO) MXP 30 (PROBANDO DESA) MON
392 (YEN) JPY 604 (PERU INTI) PEI 31 (AZERBAIJANIAN MANAT) AZM
32 (ARGENTINE AUSTRAL) ARP 756 (SWISS FRANC) CHF 32 (ARGENTINE AUSTRAL) ARP
36 (AUSTRALIAN DOLLAR) AUD 858 (URUGUAYAN PESO) UYP 36 (AUSTRALIAN DOLLAR) AUD
124 (CANADIAN DOLLAR) CAD 986 (BRAZILIAN REAL) BRL 44 (BAHAMIAN DOLLAR) BSD
152 (CHILEAN PESO) CLP 949 (TURKISH LIRA) TRY 48 (BAHRAINI DINAR) BHD
170 (COLOMBIAN PESO) COP 8 (LEK) ALL 50 (TAKA) BDT
188 (COSTA RICA COLON) CRC 12 (ALGERIAN DINAR) DZD 51 (ARMENIAN DRAM) AMD

06
 TPV VIRTUAL
MANUAL COMERCIO

52 (BARBADOS DOLLAR) BBD 270 (DALASI) GMD 496 (TUGRIK) MNT

60 (BERMUDAN DOLLAR) BMD 278 (MARK DER DDR) DDM 498 (MOLDOVIAN LEU) MDL
64 (NGULTRUM) BTN 288 (GHANA CEDI) GHC 504 (MORROCAN DIRHAM) MAD
68 (BOLIVIAN PESO) BOP 292 (GIBRALTAR POUND) GIP 508 (METICAL) MZM
70 (DINAR) BAD 320 (QUETZAL) GTQ 512 (RIAL OMANI) OMR
72 (PULA) BWP 324 (SYLI) GNS 516 (NAMIBIAN DOLLAR) NAD
76 (CRUZEIRO) BRC 328 (GUYANA DOLLAR) GYD 524 (NEPALESE RUPEE) NPR
84 (BELIZE DOLLAR) 084 332 (GOURDE) HTG 532 (NETHERLANDS ANTILLIA) ANG
90 (SOLOMON ISLANDS DOLL) SBD 340 (LEMPIRA) HNL 533 (ARUBA) AWG
96 (BRUNEI DOLLAR) BND 344 (HONG KONG DOLLAR) HKD 536 (YUGOSLAVIAN NEW DIAN) NTZ
100 (LEV) BGL 348 (FORINT) HUF 548 (VANUATU VATU) VUV
104 (KYAT) BUK 352 (ICELAND KRONA) ISK 554 (NEW ZEALAND DOLLAR) NZD
108 (BURUNDI FRANC) BIF 356 (INDIAN RUPEE) INR 556 (NAIRA) 566
112 (BELARUSSIAN RUBLE) BYB 360 (RUPIAH) IDR 558 (CORDOBA) NIC
116 (RIEL) KHR 364 (IRANIAL RIAL) IRR 566 (NAIRA) NGN
124 (CANADIAN DOLLAR) CAD 365 (IRANIAN AIRLINE RATE) IRA 578 (NORWEGIAN KRONE) NOK
132 (CAPE VERDE ESCUDO) CVE 368 (IRAQI DINAR) IQD 582 (PACIFIC ISLAND) PCI
136 (CAYMAN ISLANDS DOLLA) KYD 376 (ISRAEL SHEKEL) ILS 586 (PAKISTAN RUPEE) PKR
144 (SRI LANKA RUPEE) LKR 388 (JAMAICAN DOLLAR) JMD 590 (BALBOA) PAB
152 (CHILEAN PESO) CLP 392 (YEN) JPY 598 (KINA) PGK
156 (YUAN RENMINBI) CNY 398 (TENGE) KZT 600 (GUARANI) PYG
157 (CHINESE RENMIMBI) CNH 400 (JORDANIAN DINAR) JOD 604 (PERU INTI) PEI
158 (CHINESE RENMINBI) CNX 404 (KENYAN SHILLING) KES 608 (PHILIPPINE PESO) PHP
170 (COLOMBIAN PESO) COP 408 (NORTH KOREAN WON) KPW 616 (ZLOTY) PLZ
174 (COMOROS FRANC) KMF 410 (KOREAN WON) KRW 624 (GUINEA
180 (ZAIRE) ZRZ 414 (KUWAITI DINAR) KWD 626 (TIMOR ESCUDO) TPE
188 (COSTA RICA COLON) CRC 417 (KYRGYZSTAN SON) KGS 634 (QATARI RIAL) QAR
191 (CROATIAN KUNA) HRK 418 (KIP) LAK 642 (LEU) ROL
192 (CUBAN PESO) CUP 422 (LEBANESE POUND) LBP 643 (RUSSIAN ROUBLE) RUB
196 (CYPRUS POUND) CYP 426 (LESOTHO LOTI) LSM 646 (RWANDA FRANC) RWF
200 (KORUNA) CSK 428 (LATVIAN LAT) LVL 654 (ST.HELENA POUND) SHP
203 (CZECH KORUNA) CZK 430 (LIBERIAN DOLLAR) LRD 678 (DOBRA) STD
208 (DANISH KRONE) DKK 434 (LIBYAN DINAR) LYD 682 (SAUDI RIYAL) SAR
214 (DOMINICAN PESO) DOP 440 (LITHUANIAN LITAS) LTL 690 (SEYCHELLES RUPEE) SCR
218 (SUCRE) ECS 446 (PATACA) MOP 694 (LEONE) SLL
222 (EL SALVADOR COLON) SVC 450 (MALAGASY FRANC) MGF 702 (SINGAPORE DOLLAR) SGD
226 (EKWELE) GQE 454 (MALAWI KWACHA) MWK 703 (SLOVAK KORUNA) SKK
230 (ETHIOPIAN BIRR) ETB 458 (MALASYAN RINGGIT) MYR 704 (DONG) VND
232 (ERITREAN NAKTAN) ERN 462 (MALDIVE RUPEE) MVR 705 (SLOVENIAN TOLAR) SIT
233 (ESTONIAN KROON) EEK 466 (MALI) MLF 706 (SOMALI SHILLING) SOS
238 (FALKLAND ISLANDS) FKP 470 (MALTESE LIRA) MTL 710 (RAND) ZAR
242 (FIJI DOLLAR) FJD 478 (OUGUIYA) MRO 716 (ZIMBABWE DOLLAR) ZWD
262 (DJIBOUTI FRANC) DJF 480 (MAURITIUS RUPEE) MUR 720 (YEMENI DINAR) YDD
268 (GEORGIAN LARI) GEL 484 (MEXICAN PESO) MXP 728 (SOUTH SUDANESE POUND) SSP

07
 TPV VIRTUAL
MANUAL COMERCIO

736 (SUDANESE POUND) SDP 826 (POUND STERLING) GBP 952 (CFA FRANC BCEAO) XOF
737 (SUDAN AIRLINES) SDA 834 (TANZANIAN SHILLING) TZS 953 (CFP FRANC) XPF
740 (SURINAM GUILDER) SRG 840 (DOLAR U.S.A.) USD 954 (E.C.U. (EUROPEAN CUR) XEU
748 (LILANGENI) SZL 858 (URUGUAYAN PESO) UYP 967 (KWACHA) ZMW
752 (SWEDISH KRONA) SEK 860 (UZBEKISTAN SUM) UZS 968 (SURINAME DOLLAR) SRD
756 (SWISS FRANC) CHF 862 (BOLIVAR) VEB 969 (ARIARY) MGA
760 (SYRIAN POUND) SYP 882 (TALA) WST 971 (AFGHANISTAN AFGHANI) AFN
762 (TAJIK RUBLE) TJR 886 (YEMINI RIAL) YER 972 (TAJIKISTAN SOMONI) TJS
764 (BAHT) THB 890 (NEW YUGOSLAVIAN DOLL) YUD 973 (KWANZA ANGOLA) AOA
776 (PA'ANGA) TOP 891 (NEW DINAR) YUG 974 (BELARUSSIAN RUBLE) BYR
780 (TRINIDAD & TOBAGO DO) TTD 894 (KWACHA) ZMK 975 (NEW LEV) BGN
784 (UAE DIRHAM) AED 901 (NEW TAIWAN DOLLAR) TWD 976 (FRANCO DEL CONGO) CDF
788 (TUNISIAN DINAR) TND 934 (NEW MANAT) TMT 977 (BOSNIAN MARKA) BAM
792 (TURKISH LIRA) TRL 936 (GHANA CEDI) GHS 978 (EURO) EUR
793 (PSEUDO TURKISH LIRA) PTL 941 (DINAR SERBIO) RSD 980 (HRYVNIA) UAH
795 (MANAT) TMM 943 (MOZAMBIQUE METICAL) MZN 981 (GEORGIAN LARI) GEL
800 (UGANDA SHILLING) UGS 944 (AZERBAIJANIAN MANAT) AZN 985 (NEW POLISH ZLOTY) PLN
804 (KARBOVANET) UAK 946 (NEW LEU) RON 986 (BRAZILIAN REAL) BRL
807 (MACEDONIAN DENAR) MKD 949 (TURKISH LIRA) TRY 988 (PELA) 988
810 (RUSSIAN ROUBLE) RUR 950 (CFA FRANC BEAC) XAF 991 (RAND FINANCIER) ZAL
818 (EGYPTIAN POUND) EGP 951 (EAST CARIBBEAN DOLLA) XCD 995 (PESETA CONVERTIBLE) ESB

Nota: Los terminales en moneda distinta de euro solo pueden ser utilizados con
tarjetas extranjeras.

E-Mail del comercio, al que se enviará la información pertinente.

Configurable por el comercio.

Notificación ON-LINE: el comercio podrá usar esta opción si desea recibir comunicaciones
instantáneas con el resultado de cada compra que se realiza en su web. En los manuales de
integración se recoge una descripción más amplia de esta opción. (ver Manual de integración
para conexión por redirección / Manual de integración para conexión webservice).
NOTA: este mecanismo no tiene sentido en conexiones HOST to HOST ya que el comercio
nunca pierde el control de la sesión durante la compra.
Las IP’s desde las cuales se pueden recibir estas notificaciones son:
195.76.9.187 195.76.9.222
Sincronización: este parámetro está relacionado con la notificación “online” descrita
en el apartado anterior. Permite cuatro valores:

08
 TPV VIRTUAL
MANUAL COMERCIO

1. Síncrona. Implica que el resultado de la compra primero se envía al comercio y a

continuación al cliente y con el valor. Aunque la notificación sea errónea la operación no
se cambia.
2. Asíncrona. Implica que el resultado de la autorización se comunica a la vez al
comercio y al cliente.
3. Síncrona SOAP. La notificación que se envía al comercio es una petición SOAP a un
servicio que deberá tener publicado el comercio. Con este tipo de notificación. El SIS no
da respuesta al titular hasta que recibe la confirmación del comercio de haber recibido
la notificación. En el caso en el que la respuesta SOAP que envíe el comercio tenga un
valor KO o que se produzca un error en el proceso de notificación, se dará una respuesta
negativa al titular y la operación no se autorizará. Este tipo de notificación solo aplicará
a las siguientes operaciones: Autorización, Preautorización, Transacción Recurrente y
Autenticación. Para las demás operaciones la notificación se enviará de forma síncrona.
En el Manual de integración para conexión por redirección puede encontrar una
explicación detallada de este tipo de sincronización.
4. Síncrona SOAP con WSDL. Igual a la SíncronaSOAP, pero en este caso el servidor
SOAP que desarrolla el cliente se ajusta a las especificaciones de una WSDL (en el
Manual de integración para conexión por redirección se incluye la especificación de la
WDSL).. Se recomienda este último tipo de notificación, que garantiza un entendimiento
perfecto entre servidor y cliente.

Personalización del terminal.

Las pantallas que se muestran al cliente durante el proceso del pago pueden ser
personalizadas. Para ello el comercio deberá generar su propio código HTML
según los criterios descritos en la Guía de Personalización del TPV Virtual. Si lo
desea puede solicitar esta documentación a su entidad adquirente. La opción por
defecto es NO.
URL_OK/URL_KO:
durante el proceso del pago, y una vez que se muestra al cliente la pantalla con el
recibo, es posible redirigirlo de vuelta a la web que nos indique el comercio. Esta
redirección el comercio las informa en lo que denominamos URL_OK y URL_KO, y
son opcionales.

NOTA: estas URLs NO deben utilizarse como mecanismo de notificación que

varíe el stock de productos o servicios del comercio, ya que sólo en el caso de
que el titular decida continuar la navegación, se notificaría mediante estas
URLs. Lo correcto es utilizar la Notificación on-line anteriormente mencionada.

09
 TPV VIRTUAL
MANUAL COMERCIO

Idioma:
las páginas del TPV de Redsys que se muestran al titular están traducidas a varios
idiomas, y el comercio podrá utilizar cualquiera de ellos. El idioma no tendrá por
qué ser el mismo en cada transacción.

Actualmente los idiomas disponibles son los siguientes:

Castellano, Francés , Polaco, Catalán, Croata, Portugués, Valenciano, Japonés,
Ruso, Gallego, Letón, Búlgaro, Euskera, Lituano, Esloveno, Checo, Húngaro,
Eslovaco, Danés, Maltés, Finlandés, Alemán, Turco, Holandés, Estonio, Italiano,
Indio, Griego, Rumano, Inglés, Sueco.

Si el TPV del comercio está configurado para mostrar el aspecto de la entidad el

idioma dependerá entonces de la entidad, y el comercio deberá consultar con su
banco qué idiomas ofrecen.

Métodos de pago:
esta configuración únicamente puede definirla la entidad adquirente, que
seleccionará aquel o aquellos métodos más adecuados para garantizar una
correcta operativa de cada comercio.

5.
TIPOS DE OPERATIVAS DEL TPV

En función de las necesidades de cada comercio, el TPV Virtual SIS ofrece una elevada
variedad de operativas. El comercio puede usar varias según sus necesidades y según
la configuración que su entidad del GCC le permita tener.

Autorización
Es el caso más general donde la transacción es iniciada por el titular, que está conectado
a través de Internet a la página web del comercio durante el proceso de compra. El TPV
Virtual solicita al cliente los datos de la tarjeta para realizar la transacción.
La transacción es capturada automáticamente por el TPV Virtual y enviada diariamente
en lotes a GCC para que proceda a su abono al comercio.
Al titular de la tarjeta se le muestra por pantalla un justificante del pago realizado, que
puede imprimir.
Al comercio se le envía una confirmación del cobro que va a recibir para que proceda
a servir el producto o servicio a su comprador.

10
 TPV VIRTUAL
MANUAL COMERCIO

Paygold
Permite al comercio iniciar el proceso de compra enviando una solicitud de cobro a sus
clientes. El comercio sólo necesita acceder desde un navegador web a la página de
https://canales.redsys.es y seleccionar el apartado Paygold, rellenando los detalles de la
compra. Alternativamente se puede realizar una integración por webservice (consultar
manual TPV-Virtual Pago por e-mail_SMS). Según se seleccione, al cliente le llegará
un mensaje a su móvil o su email para que pueda realizar el pago.

Podrán solicitar la activación de esta Operativa desde su oficina gestora de Cajamar o

enviando un correo desde su dirección autorizada del comercio enviando un correo a
Soporte Virtual.

Preautorización
Permite a los comercios realizar comprobaciones adicionales de las operaciones
que reciben en su web antes de confirmar la transacción y servir el pedido.

El comercio podrá solicitar el tiempo de validez de la preautorizacion, hasta un

máximo de 30 días para confirmarla (siempre por el mismo importe) o anularla.

En caso de no confirmarse o anularse en este plazo, perderá su validez y el

sistema generará una anulación automática.

La transacción es transparente para el titular que en todo momento actúa

exactamente igual que en el caso anterior.

Esta transacción no produce efectos contables hasta que no se confirma, ni por

tanto abono al comercio. Dependiendo de la política de cada Entidad emisora, este
tipo de operaciones puede producir un cargo en la cuenta del titular, incluso antes
de que se confirme. Esto depende exclusivamente de la Entidad emisora.

Confirmación de Preautorización
Esta transacción ya tiene efecto contable y debe realizarla el comercio en el tiempo
configurado, que será de hasta un máximo de 30 días siguientes a la operación
anterior y su importe puede ser HASTA UN 15% SUPERIOR al original.

Anulación de Preautorización
Es siempre iniciada por el comercio. Debe realizarse en el tiempo configurado, que
será de hasta un máximo de 30 días siguientes a la autorización en diferido original.

El TPV Virtual validará la existencia de la operación original, rechazando la

operación en caso de existir algún error.

11
 TPV VIRTUAL
MANUAL COMERCIO

Devolución
El TPV Virtual comprueba que el importe de la operación que se desea devolver no
supere el original.

Son capturadas automáticamente y enviadas a GCC, que cargará el importe en la

cuenta del comercio. El momento del abono al titular depende de la política
comercial de cada Entidad Emisora.

Autenticación
Este tipo de operación no tienen ningún efecto contable. Puede ser utilizada por
el comercio cuando el importe de la venta no puede ser determinado con exactitud
en el momento de producirse la misma.

Nota: Con esta operación no hay retención en cuenta al titular, ni el comercio

tendrá garantía de cobro de la misma. La autenticación, valida la numeración de
tarjeta, la identidad del titular de la tarjeta, CVV2/CVC2 y la fecha de caducidad de
la tarjeta, así como que la tarjeta está activa.

Posteriormente en un plazo de 45 días el comercio enviará la Confirmación de

Autenticación.

Confirmación de Autenticación
Su importe puede ser menor, igual, o mayor en un 15% al importe de la operación
original, y debe realizarse en los 45 días siguientes a la autenticación original. Esta
transacción tiene efectos contables.

Operativa Pago por Referencia (PAGO en un CLICK)

Esta operativa permite a los titulares comprar en una web haciendo sólo un click.
En la primera compra el titular introduce los datos de la tarjeta, y Redsys le devuelve
al comercio una referencia única asociada a esa tarjeta. Para compras posteriores
el comercio únicamente necesitará esta referencia para realizar los cobros a sus
titulares. De esta forma no necesita almacenar datos sensibles de la tarjeta.

La configuración de esta operativa debe realizarla la entidad en el perfil del

comercio. Así mismo la entidad deberá facilitar al comercio la documentación
técnica necesaria para poder utilizarla.

12
 TPV VIRTUAL
MANUAL COMERCIO

Para que un comercio pueda trabajar con el método de Pago PayPal, tendrá que
seguir los siguientes pasos:

Darse de alta en Paypal con una cuenta para comercios y obtener los datos
necesarios para que el servicio de Soporte TPV Virtual de Cajamar pueda configurar
el terminal.

Estos datos necesarios:

- Usuario Paypal (API Username)
- Clave Paypal (API Password)
- Firma Paypal (Signature)
- Correo Paypal (Account)

Una vez proporcionados estos datos se realizará la integración de su cuenta de

Paypal para comercios en su terminal.

Pantalla de configuración del comercio en Canales

Recibe correos de alertas on-line NO

Mail Supervisor
Texto del Recibo
Idioma

<< >>
Eliminar

Usuario Paypal (API Username) ************************ Activo

Clave Paypal (API Password) *******************
Firma Paypal (Signature) AtDkwRsx9F8uDo-f3
Correo Paypal (Account) ***************************
Sandbox Paypal SI

Isps Sin Ipsp

Moritorización Seguridad NO
Versión reglas 2

Métodos de Pago Seleccionados

Domiciliación Verified by Visa

Transferencia Tradicional Mundial
Prohibir envio Tarjeta Servired-Finanet Vida (horas) 0 horas
MasterCard Comercial MasterCard SecureCode
Transferencia LA Pago JCB

13
 TPV VIRTUAL
MANUAL COMERCIO

Pantalla de configuración de las credenciales de PayPal en (Sandbox- Pruebas)

Help I Profile I Log Out

Sandbox

Sandbox
Home
PayPal Sandbox
Test Accounts
API Credentials
Test Email
You must have credentials to test APIs for PayPal Payments Pro and Express Checkout in the
API and Payment Card Sandbox. In most cases, you will use API signatures and not download certificates.
Credentials

Test Tools The test accounts identified below are enabled for API access.

Note: These credentials will not work outside the Sandbox. You will need new credentials from
paypal.com to go live.
Additional resources
Documentation Go to Payment Card Credentials
PayPal Developer Network Test Account Date Created
Customer Support Test Account: [email protected] Feb 19, 2016 09:24:00 PST
API Username: irider_136120000_biz_api1.redsys.es
API Password: 136120000
Signature: AtDkwRsx9F8guDo-f3-5004TRS-GVfX2d42TwSIdOYLb1DTOVv

To download the cretificate, log into the sandbox test account profile and remove the 3 token
credentials associated with the account. For more information refer to the Sandbox User Guide.

6.
CONEXIÓN DE LA WEB CON EL TPV

En el momento que el comprador pulse el botón de pago, el comercio rellenará un

formulario web con los datos de la transacción.

La descripción técnica de este formulario pueden encontrarla en los siguientes

manuales, dependiendo de tipo de conexión que utilice:

TPV-Virtual Manual Integración – Redirección.

TPV-Virtual Manual Integración – Webservice.

La ventana o frame donde se abra el TPV Virtual ha de tener barras de

desplazamiento para poder adaptarse a las diferentes páginas de autenticación
que pudieran mostrarse al titular en los procesos posteriores.

A partir de este punto, el TPV Virtual gestionará completamente la autorización sin

que sea necesaria la intervención del comercio. En todo momento la operativa se
ajustará a la configurada para cada comercio.

14
 TPV VIRTUAL
MANUAL COMERCIO

7.
MÓDULO DE ADMINISTRACIÓN DEL TPV VIRTUAL SIS

Desde el Módulo de Administración podrá realizar las operaciones administrativas

y de gestión de las operaciones de su comercio en Internet.

El aspecto del módulo de administración puede variar según la Entidad del GCC
con la que el esté contratado el TPV. Las URL’s a las que deben conectarse los
comercios son:
https://sis-t.redsys.es:25443/canales (entorno de pruebas)
https://sis.redsys.es/canales/ (entorno real)

Le aparecerá una página donde tendrá que introducir el usuario y contraseña que
previamente le habrá facilitado GCC, así como el idioma en que desea realizar la
consulta (castellano, inglés, catalán, francés, alemán, italiano y portugués).
ES

Usuario

Contraseña

Aceptar

He olvidado mi usuario
He olvidado mi contraseña

Una vez dentro verá una pantalla similar a esta:

CAJAMAR Evolución de la actividad

Admin tpv virtual
Últimos 30 días

Inicio

15
 TPV VIRTUAL
MANUAL COMERCIO

En el carrito de la compra podrá consultar y gestionar las operaciones del TPV. El icono
de usuarios le permitirá gestionar su contraseña y a la vez gestionar los permisos de
otros usuarios del comercio, si existieran. El tercer icono es de documentación.

Consultas y administración de operaciones

Dentro del carrito de la compra, en el apartado de “Consultas”, podrá consultar y

administrar de forma muy intuitiva todas las operaciones de un TPV Virtual.

Podrá consultar el detalle de las mismas, realizar devoluciones (totales o parciales),

y confirmar manualmente los tipos de operaciones que lo requieran indicadas
anteriormente, por ejemplo, las Autorizaciones en Diferido.

El TPV Virtual ofrece esta posibilidad para los últimos 360 días de operaciones, y
siempre realizadas en intervalos de 30 días como máximo.

Además todas estas operaciones podrán ser exportadas a Excel y en formato .txt

ES

Nº de comercio Nº de terminal Tipo consulta

X Nº de terminal Fechas Buscar

Pedido Hora Inicio Hora Fin

Exportar tabla
07-08-1018 a 06-09-1018 00 00 23 59
Imprimir tabla

Filas por página 25

Columnas a mostrar

Nº de Tipo Nº de Resultado operación Cierre de

Fecha Importe Tipo de pago Tipo pago Detalle Nº Tarjeta Opciones
terminal Operación pedido y Código sesión

20.08.2018
1 Autorización 189732 Autorizada 141743 1038,24 EUR 1/ ServiRed-Finanet ServiRed-Finanet 427367******3020
07:05:24

20.08.2018
1 Autorización 189988 Cancelada 1038,24 EUR
08:24:36

22.08.2018
1 Autorización 189989 Autorizada 171912 1038,24 EUR 1/ Verified by Visa Verified by Visa 455578******9144
12:05:00

02.09.2018 MasterCard MasterCard

1 Autorización 190035 Denegada 190 5596,29 EUR 1/ 547268******3003
07:05:24 SecureCode SecureCode

04.09.2018
1 Autorización 190055 Sin Finalizar 9998 5596,29 EUR
03:45:03

16
 TPV VIRTUAL
MANUAL COMERCIO

Este es un glosario de los códigos de respuesta que se muestran en el campo

“Resultado Nº Autorización o código de respuesta”:

101 Tarjeta caducada

102 Tarjeta en excepción transitoria o bajo sospecha de fraude
106 Intentos de PIN excedidos
125 Tarjeta no efectiva
129 Código de seguridad (CVV2/CVC2) incorrecto
180 Tarjeta ajena al servicio
184 Error en la autenticación del titular
190 Denegación sin especificar Motivo
191 Fecha de caducidad errónea
202 Tarjeta en excepción transitoria o bajo sospecha de fraude con retirada de tarjeta
904 Comercio no registrado en FUC
909 Error de sistema
991/912 Emisor no disponible
950 Operación de devolución no permitida
9064 Número de posiciones de la tarjeta incorrecto
9078 Tipo de operación no permitida para esa tarjeta
9999 Operación que ha sido redirigida al emisor a autenticar
9998 Operación en proceso de solicitud de datos de tarjeta
9997 Se está procesando otra transacción en SIS con la misma tarjeta
9093 Tarjeta no existente
9218 El comercio no permite op. seguras por entrada/operaciones
9253 Tarjeta no cumple el check-digit
9256 El comercio no puede realizar preautorizaciones
9257 Esta tarjeta no permite operativa de preautorizaciones
9261 Operación detenida por superar el control de restricciones en la entrada al SIS
9913 Error en la confirmación que el comercio envía al TPV Virtual
(solo aplicable en la opción de sincronización SOAP)
9914 Confirmación “KO” del comercio (solo aplicable en la opción de sincronización SOAP)
9928 Anulación de autorización en diferido realizada por el SIS (proceso batch)
9929 Anulación de autorización en diferido realizada por el comercio
9104 Comercio con “titular seguro” y titular sin clave de compra segura
9915 A petición del usuario se ha cancelado el pago
9094 Rechazo servidores internacionales
944 Sesión Incorrecta
913 Pedido repetido

17
 TPV VIRTUAL
MANUAL COMERCIO

Realizar una devolución

No a todos los usuarios con acceso a la administración de las operaciones de su

comercio en Internet les está permitido el poder realizar devoluciones. Estos
permisos son configurables a nivel de usuario.
Si su usuario está autorizado y desea realizar una devolución parcial o total de una de
las operaciones seleccionadas, pulse el botón de la columna opciones que
corresponda a la operación deseada y le aparecerá la página siguiente.

Nº de Tipo Nº de Resultado operación Cierre de

Fecha Importe Tipo de pago Tipo pago Detalle Nº Tarjeta Opciones
terminal Operación pedido y Código sesión

20.08.2018
1 Autorización 189732 Autorizada 141743 1038,24 EUR 1/ ServiRed-Finanet ServiRed-Finanet 427367******3020
07:05:24

Generar devolución X

Fecha y hora 01/09/2018 01.13.25

Nº de terminal 1
Tipo operación y Nº pedido Autorización 199

Resultado operación y código Autorizada 40919

Importe 370,87 EUR

Importe devuelto 0,00 EUR

Tipo de pago ServiRed-Finanet

IP 16 España

Cantidad a devolver

N NN

Aceptar

Deberá introducir el importe a devolver (el importe devuelto nunca deberá

sobrepasar el de la operación original) y pulsar el botón aceptar.

En el caso de operativa DCC, deberá introducir el importe en la moneda del TPV.

A continuación le mostrará una página ticket de devolución pudiéndola imprimir o
archivar si lo desea.

Para poder consultar una devolución se pulsará sobre el importe que figura como
devuelto en la consulta de operaciones indicada anteriormente.

18
 TPV VIRTUAL
MANUAL COMERCIO

Confirmación y anulación de operaciones

Aquellos comercios con operativa de Preautorizaciones, podrán generar

confirmaciones y anulaciones de las mismas a partir del módulo de administración
del TPV Virtual. El comercio podrá emplear el módulo de administración para
generar las confirmaciones y anulaciones de preautorizaciones.

Consulta de totales

Pulsando el botón de “Totales”, que aparece en la parte izquierda de la página, el

sistema solicitará la sesión cuyos totales desea consultar. La consulta de totales
está disponible:

- Sin desglose (360 últimas sesiones).

- Con desglose, por marca de tarjeta.

DESGLOSE POR MARCA DE TARJETA

Nº de Terminal Marca tarjeta Pedido

1 Todas 07-08-1018 a 06-09-1018 Firmar

Imprimir tabla Exportar tabla

Total de transacciones
Sesión (01-10-2018 17-10-2018)

Aceptadas Denegadas Importe aceptado Importe denegado

Autorización 12 2 539,14 EUR 70,80 EUR

Introduciendo el rango de fechas deseado, aparecerá a continuación una nueva

pantalla con los importes agregados de las operaciones realizadas en ese período.

Vendrán diferenciadas por cada tipo de operación, el número de cada una de ellas
y una distinción entre las autorizadas y las denegadas.

19
 TPV VIRTUAL
MANUAL COMERCIO

Consulta de Notificación

Pulsando el botón de “Notificación”, que aparece en la parte izquierda de la página,

se podrá consultar el resultado de la Notificación OnLine de las operaciones
enviada al comercio en un rango de fechas deseado.

DESGLOSE POR MARCA DE TARJETA

Nº de Terminal Marca tarjeta Pedido

1 Todas 07-08-1018 a 06-09-1018 Firmar

Imprimir tabla Exportar tabla

Total de transacciones
Sesión (01-10-2018 17-10-2018)

Aceptadas Denegadas Importe aceptado Importe denegado

Autorización 12 2 539,14 EUR 70,80 EUR

Cambio de contraseña

Por motivos de seguridad deberá cambiar su contraseña periódicamente. Para

hacerlo deberá acudir al apartado “usuarios” y rellenar los campos que se
muestran tras pulsar el icono de ajustes de la columna opciones

Opciones

Podrá seleccionar recibir la nueva contraseña vía teléfono(SMS) o vía correo

electrónico.

20
 TPV VIRTUAL
MANUAL COMERCIO

8.
PRUEBAS RECOMENDADAS

Una vez el comercio ha realizado la conexión al TPV Virtual y visualiza la pantalla de petición
de tarjeta, se recomienda la realización de las siguientes pruebas operativas con el fin de
poder conocer el funcionamiento del TPV virtual. Estas pruebas deberán efectuarse en el
entorno de pruebas especificado en los manuales de integración (Manual de integración
para conexión por redirección / Manual de integración para conexión Webservice).

Para realizar estas pruebas es necesario tener habilitado el acceso a los puertos 25443 y
26443, con el número de tarjeta siguiente:

Tarjeta: 4548812049400004
Fecha de caducidad: 12/20
Código de Seguridad: 123
CIP: 123456

1. Prueba de compra: conectándose al TPV Virtual, realice una operación de compra con
los datos proporcionados. Al final de la operación el TPV Virtual le mostrará una pantalla con
los datos de la operación y el resultado de la misma.

2. Prueba de devoluciones: los comercios conectados al SIS podrán realizar

devoluciones a través del módulo de administración del SIS tal y como se detalla en el
apartado “Consulta y administración de operaciones”, dentro del capítulo “Módulo de
administración del TPV Virtual SIS” de la presente guía. Otra alternativa consiste en enviar
el formulario de pago con el tipo de operación Ds_Merchant_TransactionType=3. En
ambos casos recibirá una confirmación de la devolución efectuada.

3. Comprobación de las operaciones en el módulo de administración del SIS:

accediendo al módulo de administración del SIS en entorno de pruebas, podrá comprobar
el detalle de las operaciones efectuadas a través del TPV Virtual, tal y como se indica en los
apartados “Consulta y administración de operaciones” y “Consulta de totales” dentro del
capítulo “Módulo de administración del TPV Virtual SIS” de la presente guía. Accediendo al
apartado de “Consultas” podrá visualizar el detalle de las operaciones y accediendo al
apartado de “Totales” podrá consultar el acumulado de las operaciones.
La descripción de los códigos de respuesta al efectuar una consulta de detalle de las
operaciones, figura en la tabla descrita en el apartado “Consulta y administración de
operaciones”, dentro del capítulo “Módulo de administración del TPV Virtual SIS” de la
presente guía.

21
 TPV VIRTUAL
MANUAL COMERCIO

9.
IDENTIFICACIÓN DE ANOMALÍAS
DURANTE EL PROCESO DE COMPRA

El SIS incluye fuertes validaciones y controles para detectar posibles errores en la entrada
de datos o situaciones anómalas del sistema.

Ante cualquier entrada al TPV Virtual SIS, se realizan las validaciones pertinentes de los
datos de entrada. Si los datos de entrada no son correctos, se genera un código de error y
no se permite continuar con la operación. Normalmente estas situaciones se producen
durante el tiempo que duran las pruebas de integración de un nuevo comercio.

Aunque la integración del comercio sea correcta, siempre se pueden producir situaciones
inesperadas como por ejemplo la detección de pedidos repetidos o incluso alguna posible
anomalía en el sistema.

Dependiendo del error producido, el mensaje mostrado al titular será diferente. En los
manuales de integración (Manual de integración para conexión por redirección / Manual de
integración para conexión Webservice) tiene disponible una tabla con los errores más
habituales.

La inclusión del código de error en la página mostrada al titular está oculto a la vista del
titular. La situación puede ser diferente dependiendo de la personalización utilizada. Lo
normal es que se encuentre en forma de comentario junto al mensaje mostrado al titular.
Para localizar el valor se deben seguir los siguientes pasos:

1. Abrir con el bloc de notas (por ejemplo) el código fuente de la página donde se ha
producido el error. En la barra de tareas de la página del navegador: Ver --> Código fuente.

2. Una vez que tenemos el código fuente abierto buscar el error que se ha producido.
En la barra de tareas del bloc de notas: Edición > Buscar.

3. Introducir en la caja de texto ‘buscar’ el siguiente literal: SIS0.

4. Aparecerá un literal del tipo: <!--SIS0051:-->.

5. De este modo tendremos identificado el error que se ha producido.

22
 VIRTUAL
MANUAL COMERCIO

tpv
Estamos para atenderle
902 20 60 20

GRUPO
COOPERATIVO
CAJAMAR