Professional Documents
Culture Documents
Virtual
ndice
1. INTRODUCCIN
2. QU NECESITO?
9
9
10
3. MEDIDAS DE SEGURIDAD
12
13
13
13
14
4. ASPECTOS OPERATIVOS
16
17
20
4.3 IUPAY
21
23
5.1 Acceso
24
5.2 Usuarios
24
25
25
26
6. INSTALACIN
27
28
32
35
37
46
46
50
51
54
ANEXOS 56
Anexo I Cdigos ISO pases
57
59
1.
Introduccin
Elementos de seguridad
Ofrecer los mximos elementos de seguridad
es una de las prioridades de Banco Sabadell.
Entre ellos, nuestra plataforma integra CES
5
digital (wallet) que permite a sus clientes almacenar de manera muy sencilla todas sus
tarjetas de diferentes entidades bancarias. As,
pueden realizar sus compras por Internet de
un modo mucho ms cmodo y rpido, pero
manteniendo todas las garantas de seguridad.
En el apartado 4.3 del presente manual se
describen los aspectos operativos de IUPAY.
Soluciones para la
internacionalizacin
En e-commerce el lmite es el mundo. Banco
Sabadell ha cuidado especialmente este
aspecto, integrando soluciones que facilitan
la venta fuera de nuestras fronteras:
2.
Qu necesito?
su catlogo de productos...
su tienda virtual
En
la solicitud de datos
10
11
3.
Medidas de seguridad
12
4.
Aspectos operativos
16
Confirmacin de Preautorizacin
(Ds_Merchant_TransactionType = 2)
Complementa de forma inseparable la operacin anterior.
En esta transaccin el titular no est conectado a la web del comercio, y por tanto siempre
es iniciada por el comercio.
Debe realizarse en los siete das siguientes a
la preautorizacin original y su importe debe
ser menor o igual que el importe de la original.
Esta transaccin se trata contablemente,
regularizando automticamente el apunte en
la cuenta del titular y envindose al proceso
de liquidacin de Banco Sabadell para su
abono al comercio.
La confirmacin de preautorizacin tiene
garanta de pago y conserva las condiciones
respecto a transaccin segura de su Preautorizacin original.
El TPV Virtual validar la existencia de la
operacin original y el importe que se desea
confirmar, y rechazar la operacin en caso
de existir algn error.
Anulacin de Preautorizacin
(Ds_Merchant_TransactionType = 9)
El titular no est conectado a la web del
comercio, y por tanto esta transaccin la
inicia siempre el comercio. Debe realizarse
en los siete das siguientes a la preautorizacin original.
El TPV Virtual validar la existencia de la
operacin original, y rechazar la operacin
en caso de existir algn error.
Preautorizacin Diferida
(Ds_Merchant_TransactionType = O)
Son operaciones similares a las preautorizaciones, pero estn disponibles para todos
18
Confirmacin de autenticacin
(Ds_Merchant_TransactionType = 8)
Su importe puede ser diferente al de la operacin original (incluso mayor), y debe realizarse
en los 45 das siguientes a la autenticacin
original.
_4 Fecha de la operacin
Persona autorizada, identificada con nombre y documento de identidad (DNI, Pasaporte, etc.). El pedido se ha de entregar
nicamente a esa persona y el albarn
de entrega debera de incluir la firma del
receptor as como la anotacin conforme
se ha comprobado el documento de identidad proporcionado.
_4 Nmero de tarjeta
_4 Direccin de la pgina web (URL)
_4 Importe de la transaccin
_4 Moneda
_4 Descripcin del producto comprado
_ Definicin de la poltica sobre devoluciones
que sigue el comercio, o bien indicacin
de la URL donde los usuarios pueden
informarse de ella.
22
5.
Mdulo de administracin
del TPV virtual
23
5.1 Acceso
5.2 Usuarios
24
25
26
6.
Instalacin
27
28
DATO
LONG.
COMENTARIOS
Importe
Ds_Merchant_Amount
12 N
Obligatorio.
Las dos ltimas posiciones se
consideran decimales, excepto en
Yenes.
Obligatorio.
978 EURO
840 USD
826 GBP
392 JPY
756 CHF
124 CAD
Moneda
Ds_Merchant_Currency
4N
Nmero
de pedido
Ds_Merchant_Order
Mn. 4N
Mx. 12 AN
Obligatorio.
Los 4 primeros dgitos deben ser
numricos, para los dgitos
restantes
Para Tarjeta en
Archivo el campo
debe ser mx. 10
posiciones.
El TPV Virtual aadir
2 posiciones ms
para indicar el nmero
de orden del pago.
Descripcin
del
Producto
Ds_Merchant_
ProductDescription
Mx. 125 AN
Nombre y
apellidos
del titular
Ds_Merchant_Titular
Mx. 60 AN
Nmero de
comercio.
Cdigo FUC
Ds_Merchant_
MerchantCode
9N
Obligatorio.
Cdigo fijo asignado por Banco
Sabadell.
URL
Ds_Merchant_
MerchantURL
250 AN
250 AN
Opcional.
Si se enva ser utilizado como
URLOK, ignorando el configurado
en el mdulo de administracin en
caso de tenerlo.
URLOK
Ds_Merchant_UrlOK
29
30
DATO
NOMBRE DEL
CAMPO
LONG.
COMENTARIOS
URLKO
Ds_Merchant_UrlKO
250 AN
Opcional.
Si se enva ser utilizado como URLKO, ignorando el
configurado en el mdulo de administracin en caso
de tenerlo.
Nombre del
comercio
Ds_Merchant_
MerchantName
25 AN
Opcional.
Ser el nombre del comercio que aparecer en la
pgina de pago del cliente, si lo hubiera.
0 Cliente
1 Castellano
2 Ingls
3 Cataln
4 Francs
5 Alemn
Opcional.
6 Holands
7 Italiano
8 Sueco
9 Portugus
10 Valenciano
11 Polaco
12 Gallego
13 Euskera
Idioma del
titular
Ds_Merchant_
ConsumerLanguage
3N
Firma del
comercio
Ds_Merchant_
MerchantSignature
40 AN
Obligatorio.
Ver apartado 6.3
Diseo del algoritmo Hash en el servidor de internet.
Nmero de
terminal
Ds_Merchant_
Terminal
3N
Obligatorio.
De forma estndar:
1 Operaciones en euros
(Ds_Merchant_Currency = 978)
En caso de querer ms terminales se pueden
solicitar al servicio tcnico de Banco Sabadell.
Datos del
comercio
Ds_Merchant_
MerchantData
1024 AN
Opcional.
Informacin libre del comercio para ser recibida en la
respuesta online (va URL o e-mail).
Tipo de
transaccin
Ds_Merchant_
TransactionType
1N
Cdigo de
autorizacin
Ds_Merchant_
AuthorisationCode
6N
DATO
LONG.
Identificador
Ds_Merchant_Identifier
Max. 40 AN
Grupo de
comercios
Ds_Merchant_Group
Max. 9 N
Pantallas
adicionales
Mtodo
de Pago
Ds_Merchant_
DirectPayment
Ds_Merchant_
PayMethod
True or false
1 AN
COMENTARIOS
El valor del campo es obligatorio
para el primer pago.
Para segundo pago y sucesivos,
el valor ser el identificador que el
Banco ha facilitado en el mensaje
de respuesta del primer pago.
Opcional. Permite asociar una
referencia a un conjunto de
comercios.
Opcional.
Este parmetro funciona
como un flag
que indica si hay que mostrar
pantallas adicionales (DCC,
Fraccionamiento,
Autenticacin, etc.)
Solo para comercios que permiten
el pago con IUPAY y que hayan
insertado el botn IUPAY en su
pgina web.
C - Pago con Tarjeta
O - Pago mediante IUPAY
31
32
SISxxxx
CAMPO AFECTADO
SIS0007
MOTIVO
MENSAJE
MSG0008
SIS0008
Ds_Merchant_MerchantCode
Falta el campo
MSG0008
SIS0009
Ds_Merchant_MerchantCode
Error de formato
MSG0008
SIS0010
Ds_Merchant_Terminal
Falta el campo
MSG0008
SIS0011
Ds_Merchant_Terminal
Error de formato
MSG0008
SIS0014
Ds_Merchant_Order
Error de formato
MSG0008
SIS0015
Ds_Merchant_Currency
Falta el campo
MSG0008
SIS0016
Ds_Merchant_Currency
Error de formato
MSG0008
SIS0018
Ds_Merchant_Amount
Falta el campo
MSG0008
SIS0019
Ds_Merchant_Amount
Error de formato
MSG0008
SIS0020
Ds_Merchant_Signature
Falta el campo
MSG0008
SIS0021
Ds_Merchant_Signature
MSG0008
SIS0022
Ds_TransactionType
Error de formato
MSG0008
SIS0023
Ds_TransactionType
Valor desconocido
MSG0008
SIS0024
Ds_ConsumerLanguage
MSG0008
SIS0025
Ds_ConsumerLanguage
Error de formato
MSG0008
SIS0026
Ds_Merchant_MerchantCode
MSG0008
MSG0008
MSG0008
MSG0000
SIS0027
Ds_Merchant_Currency
SIS0028
Ds_Merchant_MerchantCode
SIS0030
Ds_TransactionType
SIS0031
Ds_Merchant_TransactionType
MSG0000
SIS0034
MSG0000
SIS0038
Error en JAVA
MSG0000
SIS0040
MSG0008
MSG0008
SIS0043
MSG0008
SIS0046
MSG0002
SIS0041
SIS0042
Ds_Merchant_Signature
SIS0051
Ds_Merchant_Order
MSG0001
SIS0054
Ds_Merchant_Order
MSG0008
SIS0055
Ds_Merchant_Order
MSG0008
SIS0056
Ds_Merchant_Order
MSG0008
SIS0057
Ds_Merchant_Amount
MSG0008
MSG0008
SIS0058
33
SIS0059
Ds_Merchant_Order
MSG0008
SIS0060
Ds_Merchant_Order
MSG0008
SIS0061
Ds_Merchant_Order
MSG0008
SIS0062
Ds_Merchant_Amount
MSG0008
SIS0063
SIS0064
SIS0065
MSG0008
SIS0066
SIS0067
SIS0068
SIS0069
SIS0070
MSG0008
SIS0071
Tarjeta caducada
MSG0000
SIS0072
Ds_Merchant_Order
Operacin no anulable
MSG0000
SIS0074
Ds_Merchant_Order
Falta el campo
MSG0008
SIS0075
Ds_Merchant_Order
MSG0008
SIS0076
Ds_Merchant_Order
El valor no es numrico
MSG0008
SIS0078
Ds_TransactionType
Valor desconocido
MSG0005
SIS0079
MSG0008
SIS0081
MSG0008
SIS0089
MSG0008
SIS0092
MSG0008
SIS0093
MSG0006
MSG0004
Valor no permitido
MSG0008
SIS0114
MSG0000
SIS0115
Ds_Merchant_Order
MSG0008
SIS0116
Ds_Merchant_Order
MSG0008
SIS0117
Ds_Merchant_Order
MSG0008
SIS0132
MSG0008
SIS0133
MSG0008
SIS0139
MSG0008
SIS0142
MSG0000
SIS0198
MSG0008
SIS0199
MSG0008
SIS0200
MSG0008
SIS0094
SIS0112
34
Ds_TransactionType
SIS0214
MSG0008
SIS0216
MSG0008
SIS0217
MSG0008
SIS0218
MSG0008
SIS0219
MSG0008
SIS0220
MSG0008
SIS0221
MSG0008
SIS0222
MSG0008
SIS0223
MSG0008
SIS0224
MSG0008
SIS0225
MSG0008
SIS0226
MSG0008
Valor no vlido
MSG0008
SIS0229
MSG0008
SIS0252
MSG0008
SIS0253
MSG0008
SIS0254
MSG0008
SIS0255
MSG0008
SIS0256
MSG0008
SIS0257
MSG0008
SIS0258
MSG0008
SIS0261
MSG0008
Ds_Merchant_TransactionType
MSG0008
Ds_Merchant_TransactionType
MSG0008
SIS0281
MSG0008
SIS0296
MSG0008
SIS0297
MSG0008
SIS0298
MSG0008
SIS0227
SIS0270
SIS0274
Ds_Merchant_TransactionDate
35
En la siguiente tabla se relacionan los mensajes que la pgina de pago muestra al titular de
la tarjeta compradora ante los diferentes errores que se puedan producir.
CDIGO
MENSAJE
MSG0000
MSG0001
MSG0002
MSG0003
MSG0004
Error de Autenticacin
MSG0005
MSG0006
MSG0007
MSG0008
NOTA IMPORTANTE:
La clave secreta nunca debe ser revelada
a terceros, ni debe aparecer en el cdigo
fuente de la web del comercio, ni debe
ser accesible dentro de la estructura de
ficheros de la web.
El clculo del algoritmo hash SHA-1 debe
implementarse en la parte privada del
servidor de Internet del comercio.
Si el comercio reside en un servidor ajeno
bajo una frmula de hosting o similar, deber ponerse en contacto con la empresa
proveedora para que le informe del modo
de implementar el algoritmo criptogrfico.
Si lo desea, Banco Sabadell le puede facilitar
ejemplos de conexin con el TPV Virtual de su
comercio en distintos lenguajes de programacin.
Referencias SHA-1
Estndar de hash seguro, FIPS PUB
180-1:
http://www.itl.nist.gov/fipspubs/fip1801.htm
http://csrc.nist.gov/publications/fips/
fips180-1/fips180-1.pdf
Lista de implementaciones validadas
del SHA-1:
http://csrc.nist.gov/cryptval/dss/dsaval.htm
38
DATO
LONG.
COMENTARIOS
Fecha
Ds_Date
10 A
Fecha de la transaccin
(DD-MM-AAAA).
Hora
Ds_Hour
5A
Hora de la transaccin
(HH:MM).
Importe
Ds_Amount
12 N
Moneda
Ds_Currency
4N
Nmero
de pedido
Ds_Order
12 N
Cdigo de
comercio
Cdigo FUC
Ds_MerchantCode
9N
Nmero de
terminal
Ds_Terminal
3N
Firma para el
comercio
Ds_Signature
40 AN
Cdigo de
respuesta
Ds_Response
4N
Tipo de
transaccin
Ds_TransactionType
1 AN
Pago seguro
Ds_SecurePayment
1N
0 - Pago NO seguro.
1 - Pago seguro.
Datos del
comercio
Ds_MerchantData
1024
AN
39
DATO
LONG.
COMENTARIOS
Ds_Card_Country
3N
Cdigo de
autorizacin
Ds_
AuthorisationCode
6 AN
Cdigo alfanumrico de
autorizacin asignado a la
aprobacin por la institucin
autorizadora.
Ds_
ConsumerLanguage
3N
0 - Cliente
1 - Castellano
2 - Ingls
3 - Cataln
4 - Francs
5 - Alemn
6 - Neerlands
7 - Italiano
8 - Sueco
9 - Portugus
10 - Valenciano
11 - Polaco
12 - Gallego
13 - Euskera
Tipo de tarjeta
Ds_Card_Type
1 AN
C - Tarjeta de crdito
D - Tarjeta de dbito
TTULO
DESCRIPCIN
000
TRANSACCION APROBADA
001
TRANSACCION APROBADA
002 - 099
TTULO
DESCRIPCIN
101
TARJETA CADUCADA
102
104
OPERACIN NO PERMITIDA
106
107
El banco emisor no permite una autorizacin automtica. Es necesario contactar telefnicamente con
su centro autorizador para obtener una aprobacin
manual.
109
41
110
IMPORTE INVALIDO
114
116
DISPONIBLE INSUFICIENTE
118
TARJETA NO REGISTRADA
119
TRANSACCIN DENEGADA
125
TARJETA NO EFECTIVA
129
ERROR CVV2/CVC2
167
Debido a una sospecha de que la transaccin es fraudulenta el banco emisor no permite una autorizacin
automtica. Es necesario contactar telefnicamente
con su centro autorizador para obtener una aprobacin manual.
180
184
ERROR EN AUTENTICACION
190
191
181-182
42
TTULO
DESCRIPCIN
201
TARJETA CADUCADA
202
204
OPERACION NO PERMITIDA
280
ERROR CVV2/CVC2
290
207
208 - 209
TTULO
DESCRIPCIN
400
ANULACION ACEPTADA
480
NO SE ENCUENTRA LA OPERACIN
ORIGINAL O TIME-OUT EXCEDIDO
481
ANULACION ACEPTADA
Transaccin de anulacin o retrocesin parcial aceptada por el banco emisor. No obstante, la respuesta del
banco emisor se ha recibido con mucha demora, fuera
del time-out predefinido.
D) C
ODIGOS REFERIDOS A CONCILIACIONES DE PRE-AUTORIZACIONES O
PRE-AUTENTICACIONES (Ds_Merchant_TransactionType = 2, 8, O o R)
CDIGO
500
TTULO
CONCILIACION ACEPTADA
DESCRIPCIN
La transaccin de conciliacin ha sido aceptada por el
banco emisor.
43
NO ENCONTRADA LA OPERACION
ORIGINAL O TIME-OUT EXCEDIDO
9928
ANULACIN DE PREAUTORITZACIN
REALIZADA POR EL SISTEMA
9929
ANULACIN DE PREAUTORITZACIN
REALIZADA POR EL COMERCIO
501 - 503
E) C
ODIGOS DE ERROR ENVIADOS POR LA PROPIA PLATAFORMA
DE PAGOS DE BANCO SABADELL
CDIGO
44
TTULO
DESCRIPCIN
904
COMERCIO NO REGISTRADO EN
EL FUC
909
ERROR DE SISTEMA
912
EMISOR NO DISPONIBLE
913
TRANSMISION DUPLICADA
916
928
TIME-OUT EXCEDIDO
940
TRANSACCION ANULADA
ANTERIORMENTE
941
TRANSACCION DE AUTORIZACION
YA ANULADA POR UNA ANULACION
ANTERIOR
942
TRANSACCION DE AUTORIZACION
ORIGINAL DENEGADA
943
DATOS DE LA TRANSACCION
ORIGINAL DISTINTOS
944
SESION ERRONEA
945
TRANSMISION DUPLICADA
946
OPERACION A ANULAR EN
PROCESO
947
TRANSMISION DUPLICADA EN
PROCESO
949
TERMINAL INOPERATIVO
950
DEVOLUCION NO PERMITIDA
965
VIOLACIN NORMATIVA
9064
9078
9093
TARJETA NO EXISTE
Tarjeta inexistente.
9094
9104
9142
9218
NO SE PUEDEN HACER
OPERACIONES SEGURAS
9253
CHECK-DIGIT ERRONEO
9256
PREAUTORITZACIONES NO
HABILITADAS
9261
9283
9281
9912
EMISOR NO DISPONIBLE
9913
ERROR EN CONFIRMACION
9914
CONFIRMACION KO
9915
PAGO CANCELADO
45
9928
9929
AUTORIZACIN EN DIFERIDO
ANULADA
AUTORIZACIN EN DIFERIDO
ANULADA
9997
TRANSACCIN SIMULTNEA
9998
9999
ESTADO OPERACIN:
AUTENTICANDO
Hay que tener en cuenta que si el comprador cierra la ventana del navegador, las
URL_OK/URL_KO no estarn operativas y la
sesin continuar en la pgina del comercio
que permaneca en segundo plano.
Opcin para comercios con RESPUESTA
ONLINE VA URL: adems de las dos instrucciones anteriores, para los comercios
que disponen del servicio de RESPUESTA
ONLINE VA URL la continuidad de la sesin
la puede realizar la propia web del comercio,
cerrando la ventana de pago en el momento
en que se reciba la respuesta online.
8 - Confirmacin de autenticacin
9 - Anulacin de preautorizaciones
A - Pago no seguro sin autenticacin
O - Preautorizacin Diferida
P - Confirmacin de Preautorizacin Diferida
Q - Anulacin de Preautorizacin Diferida
L - Transaccin Tarjeta Archivo Inicial (suscripciones y Pago Exprs)
M - Transacciones Tarjetas Archivo Sucesivas (suscripciones y Pago Exprs)
Los tipos 1, A, O y L que se procesen mediante este protocolo, requerirn que el comercio
solicite directamente al comprador su nmero
de tarjeta y caducidad. Los comercios que
los consideren necesarios, debern solicitar
su activacin a su oficina o gestor de Banco
Sabadell. Adems esta opcin requiere que
previamente el comercio haya cumplimentado
los cuestionarios del programa PCI-DSS de
seguridad en los datos de tarjetas.
La comunicacin se realizar mediante un
envo del documento XML a la direccin indicada del TPV Virtual. El sistema interpretar
el documento XML y realizar las validaciones
pertinentes para, a continuacin, procesar la
operacin. Dependiendo del resultado de la
operacin, se montar un documento XML
de respuesta con el resultado de la misma.
El documento XML se transmitir mediante
un envo con POST a la direccin:
Entorno de Pruebas: https://sis-t.REDSYS.es:25443/sis/operaciones
Entorno de Real: https://sis.REDSYS.
es/sis/operaciones
Donde:
- DS_Version: Versin de la DTD
utilizada para validar el mensaje XML
- DS_MERCHANT_AMOUNT: ver APARTADO 6.1.
- DS_MERCHANT_CURRENCY: ver APARTADO 6.1.
- DS_MERCHANT_ORDER: ver APARTADO 6.1.
- DS_MERCHANT_MERCHANTCODE: ver APARTADO 6.1.
- DS_MERCHANT_MERCHANTURL: ver APARTADO 6.1.
- DS_MERCHANT_MERCHANTNAME: ver APARTADO 6.1.
- DS_MERCHANT_CONSUMERLANGUAGE : ver APARTADO 6.1.
47
- DS_MERCHANT_MERCHANTSIGNATURE:
SHA1 de los campos Ds_Merchant_Amount +
Ds_Merchant_Order +Ds_Merchant_MerchantCode +
DS_Merchant_Currency + DS_MERCHANT_PAN + DS_
MERCHANT_CVV2 + DS_MERCHANT_TRANSACTIONTYPE +
CLAVE SECRETA.
DS_MERCHANT_PAN solo se incluir si se enva en el mensaje.
DS_MERCHANT_CVV2 solo se incluir si se enva en el mensaje.
- DS_MERCHANT_TERMINAL: ver APARTADO 6.1.
-D
S_MERCHANT_TRANSACTIONTYPE: solo se permiten
los tipos:
1-Preautorizacin (vlido solo si el comercio est autorizado
y trabaja en modo no seguro).
2- Confirmacin de preautorizacin.
3- Devolucin Automtica.
8- Confirmacin de Autenticacin.
9- Anulaciones de preautorizaciones.
A- Pago no seguro sin autenticacin
O- Preautorizacin Diferida.
P- Confirmacin de Preautorizacin Diferida.
Q- Anulacin de Preautorizacin Diferida.
L - Transaccin Tarjeta Archivo Inicial (suscripciones y
Pago Exprs)
M - Transacciones Tarjetas Archivo Sucesivas
(suscripciones y Pago Exprs)
- DS_MERCHANT_MERCHANTDATA: ver APARTADO 6.1.
- DS_MERCHANT_PAN : nmero de tarjeta.
- DS_MERCHANT_EXPIRYDATE : fecha caducidad (AAMM).
- DS_MERCHANT_AUTHORISATIONCODE : solo vlido para
devoluciones de transacciones recurrentes sucesivas. Ver
APARTADO 5.1.
- DS_MERCHANT_TRANSACTIONDATE : solo vlido para
devoluciones de transacciones recurrentes sucesivas. Ver
APARTADO 5.1.
- DS_MERCHANT_CVV2: Cdigo CVV2/CVC2 de la tarjeta (Dato
opcional). En caso de que se incluya, se debe aadir a la firma,
de la siguiente manera:
firma = SHA1(datos + clave_entidad)
Donde datos es una cadena formada por:
datos=importe + pedido + comercio + moneda
- Si es una autorizacin o preautorizacin: datos = datos +
tarjeta
- Si adems de ser pago tradicional, se enva CVV2:
datos = datos + CVV2
Por ltimo, siempre se le aade el tipo de operacin:
datos = datos + tipo_operacin
</DS_MERCHANT_MERCHANTURL>
<DS_MERCHANT_TRANSACTIONTYPE>
2
</DS_MERCHANT_TRANSACTIONTYPE>
<DS_MERCHANT_MERCHANTDATA>
Alfombrilla+para+raton
</DS_MERCHANT_MERCHANTDATA>
<DS_MERCHANT_AMOUNT>
45
</DS_MERCHANT_AMOUNT>
<DS_MERCHANT_MERCHANTNAME>
Comercio de Pruebas
</DS_MERCHANT_MERCHANTNAME>
<DS_MERCHANT_MERCHANTSIGNATURE>
a63dfa507e549936f41f4961ccdace126b8ecdea
</DS_MERCHANT_MERCHANTSIGNATURE>
<DS_MERCHANT_TERMINAL>
1
</DS_MERCHANT_TERMINAL>
<DS_MERCHANT_MERCHANTCODE>
999008881
</DS_MERCHANT_MERCHANTCODE>
<DS_MERCHANT_ORDER>
114532
</DS_MERCHANT_ORDER>
</DATOSENTRADA>
Donde:
- DS_Version: versin de la DTD utilizada para validar
el XML.
- CDIGO: indica si la operacin ha sido correcta
o no (no indica si ha sido autorizada, solo si se ha
<CODIGO>0</CODIGO>
<OPERACION>
<Ds_Amount>100</DS_Amount>
<Ds_Currency>978</DS_Currency>
<Ds_Order>0001</DS_Order>
<Ds_Signature>EEFF45687hgth</DS_Signature>
<Ds_MerchantCode>999008881</DS_
MerchantCode>
<Ds_Terminal>1</DS_Terminal>
<Ds_Response>0</DS_Response>
<Ds_AuthorisationCode>222FFF</ Ds_
AuthorisationCode>
<Ds_TransactionType>2</ Ds_TransactionType >
<Ds_SecurePayment>1</Ds_SecurePayment>
<Ds_MerchantData>Mis Datos</ Ds_MerchantData>
</OPERACION>
</RETORNOXML>
49
</DS_MERCHANT_MERCHANTSIGNATURE>
<DS_MERCHANT_TERMINAL>
1
</DS_MERCHANT_TERMINAL>
<DS_MERCHANT_MERCHANTCODE>
999008881
</DS_MERCHANT_MERCHANTCODE>
<DS_MERCHANT_ORDER>
114532
</DS_MERCHANT_ORDER>
<DS_Version>
1.0
</ DS_Version >
</DATOSENTRADA>
</RECIBIDO>
</RETORNOXML>
3. Clave secreta
(Ds_Merchant_MerchantSignature):
qwertyasdf0123456789
4. Terminales (Ds_Merchant_Terminal):
001 - Para pagos en EUROS (Ds_MerchantCurrency = 978) de comercios bajo
protocolo CES (Comercio Electrnico
Seguro VERIFIED BY Visa y MasterCard
SecureCode)
002 - Para pagos en EUROS (Ds_MerchantCurrency = 978) de comercios bajo
protocolo No-CES (pagos considerados
NO seguros)
5. Tarjeta aceptada:
4548 8120 4940 0004, caducidad
12/17, cdigo CVV2: 123.
En modo de compra segura (CES), en
la que se requiera autenticacin del
comprador, el cdigo de identificacin
personal (CIP) es: 123456
6. URL mdulo de administracin:
https://sis-t.redsys.es:25443/
canales/
7. Acceso al mdulo de administracin:
Para terminal 001 (CES):
Usuario: 327234688-001
password: 123456a
Para terminal 002 (NO CES):
Usuario: 327234688-002
password: 123456a
E
l comercio puede utilizar cualquier entrada
de las actuales al TPV Virtual (realizarPago, entradaXMLEntidad, operaciones o
WebService).
E
l TPV Virtual valida el identificador asociado al comercio y recupera los datos
de la tarjeta.
U
na vez que ha localizado los datos de la
tarjeta, el TPV Virtual procede a realizar el
pago. En caso de que se haya indicado
que no se muestren pantallas, el pago
se realizar sin mostrar las pantallas de
DCC ni de fraccionamiento y sin usar ningn mtodo de pago seguro. La fecha de
caducidad slo se incluye en la respuesta
si el comercio est configurado para ello.
Para aquellos casos en los que el comercio,
al solicitar un pago al TPV Virtual, no haya
solicitado la creacin de un identificador, o
estuviera utilizando la anterior modalidad
de Banco Sabadell, denominada Tarjeta en
Archivo, ser posible la opcin de crear un
identificador a posteriori. Para ello Banco Sabadell dispone de un proceso batch llamado
GenerarReferencias, a travs del cual podr
filtrar las operaciones para las cuales quiere
crear los identificadores.
Restricciones
Para que un comercio utilice esta operativa
debe tener en cuenta las siguientes restricciones:
i. El nmero de identificador se asociar tambin al nmero de comercio que ha realizado
la solicitud. Si el comercio desea que este
identificador pueda ser usada por otros comercios, estos debern estar configurados
previamente formando un grupo. Para la
creacin de grupos, es necesario solicitarlo
a su gestor habitual en Banco Sabadell.
ii. Los datos de la tarjeta se mantendrn
hasta la fecha de validez de su caducidad.
52
Ds_Merchant_DirectPayment
Este parmetro funciona como un flag
que indica si hay que mostrar pantallas
adicionales (DCC, Fraccionamiento y Autenticacin). Es un parmetro opcional que
tan slo puede tomar los valores true o
false. Si se utiliza con el valor true, no
se mostrarn pantallas adicionales (DCC,
Fraccionamiento y Autenticacin) durante
el pago y se debe utilizar conjuntamente
con el parmetro Ds_Merchant_Identifier
conteniendo una referencia vlida. Si no se
utiliza o se utiliza con el valor de false,
el pago se har de manera normal y se
mostrarn todas las pantallas adicionales
(DCC, Fraccionamiento y Autenticacin) que
se requieran dependiendo de la configuracin del comercio.
Este parmetro se debe incluir en la cadena de clculo de la firma Hash (ver
apartado 7.6.4 del presente manual). Se
debe concatenar justo detrs del parmetro
Ds_Merchant_Group (si este existe) y antes
del valor de la clave.
Migracin de identificadores
(Exclusivo para comercios que anteriormente utilizaban la modalidad de pago Tarjeta en Archivo)
55
Anexos.
56
152 Chile
276 Alemania
008 Albania
156 China
288 Ghana
012 Argelia
158 Taiwn
292 Gibraltar
296 Kiribati
020 Andorra
300 Grecia
024 Angola
170 Colombia
304 Groenlandia
174 Comoras
308 Granada
031 Azerbaiyn
175 Mayotte
312 Guadalupe
032 Argentina
316 Guam
036 Australia
320 Guatemala
040 Austria
324 Guinea
044 Bahamas
328 Guyana
048 Barin
191 Croacia
332 Hait
050 Banglads
192 Cuba
051 Armenia
196 Chipre
052 Barbados
340 Honduras
056 Blgica
204 Benn
060 Bermudas
208 Dinamarca
348 Hungra
064 Butn
212 Dominica
352 Islandia
068 Bolivia
356 India
218 Ecuador
360 Indonesia
072 Botsuana
222 El Salvador
364 Irn
368 Irak
076 Brasil
231 Etiopa
372 Irlanda
084 Belice
232 Eritrea
376 Israel
233 Estonia
380 Italia
388 Jamaica
096 Bruni
392 Japn
100 Bulgaria
242 Fiyi
398 Kazajistn
104 Birmania
246 Finlandia
400 Jordania
108 Burundi
248 Aland
404 Kenia
112 Bielorrusia
250 Francia
116 Camboya
120 Camern
414 Kuwait
124 Canad
417 Kirguistn
262 Yibuti
418 Laos
266 Gabn
422 Lbano
268 Georgia
426 Lesoto
270 Gambia
428 Letonia
148 Chad
430 Liberia
57
58
434 Libia
585 Palaos
438 Liechtenstein
586 Pakistn
729 Sudn
440 Lituania
591 Panam
442 Luxemburgo
740 Surinam
446 Macao
600 Paraguay
450 Madagascar
604 Per
748 Suazilandia
454 Malaui
608 Filipinas
752 Suecia
458 Malasia
756 Suiza
462 Maldivas
616 Polonia
760 Siria
466 Mal
620 Portugal
762 Tayikistn
470 Malta
624 Guinea-Bisu
764 Tailandia
474 Martinica
768 Togo
478 Mauritania
772 Tokelau
480 Mauricio
634 Catar
776 Tonga
484 Mxico
638 Reunin
492 Mnaco
642 Rumania
496 Mongolia
643 Rusia
788 Tnez
498 Moldavia
646 Ruanda
792 Turqua
499 Montenegro
795 Turkmenistn
500 Montserrat
504 Marruecos
798 Tuvalu
508 Mozambique
660 Anguila
800 Uganda
512 Omn
804 Ucrania
516 Namibia
520 Nauru
818 Egipto
524 Nepal
831 Guernsey
531 Curazao
832 Jersey
533 Aruba
686 Senegal
834 Tanzania
548 Vanuatu
688 Serbia
690 Seychelles
558 Nicaragua
562 Nger
702 Singapur
858 Uruguay
566 Nigeria
703 Eslovaquia
860 Uzbekistn
570 Niue
704 Vietnam
862 Venezuela
574 Norfolk
705 Eslovenia
578 Noruega
706 Somalia
882 Samoa
710 Sudfrica
887 Yemen
583 Micronesia
716 Zimbabue
894 Zambia
724 Espaa
ALL 8
DZD
12
AON
24
ARS
32
AUD
36
BSD
44
BHD
48
BDT 50
AMD
51
BBD
52
BMD
60
BTN 64
BOB 68
BAM
70
BWP 72
BRC 76
BZD
84
SBD
90
BND
96
MMK 104
BIF
108
BYB
112
KHR 116
CAD
124
CVE
132
KYD
136
LKR
144
CLP
152
CNY
156
CNH
157
CNX
158
COP
170
KMF
174
CRC
188
HRK
191
CUP
192
CYP
196
CSK 200
CZK
203
DKK
208
DOP
214
SVC
222
ETB
230
ERN 232
EEK 233
FKP
238
Fiji Dollar
Djibouti Franc
Dalasi
Ghana Cedi
Gibraltar Pound
Quetzal
Guinea Franc
Guyana Dollar
Gourde
Lempira
Hong Kong Dollar
Forint
Iceland Krona
Indian Rupee
Rupiah
Iraqi Dinar
New Israeli Sheqel
Jamaican Dollar
Yen
Tenge
Jordanian Dinar
Kenyan Shilling
Won
Kuwaiti Dinar
Som
Kip
Lebanese Pound
Loti
Latvian Lats
Liberian Dollar
Libyan Dinar
Lithuanian Litas
Pataca
Malagassy Franc
Kwacha
Malaysian Ringgit
Rufiyaa
Mali
Maltese Lira
Ouguiya
Mauritius Rupee
Mexican Peso
Tugrik
Moldovan Leu
Moroccan Dirham
Rial Omani
FJD
242
DJF
262
GMD 270
GHC
288
GIP
292
GTQ 320
GNF
324
GYD
328
HTG 332
HNL 340
HKD
344
HUF 348
ISK
352
INR
356
IDR 360
IQD
368
ILS
376
JMD
388
JPY 392
KZT 398
JOD
400
KES
404
KRW 410
KWD
414
KGS 417
LAK 418
LBP
422
LSL 426
LVL
428
LRD
430
LYD
434
LTL
440
MOP 446
MGF
450
MWK 454
MYR
458
MVR 462
MLF 466
MTL
470
MRO 478
MUR
480
MXN
484
MNT 496
MDL
498
MAD
504
OMR
512
59
60
NAD
516
NPR
524
ANG
532
AWG
533
NTZ
536
VUV 548
NZD
554
566 556
NIO
558
NGN 566
NOK
578
PCI
582
PKR
586
PAB 590
PGK 598
PYG 600
PEN
604
PHP
608
GWP
624
TPE
626
QAR
634
RUB
643
RWF
646
SHP
654
STD 678
SAR
682
SCR
690
SLL 694
SGD
702
VND 704
SIT
705
SOS
706
ZAR 710
ZWD
716
YDD
720
SDP
736
SDA
737
SZL 748
SEK
752
CHF
756
SYP
760
TJR
762
THB 764
TOP 776
TTD
780
AED
784
Tunisian Dinar
Turkish Lira
Manat
Uganda Shilling
Karbovanet
Denar
Egyptian Pound
Pound Sterling
Tanzanian Shilling
US Dollar
Peso Uruguayo
Uzbekistan Sum
Tala
Yemeni Rial
Serbian Dinar
Zambian Kwacha
New Taiwan Dollar
Manat
Cedi
Bolivar Fuerte
Serbian Dinar
Metical
Azerbaijanian Manat
New Leu
Turkish Lira
CFA Franc BEAC
East Caribbean Dollar
CFA Franc BCEAO
CFP Franc
European Currency UN
Kwacha
Surinam Dollar
Malagasy Ariary
Afghani
Somoni
Kwanza
Belarussian Ruble
Bulgarian Lev
Congolese Franc
Convertible Marks
Euro
Hryvnia
Lari
Zloty
Brazilian Real
Peseta Convertible
TND
788
PTL
793
TMM 795
UGX
800
UAK
804
MKD 807
EGP
818
GBP
826
TZS
834
USD
840
UYU
858
UZS
860
WST 882
YER
886
CSD
891
ZMK
894
TWD
901
TMT 934
GHS 936
VEF
937
RSD
941
MZN 943
AZN
944
RON
946
TRY
949
XAF
950
XCD
951
XOF
952
XPF
953
XEU
954
ZMW 967
SRD
968
MGA
969
AFN 971
TJS 972
AOA 973
BYR
974
BGN
975
CDF
976
BAM
977
EUR 978
UAH 980
GEL 981
PLN 985
BRL
986
ESB
995
IV-2015