TPV Virtual Webservice

SIS TPV VIRTUAL WEBSERVICE
Versin: 2.0 26/09/2013
Referencia RS.OP.PRO.MAN.0008
Redsys C/ Francisco Sancha, 12 28034
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 1
TPV VIRTUAL WEBSERVICE
Autorizacione ! contro" #e $er i%n
(a )ro)iedad in*e+ec*,a+ de es*e doc,-en*o )er*enece a Redsys. .,eda )rohi/ida s, re)rod,ccin, 0en*a, o cesin a *erceros
#12&R: Redsys
V#(34#4& "&R:
#"R&5#4& "&R:
! "R!S#: Redsys
! "R!S#: Redsys
! "R!S#: Redsys
Fir-a:
Fir-a:
Fir-a:
Fecha: 26/09/2013
Fecha: 26/09/2013
Fecha: 26/09/2013
Co-en*arios: (a 6es*in de +a doc,-en*acin i-)resa es res)onsa/i+idad de +a )ersona 7,e +a i-)ri-e. (as 0ersiones i-)resas de +as nor-as de se6,ridad no 6aran*i8an ser +a 9+*i-a 0ersin a)ro/ada. "ara cons,+*ar +a 9+*i-a 0ersin acceder a +a /ase de da*os de #+e:andr;a.
Ver i%n 1.0 2.0
&ec'a 09/02/2012 26/09/2013
Afecta 2&4&
Bre$e #e cri(ci%n #e" ca)*io "aso a )+an*i++a de Redsys Se inc+,ye e+ c<+c,+o de +a %ir-a de res),es*a
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 2
+N,ICE ,E CONTENI,O
-.
Intro#ucci%n ........................................................................................ . &/:e*i0o ............................................................................................ = >-/i*o .............................................................................................. = 4e%iniciones, si6+as y a/re0ia*,ras ........................................................ = Re%erencias ........................................................................................ = "anor<-ica de+ doc,-en*o .................................................................. =
1.1 1.2 1.3 1.4 1.= /.
In truccione #e cone0i%n ................................................................... 1 1R( de cone?in ................................................................................. @ A*odo de acceso ............................................................................... @
2.1 2.2 2.
,ato #e" for)u"ario #e (a3o ............................................................... 8 ensa:e de )e*icin de )a6o ................................................................ 9 !:e-)+o de -ensa:e de *ransaccin "e*icin de )a6o........................10 ensa:e de )e*icin de )a6os rec,rren*es ............................................11 !:e-)+o de -ensa:e de *ransaccin "e*icin de )a6o........................12 ensa:e de )e*icin de Con%ir-acin/4e0o+,cin ...................................13 !:e-)+o de -ensa:e de *ransaccin 4e0o+,cin ...............................14 ensa:e de res),es*a ........................................................................1= !:e-)+o de -ensa:e de res),es*a de +a o)eracin ...........................16 !:e-)+o de -ensa:e de res),es*a de +a o)eracin de de0o+,cin .......16
3.1 3.1.1 3.2 3.2.1 3.3 3.3.1 3.4 3.4.1 3.4.2 4.
&ir)a #e" co)ercio ............................................................................. -8 C<+c,+o de +a %ir-a en )e*iciones de )a6o .............................................18 C<+c,+o de +a %ir-a en )e*iciones de )a6o rec,rren*es ............................18 C<+c,+o de +a %ir-a en )e*iciones de Con%ir-acin / 4e0o+,cin ...............19 C<+c,+o de +a %ir-a de +a res),es*a ......................................................20 Reco-endaciones )ara e+ c<+c,+o de +a %ir-a. ........................................21
4.1 4.2 4.3 4.4 4.= ..
Va"i#acione #urante e" (roce o #e co)(ra ....................................... // Cdi6os de error ................................................................................22
=.1
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 3
5.
O(erati$a ,CC .................................................................................... /. A*odos de acceso ............................................................................2= ensa:e de )e*icin inicia+ ..................................................................26 ensa:e de res),es*a 4CC .................................................................26 !:e-)+o de res),es*a 4CC ............................................................26 ensa:e de con%ir-acin 4CC .............................................................2@ !:e-)+o de -ensa:e de con%ir-acin de -oneda 4CC ......................2@ ensa:e de res),es*a ........................................................................28 ensa:e de cons,+*a 4CC ...................................................................28 !:e-)+o de -ensa:e de cons,+*a 4CC .............................................28 ensa:e de res),es*a de cons,+*a 4CC ................................................28 !:e-)+o de -ensa:e de res),es*a cons,+*a 4CC ..............................29
6.1 6.2
6.3 6.3.1 6.4 6.4.1 6.= 6.6 6.6.1 6.@ 6.@.1 6.8
Fir-a de+ co-ercio ............................................................................29 "e*iciones de con%ir-acin 4CC .....................................................29 "e*iciones de cons,+*a de 4CC .......................................................30
6.8.1 6.8.2
ANE6O I7 WS,L #e" er$icio...................................................................... 2ANE6O II7 Ca)(o o(ciona"e .................................................................. 22
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 4
-. -.-
Intro#ucci%n O*8eti$o
(a 6,;a de+ 2"V Vir*,a+ Be/Ser0ice reco6e +os as)ec*os, *an*o *Acnicos co-o o)era*i0os, a *ener en c,en*a )or +os co-ercios 7,e deseen ,*i+i8ar e+ 2"V Vir*,a+ S3S de R!4SCS, en +a rea+i8acin de s,s co-)ras )or 3n*erne* a *ra0As de ,na cone?in Be/Ser0ice.
-./
9)*ito
!+ 2"V Vir*,a+ Be/Ser0ice )er-i*e a +os co-ercios *ener in*e6rado e+ 2"V Vir*,a+ den*ro de s, )ro)ia a)+icacin Be/. !s*e *i)o de cone?in a+ 2"V Vir*,a+ S3S, a *ra0As de Be/Ser0ice no se )er-i*e en a7,e++os co-ercios 7,e )osean -A*odos de )a6o se6,ros, 7,e so+ici*an a,*en*icacin de+ *i*,+ar )or )ar*e de +a en*idad e-isora de +a *ar:e*a, ya 7,e so+o )er-i*e rea+i8ar )a6os *radiciona+es.
#diciona+-en*e, se )er-i*e +a o)era*i0a 4CC, )ara a7,e++os co-ercios 7,e *en6an ha/i+i*ada es*a o)cin.
-.2
,efinicione : i3"a ! a*re$iatura

S3S: Ser0idor In*e6rado RE,S;S. 3nc+,ye +a o)era*i0a de +a )asare+a de )a6os a *ra0As de 3n*erne*.
2"V Vir*,a+: Ter-ina+ P,n*o de Ven*a Vir*,a+. #sociado a cada ,no de +os co-ercios 7,e o)eran a *ra0As de+ S3S.
4CC: 4yna-ic C,rrency Con0ersin. "er-i*e ace)*ar *ransacciones en -9+*i)+es di0isas, en %,ncin de c-o es*A es*a/+ecida +a c,en*a asociada a +a *ar:e*a.
-.4
Referencia
!s*<ndar de Dash Se6,ro, F3"S "15 180E1.
h**)://FFF.i*+.nis*.6o0/%i)s),/s/%i)180E1.h*-
(is*a de 3-)+e-en*aciones Va+idadas de+ SD#E1

h**)://csrc.nis*.6o0/cry)*0a+/dss/dsa0a+.h*-
-..
Panor<)ica #e" #ocu)ento

Redsys C/ Francisco Sancha, 12 28034 adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 =
# +o +ar6o de +os ca);*,+os de+ )resen*e doc,-en*o se descri/en +os )asos a se6,ir )ara )oder rea+i8ar +a in*e6racin de +a a)+icacin en*re +os c+ien*es 7,e hayan e+e6ido es*e *i)o de cone?in y +a )asare+a de )a6o de+ 2"V Vir*,a+ de R!4SCS.
!n e+ ca);*,+o 2 se descri/en +as ins*r,cciones de cone?in y se in%or-a de +as ,r+Gs donde se ),eden rea+i8ar +as )r,e/as, as; co-o +a %,*,ra cone?in %ina+ en e+ en*orno de )rod,ccin. Se -enciona as; -is-o e+ -A*odo ,*i+i8ado )ara rea+i8ar +os )a6os en e+ 2"V Vir*,a+ Be/Ser0ice.
"os*erior-en*e, en e+ ca);*,+o 3, y ,na 0e8 rea+i8ada +a cone?in a +a )asare+a de )a6o, se descri/en, con e:e-)+os, +as es)eci%icaciones de +os -ensa:es de )e*icin y res),es*a a+ 2"V Vir*,a+, -edian*e cone?in Be/Ser0ice.
!+ ca);*,+o 4 se dedica co-)+e*a-en*e a+ c<+c,+o de +a %ir-a de se6,ridad de+ co-ercio. !s*a %ir-a 6aran*i8a +a a,*en*icidad e in*e6ridad de +os da*os 7,e se en0;an d,ran*e +a co-,nicacin.
Si d,ran*e e+ )roceso de in*e6racin, o en s, ),es*a en )rod,ccin, se de*ec*an errores, )odr<n ser cons,+*ados en e+ ca);*,+o =, donde se descri/en +os di%eren*es cdi6os de error 7,e ),eden a)arecer en +os -ensa:es de res),es*a de +a )asare+a de )a6o.
#diciona+-en*e, si s, co-ercio *iene con*ra*ada +a o)era*i0a 4CC, ),ede cons,+*ar e+ ca);*,+o 6 )ara conocer +as es)eci%icaciones de i-)+e-en*acin de es*a o)era*i0a en e+ 2"V Vir*,a+ Be/Ser0ice de R!4SCS.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 6
/.
In truccione #e cone0i%n
(a cone?in a+ 2"V Vir*,a+ S3S de R!4SCS, se rea+i8ar< -edian*e e+ en0;o de ,na )e*icin 0;a Be/Ser0ice a +a direccin indicada de+ S3S, en e+ a)ar*ado 2.1 de es*e doc,-en*o, se69n e+ en*orno en e+ 7,e se desee es*a/+ecer +a cone?in.
!+ sis*e-a de R!4SCS in*er)re*ar< es*a )e*icin y rea+i8ar< +as 0a+idaciones necesarias )ara, a con*in,acin, )rocesar +a o)eracin. 4e)endiendo de+ res,+*ado de +a o)eracin, se cons*r,ye ,n doc,-en*o H ( de res),es*a con e+ res,+*ado de +a -is-a.
/.-
URL #e cone0i%n
(a )e*icin a+ 2"V Vir*,a+ S3S se rea+i8ar< -edian*e ,n en0;o Be/Ser0ice a +as si6,ien*es direcciones en %,ncin de+ en*orno de *ra/a:o:
Entorno 3n*e6racin "r,e/as Rea+ URL h**)s://sisEi.redsys.es:2=443/sis/ser0ices/SerC+sBS!n*rada h**)s://sisE*.redsys.es:2=443/sis/ser0ices/SerC+sBS!n*rada h**)s://sis.redsys.es/sis/ser0ices/SerC+sBS!n*rada
!s i-)or*an*e des*acar 7,e +os en*ornos son *o*a+-en*e di%eren*es en*re s; y )or *an*o con*ienen dis*in*os da*os. Si s, co-ercio es*< en ,na %ase de )r,e/as o de in*e6racin de +a a)+icacin y 7,iere )asar a ,n en*orno de "rod,ccin, de/e so+ici*ar, -edian*e e+ cana+ corres)ondien*e: (a 0eri%icacin de ha/er s,)erado +a %ase an*erior. (os n,e0os da*os de+ en*orno a+ 7,e se 7,iera conec*ar.
/./
M=to#o #e acce o
!+ Be/Ser0ice *iene ),/+icados )=to#o so/re +os c,a+es o)eran +os 2"V Vir*,a+es. # con*in,acin rea+i8a-os ,na /re0e descri)cin de s, %,nciona+idad.
!+ -A*odo ItrataPeticion>, )er-i*e +a rea+i8acin de o)eraciones a *ra0As de+ 2"V Vir*,a+ Be/Ser0ice. Se cons*r,ye ,n H ( 7,e inc+,ye +os da*os )ara )oder rea+i8ar +a *ransaccin a *ra0As de+ 2"V Vir*,a+ de R!4SCS. (a descri)cin e?ac*a de es*a )e*icin H ( se ),ede 0er con de*a++e en +a BS4( de+ ser0icio S&#", en e+ #ne?o 3 de es*e doc,-en*o.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 @
2.
,ato #e" for)u"ario #e (a3o

"ara )oder rea+i8ar +a co-)ra a *ra0As de+ 2"V Vir*,a+ Be/Ser0ice de R!4SCS, es necesario in*erca-/iar ,na serie de da*os, *an*o en +os -ensa:es de )e*icin co-o en +os -ensa:es de res),es*a
"ode-os di%erenciar *res *i)os de )e*iciones:
E E E
"e*iciones de )a6o Jcon en0;o de da*os de *ar:e*aK "e*iciones de )a6os rec,rren*es Jcon en0;o de da*os de *ar:e*aK "e*iciones de Con%ir-acin/4e0o+,cin
!n cada *i)o 0ar;a +a es*r,c*,ra de+ -ensa:e y +os )ar<-e*ros 7,e se en0;an / reci/en. # con*in,acin e?)+ica-os cada *i)o con +os )ar<-e*ros necesarios y -os*ra-os ,n e:e-)+o de cada caso.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 8
2.-
Men a8e #e (etici%n #e (a3o

# con*in,acin se descri/en +os da*os necesarios y s,s carac*er;s*icas, )ara en0iar ,na )e*icin a+ 2"V Vir*,a+ Be/Ser0ice en %or-a*o H (. #s; -is-o se inc+,ye ,n e:e-)+o de c-o ,*i+i8ar esos da*os en +os -ensa:es de )e*icin de )a6o.
'o-/re de+ da*o
(on6. / 2i)o
4escri)cin
DS_MERCHANT_AMOUNT DS_MERCHANT_ORDER
12 / N 12 / A-N
Obligatorio. Las dos ltimas posiciones se consideran decimales, salvo en el caso de los Yenes que no tienen. Obligatorio. Nmero de pedido. Los 4 primeros dgitos deben ser numricos. Cada pedido es nico, no puede repetirse. Obligatorio. Cdigo FUC asignado al comercio. Obligatorio. Nmero de Terminal que le asignar su banco. Por defecto valor 001. 3 se considera su longitud mxima. Obligatorio. Moneda del comercio. Tiene que ser la contratada para el Terminal. Valor 978 para Euros, 840 para Dlares, 826 para Libras esterlinas y 392 para Yenes. Obligatorio. Tarjeta. Su longitud depende del tipo de tarjeta. Obligatorio. Caducidad de la tarjeta. Su formato es AAMM, siendo AA los dos ltimos dgitos del ao y MM los dos dgitos del mes. Obligatorio. Cdigo CVV2 de la tarjeta. Obligatorio. Campo para el comercio para indicar qu tipo de transaccin es. Los posibles valores son: A Pago tradicional 1 Preautorizacin O Autorizacin en diferido Obligatorio. Firma del comercio.
DS_MERCHANT_MERCHANTC ODE DS_MERCHANT_TERMINAL
9/N 3/N
DS_MERCHANT_CURRENCY
4/N
DS_MERCHANT_PAN DS_MERCHANT_EXPIRYDATE
19 / N 4/N
DS_MERCHANT_CVV2 DS_MERCHANT_TRANSACTIO NTYPE
3-4 / N 1 / A-N
DS_MERCHANT_MERCHANTS IGNATURE
40 / A-N
Tipo A: caracteres ASCII del 65 = A al 90 = Z y del 97 = a al 122 = z. Tipo N: caracteres ASCII del 30 = 0 al 39 = 9.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 9
2.-.-
E8e)("o #e )en a8e #e tran acci%n Petici%n #e (a3o
<DATOSENTRADA> <DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT> <DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE> <DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY> <DS_MERCHANT_PAN>4548810000000000</DS_MERCHANT_PAN> <DS_MERCHANT_CVV2>123</DS_MERCHANT_CVV2> <DS_MERCHANT_TRANSACTIONTYPE>A</DS_MERCHANT_TRANSACTIONTYPE> <DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL> <DS_MERCHANT_EXPIRYDATE>1212</DS_MERCHANT_EXPIRYDATE> <DS_MERCHANT_MERCHANTSIGNATURE>22809e232ae8c1b6996c9934530bc75b03b3c767</DS_M ERCHANT_MERCHANTSIGNATURE> </DATOSENTRADA>
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 10
2./
Men a8e #e (etici%n #e (a3o recurrente

'o-/re de+ da*o
(on6. / 2i)o
4escri)cin
12 / N 12 / A-N
Obligatorio. Las dos ltimas posiciones se consideran decimales, salvo en el caso de los Yenes que no tienen. Obligatorio. Nmero de pedido. Los 4 primeros dgitos deben ser numricos. Cada pedido es nico, no puede repetirse. Obligatorio. Cdigo FUC asignado al comercio. Obligatorio. Nmero de Terminal que le asignar su banco. Por defecto valor 001. 3 se considera su longitud mxima. Obligatorio. Moneda del comercio. Tiene que ser la contratada para el Terminal. Valor 978 para Euros, 840 para Dlares, 826 para Libras esterlinas y 392 para Yenes. Obligatorio. Tarjeta. Su longitud depende del tipo de tarjeta. Obligatorio. Caducidad de la tarjeta. Su formato es AAMM, siendo AA los dos ltimos dgitos del ao y MM los dos dgitos del mes. Obligatorio. Cdigo CVV2 de la tarjeta. Obligatorio. Campo para el comercio para indicar qu tipo de transaccin es. Los posibles valores son: 5 Transaccin Recurrente R Autorizacin recurrente inicial diferido
O*"i3atorio. Re)resen*a +a s,-a *o*a+ de +os i-)or*es de +as c,o*as. (as dos 9+*i-as )osiciones se consideran deci-a+es. O*"i3atorio. Frec,encia en d;as )ara +as *ransacciones rec,rren*es Jo/+i6a*orio )ara rec,rren*esK O*"i3atorio. For-a*o yyyyE Edd %echa +;-i*e )ara +as *ransacciones Rec,rren*es J&/+i6a*orio )ara rec,rren*es K O*"i3atorio. For-a*o yyyyE Edd. Re)resen*a +a %echa de +a o)eracin rec,rren*e s,cesi0a, necesaria )ara iden*i%icar +a *ransaccin en +as de0o+,ciones de o)eraciones rec,rren*es s,cesi0as. &/+i6a*orio )ara +as de0o+,ciones de o)eraciones rec,rren*es.
9/N 3/N
4/N
DS_MERCHANT_PAN DS_MERCHANT_EXPIRYDATE
19 / N 4/N
DS_MERCHANT_CVV2 DS_MERCHANT_TRANSACTIO NTYPE
3-4 / N 1 / A- N
DS_MERCHANT_SUMTOTAL
12 / '9-.
DS_MERCHANT_DATEFRECU ENCY DS_MERCHANT_CHARGEEXPI RYDATE DS_MERCHANT_TRANSACTIO NDATE
5/ N 10/ A-N
10 / A-N
40 / A-N
Obligatorio. Firma del comercio.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 11
2./.-
E8e)("o #e )en a8e #e tran acci%n Petici%n #e (a3o
<DATOSENTRADA> <DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT> <DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE> <DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY> <DS_MERCHANT_PAN>4548810000000000</DS_MERCHANT_PAN> <DS_MERCHANT_CVV2>123</DS_MERCHANT_CVV2> <DS_MERCHANT_TRANSACTIONTYPE>5</DS_MERCHANT_TRANSACTIONTYPE> <DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL>

L4SM !RCD#'2MS1 2&2#(N=00L/4SM !RCD#'2MS1 2&2#(N
<DS_MERCHANT_EXPIRYDATE>1212</DS_MERCHANT_EXPIRYDATE> <DS_MERCHANT_DATEFRECUENCY>8</DS_MERCHANT_DATEFRECUENCY> <DS_MERCHANT_CHARGEEXPIRYDATE>2009-10-21</DS_MERCHANT_CHARGEEXPIRYDATE> <DS_MERCHANT_AUTHORISATIONCODE>564674</DS_MERCHANT_AUTHORISATIONCODE> <DS_MERCHANT_TRANSACTIONDATE>2008-12-23</DS_MERCHANT_TRANSACTIONDATE> <DS_MERCHANT_MERCHANTSIGNATURE>e5d67504742c5f2174ce6294e5d67a2ce850ce8e</DS_ME RCHANT_MERCHANTSIGNATURE> </DATOSENTRADA>
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 12
2.2
Men a8e #e (etici%n #e Confir)aci%n?,e$o"uci%n

'o-/re de+ da*o
(on6. / 2i)o
4escri)cin
12 / N 12 / A-N
Obligatorio. Las dos ltimas posiciones se consideran decimales, salvo en el caso de los Yenes que no tienen. Obligatorio. Nmero de pedido. Los 4 primeros dgitos deben ser numricos. Cada pedido es nico, no puede repetirse. Obligatorio. Cdigo FUC asignado al comercio. Obligatorio. Nmero de Terminal que le asignar su banco. Por defecto valor 001. 3 se considera su longitud mxima. Obligatorio. Moneda del comercio. Tiene que ser la contratada para el Terminal. Valor 978 para Euros, 840 para Dlares, 826 para Libras esterlinas y 392 para Yenes. Obligatorio. Campo para el comercio para indicar qu tipo de transaccin es. Los posibles valores son: 2 Confirmacin 3 Devolucin Automtica 6 Transaccin Sucesiva 9 Anulacin de Preautorizacin P - Confirmacin de autorizacin en diferido Q - Anulacin de autorizacin en diferido S Autorizacin recurrente sucesiva diferido
O(ciona". Re)resen*a e+ cdi6o de a,*ori8acin necesario )ara iden*i%icar ,na *ransaccin rec,rren*e s,cesi0a en +as de0o+,ciones de o)eraciones rec,rren*es s,cesi0as. &/+i6a*orio en de0o+,ciones de o)eraciones rec,rren*es.
9/N 3/N
4/N
DS_MERCHANT_TRANSACTIO NTYPE
1 / A-N
DS_MERCHANT_AUTHORISAT IONCODE
6 / Num
40 / A-N
Obligatorio. Firma del comercio.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 13
2.2.-
E8e)("o #e )en a8e #e tran acci%n ,e$o"uci%n
<DATOSENTRADA> <DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT> <DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE> <DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY> <DS_MERCHANT_TRANSACTIONTYPE>3</DS_MERCHANT_TRANSACTIONTYPE> <DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL> <DS_MERCHANT_MERCHANTSIGNATURE>df66905b10a848ddfa80b202aedcd6b172533cc0</DS_ME RCHANT_MERCHANTSIGNATURE> </DATOSENTRADA>
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 14
2.4
Men a8e #e re (ue ta

# con*in,acin se descri/en +os da*os necesarios y s,s carac*er;s*icas 7,e se reci/ir<n en e+ -ensa:e de res),es*a, *ras ,na )e*icin a+ 2"V Vir*,a+ Be/Ser0ice, en %or-a*o H (. #s; -is-o se inc+,ye ,n e:e-)+o de c-o ,*i+i8ar esos da*os en +os -ensa:es de res),es*a.
'o-/re de+ da*o
(on6. / 2i)o
4escri)cin
CODIGO
Obligatorio. Indica si la operacin ha sido correcta o no, (no indica si ha sido autorizada, solo si se ha procesado). Un 0 indica que la operacin ha sido correcta. En el caso de que sea distinto de 0, tendr un cdigo. (Ver cdigos de error en apartado 5.1 de esta Gua) 12 / A-N Obligatorio. Para Euros las dos ltimas posiciones se consideran decimales, salvo en el caso de los Yenes que no tienen. Obligatorio. Moneda del comercio. Obligatorio. Nmero de pedido. Obligatorio. Firma del comercio. Obligatorio. Cdigo FUC asociado al comercio. Obligatorio. Nmero de Terminal del comercio. Obligatorio. Valor que indica el resultado de la operacin. Indicar si ha sido autorizada o no. Optativo. Cdigo de autorizacin en caso de existir para las operaciones autorizadas. Obligatorio. Indica qu tipo de transaccin se ha realizado. Los posibles valores son: A Pago tradicional 1 Preautorizacin 2 Confirmacin 3 Devolucin Automtica 5 Transaccin Recurrente 6 Transaccin Sucesiva 9 Anulacin de Preautorizacin O Autorizacin en diferido P - Confirmacin de autorizacin en diferido Q - Anulacin de autorizacin en diferido R Autorizacin recurrente inicial diferido S Autorizacin recurrente sucesiva diferido Obligatorio. Indica si el pago ha sido seguro o no: 0: seguro (no se aplica) 1: no seguro. 1/N Obligatorio. Idioma.
Ds_Amount
Ds_Currency Ds_Order Ds_Signature Ds_MerchantCode Ds_Terminal Ds_Response Ds_AuthorisationCode Ds_TransactionType
4/N 12 /A- N 40 / A-N 9/N 3/N 4/N 6/N 1 / A-N
Ds_SecurePayment
Ds_Language
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 1=
2.4.-
E8e)("o #e )en a8e #e re (ue ta #e "a o(eraci%n
<RETORNOXML> <CODIGO>0</CODIGO> <OPERACION> <Ds_Amount>145</Ds_Amount> <Ds_Currency>978</Ds_Currency> <Ds_Order>050911523002</Ds_Order> <Ds_Signature>702676D44A56D7222EAE1FBF16F74D58C6EA2D27</Ds_Signature> <Ds_MerchantCode>999008881</Ds_MerchantCode> <Ds_Terminal>999</Ds_Terminal> <Ds_Response>0000</Ds_Response> <Ds_AuthorisationCode>758688</Ds_AuthorisationCode> <Ds_TransactionType>A</Ds_TransactionType> <Ds_SecurePayment>0</Ds_SecurePayment> <Ds_Language>1</Ds_Language> <Ds_MerchantData> </Ds_MerchantData> <Ds_Card_Country>826</Ds_Card_Country> </OPERACION> </RETORNOXML>
2.4./
E8e)("o #e )en a8e #e re (ue ta #e "a o(eraci%n #e #e$o"uci%n
<RETORNOXML> <CODIGO>0</CODIGO> <OPERACION> <Ds_Amount>145</Ds_Amount> <Ds_Currency>978</Ds_Currency> <Ds_Order>102113140002</Ds_Order> <Ds_Signature>BAAC6FAA0EA24821B7CAB7D6A9875BC8BE3C1562</Ds_Signature> <Ds_MerchantCode>297124299</Ds_MerchantCode> <Ds_Terminal>1</Ds_Terminal> <Ds_Response>0900</Ds_Response> <Ds_AuthorisationCode>487603</Ds_AuthorisationCode> <Ds_TransactionType>3</Ds_TransactionType> <Ds_SecurePayment>0</Ds_SecurePayment> <Ds_Language>1</Ds_Language>
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 16
<Ds_MerchantData> </Ds_MerchantData> <Ds_Card_Country>724</Ds_Card_Country> </OPERACION> </RETORNOXML>
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 1@
4.
&ir)a #e" co)ercio

#+ co-ercio se +e do*ar< de ,na c+a0e, 7,e ,*i+i8ar< )ara %ir-ar +os da*os a)or*ados )or e+ -is-o, ),diendo 0eri%icarse no so+o +a iden*idad de+ co-ercio, sino 7,e +os da*os no han sido a+*erados en nin69n -o-en*o.
Co-o a+6ori*-o de sec,ri8acin se ,*i+i8ar< e+ Dash SD#E1, 7,e 6aran*i8a +os re7,isi*os -;ni-os de se6,ridad en c,an*o a +a a,*en*icacin de+ ori6en. !s*e -is-o a+6ori*-o se ,*i+i8ar< )ara ase6,rar a+ co-ercio +a a,*en*icidad de +os da*os de +a res),es*a.
4.-
C<"cu"o #e "a fir)a en (eticione #e (a3o

(a %ir-a e+ec*rnica de+ co-ercio, en +os -ensa:es de )e*icin de )a6o a+ 2"V Vir*,a+ Be/Ser0ice, se de/er< ca+c,+ar conca*enando e+ 0a+or de +os si6,ien*es ca-)os Jsa+0o 7,e sea a+6,no de 0a+or n,+o en c,yo caso no se considerar< en +a %ir-aK inc+,yendo a+ %ina+ +a c+a0e secre*a de encri)*acin:
DS_MERCHANT_AMOUNT + DS_MERCHANT_ORDER + DS_MERCHANT_MERCHANTCODE + DS_MERCHANT_CURRENCY + DS_MERCHANT_PAN + DS_MERCHANT_CVV2 + DS_MERCHANT_TRANSACTIONTYPE + CLAVE SECRETA
Importe = 145 (va multiplicado por 100). Pedido = 050911523002 Comercio = 999008881 Moneda = 978 Tarjeta = 4548810000000000 CVV2 = 123 Tipo de transaccin = A CLAVE SECRETA= qwertyasdf0123456789
Cadena resultado: 1450509115230029990088819784548810000000000123Aqwertyasdf0123456789 Resultado SHA-1: 22809e232ae8c1b6996c9934530bc75b03b3c767
4./
C<"cu"o #e "a fir)a en (eticione #e (a3o recurrente
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 18
(a %ir-a e+ec*rnica de+ co-ercio, en +os -ensa:es de )e*icin de )a6o a+ 2"V Vir*,a+ Be/Ser0ice, se de/er< ca+c,+ar conca*enando e+ 0a+or de ,na serie de ca-)os Jsa+0o 7,e sea a+6,no de 0a+or n,+o en c,yo caso no se considerar< en +a %ir-aK inc+,yendo a+ %ina+ +a c+a0e secre*a de encri)*acin:
DS_MERCHANT_AMOUNT + DS_MERCHANT_ORDER + DS_MERCHANT_MERCHANTCODE + DS_MERCHANT_CURRENCY + DS_MERCHANT_PAN + DS_MERCHANT_SUMTOTAL + DS_MERCHANT_CVV2 + DS_MERCHANT_TRANSACTIONTYPE + CLAVE SECRETA
Importe = 145 (va multiplicado por 100). Pedido = 050911523002 Comercio = 999008881 Moneda = 978 Tarjeta = 4548810000000000 Suma del importe total = 300 CVV2 = 123 Tipo de transaccin = 5 CLAVE SECRETA= qwertyasdf0123456789
Cadena resultado: 14505091152300299900888197845488100000000003001235qwertyasdf0123456789 Resultado SHA-1: 020c24bedb27114b80294f0eb37317e50c0a1e6d
4.2
C<"cu"o #e "a fir)a en (eticione ,e$o"uci%n
#e Confir)aci%n ?
(a %ir-a e+ec*rnica de+ co-ercio, en +os -ensa:es de )e*icin de )a6o a+ 2"V Vir*,a+ Be/Ser0ice, se de/er< ca+c,+ar conca*enando e+ 0a+or de +os si6,ien*es ca-)os Jsa+0o 7,e sea a+6,no de 0a+or n,+o en c,yo caso no se considerar< en +a %ir-aK inc+,yendo a+ %ina+ +a c+a0e secre*a de encri)*acin:
DS_MERCHANT_AMOUNT + DS_MERCHANT_ORDER + DS_MERCHANT_MERCHANTCODE + DS_MERCHANT_CURRENCY + DS_MERCHANT_TRANSACTIONTYPE + CLAVE SECRETA
Importe = 145 (va multiplicado por 100). Pedido = 050911523002 Comercio = 999008881 Moneda = 978 Tipo de transaccin = 3 CLAVE SECRETA= qwertyasdf0123456789
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 19
Cadena resultado: 1450509115230029990088819783qwertyasdf0123456789 Resultado SHA-1: df66905b10a848ddfa80b202aedcd6b172533cc0
4.4
C<"cu"o #e "a fir)a #e "a re (ue ta

(a %ir-a e+ec*rnica de+ co-ercio, en +os -ensa:es de res),es*a de+ 2"V Vir*,a+ Be/Ser0ice, se de/er< ca+c,+ar conca*enando e+ 0a+or de +os si6,ien*es ca-)os Jsa+0o 7,e sea a+6,no de 0a+or n,+o o 0ac;o en c,yo caso no se considerar< en +a %ir-aK inc+,yendo a+ %ina+ +a c+a0e secre*a de encri)*acin:
Ds_Amount + Ds_Order + Ds_MerchantCode + Ds_Currency + Ds_Response + Ds_CardNumber + Ds_TransactionType + Ds_SecurePayment + CLAVE SECRETA
"ara +a si6,ien*e res),es*a: <RETORNOXML> <CODIGO>0</CODIGO> <Ds_Version>1.0</Ds_Version> <OPERACION> <Ds_Amount>200</Ds_Amount> <Ds_Currency>978</Ds_Currency> <Ds_Order>1309265137</Ds_Order> <Ds_Signature>CB8B4CA56951ED7033CDB68F1292D268C3120E08</Ds_Signature> <Ds_MerchantCode>999008881</Ds_MerchantCode> <Ds_Terminal>1</Ds_Terminal> <Ds_Response>0180</Ds_Response> <Ds_AuthorisationCode></Ds_AuthorisationCode> <Ds_TransactionType>A</Ds_TransactionType> <Ds_SecurePayment>0</Ds_SecurePayment> <Ds_Language>1</Ds_Language> <Ds_CardNumber>491671******0017</Ds_CardNumber> <Ds_MerchantData>prueba merchant data TV</Ds_MerchantData> <Ds_Card_Country>724</Ds_Card_Country> </OPERACION> </RETORNOXML>
Importe = 200 (va multiplicado por 100). Pedido = 1309265137 Comercio = 999008881 Moneda = 978 Codigo de respuesta = 0180 Tarjeta = 491671******0017 Tipo de transaccin = A Pago seguro/no seguro = 0 CLAVE SECRETA= qwertyasdf0123456789
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 20
Cadena resultado: 20013092651372851771019780180491671******0017A0qwertyasdf0123456789 Resultado SHA-1: 3a422c23e861cbb2f8e8bf2d87c20032b18fd828
4..
Reco)en#acione (ara e" c<"cu"o #e "a fir)a.

1na 0e8 7,e se ha 6enerado +a %ir-a no se de/en -odi%icar +os da*os de +a )e*icin de nin69n -odo ya 7,e e+ S3S +os ,*i+i8a )ara 0a+idar+a. Si +os da*os 7,e se en0;an a+ 2"V Vir*,a+ Be/Ser0ice no son e?ac*a-en*e +os 7,e se ,*i+i8aron )ara 6enerar +a %ir-a, se 6enerar< ,n error y no se )odr< con*in,ar +a co-)ra.
!+ I)(orte 0endr< -,+*i)+icado )or 100, sin deci-a+es y sin ceros a +a i87,ierda, sa+0o e+ caso de +os yenes 7,e no *ienen deci-a+es.
!+ n@)ero #e (e#i#o ser< di%eren*e cada *ransaccin y +as 4 )ri-eras )osiciones han de ser n,-Aricas.
Veri%icar 7,e +a c"a$e 7,e se es*< ,*i+i8ando )ara hacer +a %ir-a es +a 7,e es*< asi6nada a+ co-ercio y co-)ro/ar e+ en*orno J)r,e/as o rea+K, en e+ 7,e es*< rea+i8ando +a )e*icin de co-)ra.
S, en*idad ad7,iren*e )odr< s,-inis*rar+e +a in%or-acin de con%i6,racin de+ co-ercio Jcdi6o de co-ercio, *er-ina+, c+a0e, e*c.K
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 21
..
Va"i#acione #urante e" (roce o #e co)(ra

!+ 2"V Vir*,a+ Be/Ser0ice inc+,ye 0a+idaciones y con*ro+es )ara de*ec*ar )osi/+es errores en +a en*rada de da*os.
#n*e c,a+7,ier en*rada a+ sis*e-a, se rea+i8an +as 0a+idaciones )er*inen*es de +os da*os de en*rada. Si +os da*os de en*rada no son correc*os, se 6enera ,n cdi6o de error y no se )er-i*e con*in,ar con +a o)eracin. 'or-a+-en*e es*as si*,aciones se )rod,cen d,ran*e e+ )roceso de in*e6racin de ,n n,e0o co-ercio.
#,n7,e +a in*e6racin de+ co-ercio sea correc*a, sie-)re se ),eden )rod,cir si*,aciones ines)eradas co-o )or e:e-)+o, +a de*eccin de )edidos re)e*idos.
..-
C%#i3o #e error
!n +a si6,ien*e *a/+a se +is*an +os di%eren*es errores 7,e ),eden a)arecer en +os -ensa:es de res),es*a de+ 2"V Vir*,a+.
ERROR
,ESCRIPCION
SIS0007 SIS0008 SIS0009 SIS0010 SIS0011 SIS0014 SIS0015 SIS0016 SIS0018 SIS0019 SIS0020 SIS0021 SIS0022 SIS0023 SIS0026 SIS0027 SIS0028 SIS0030
Error al desmontar el XML de entrada Error falta Ds_Merchant_MerchantCode Error de formato en Ds_Merchant_MerchantCode Error falta Ds_Merchant_Terminal Error de formato en Ds_Merchant_Terminal Error de formato en Ds_Merchant_Order Error falta Ds_Merchant_Currency Error de formato en Ds_Merchant_Currency Error falta Ds_Merchant_Amount Error de formato en Ds_Merchant_Amount Error falta Ds_Merchant_MerchantSignature Error la Ds_Merchant_MerchantSignature viene vaca Error de formato en Ds_Merchant_TransactionType Error Ds_Merchant_TransactionType desconocido Error No existe el comercio / terminal enviado Error Moneda enviada por el comercio es diferente a la que tiene asignada para ese terminal Error Comercio / terminal est dado de baja Error en un pago con tarjeta ha llegado un tipo de operacin no valido
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 22
SIS0031 SIS0034 SIS0038 SIS0040 SIS0041 SIS0042 SIS0046 SIS0051 SIS0054 SIS0055 SIS0056 SIS0057 SIS0058 SIS0059 SIS0060 SIS0061 SIS0062 SIS0063 SIS0064 SIS0065 SIS0066 SIS0067 SIS0068 SIS0069 SIS0070 SIS0071 SIS0072 SIS0074 SIS0075 SIS0076 SIS0078 SIS0079 SIS0081 SIS0089 SIS0092 SIS0093 SIS0112 SIS0115
Mtodo de pago no definido Error de acceso a la Base de Datos Error en java Error el comercio / terminal no tiene ningn mtodo de pago asignado Error en el clculo de la firma de datos del comercio La firma enviada no es correcta El BIN de la tarjeta no est dado de alta Error nmero de pedido repetido Error no existe operacin sobre la que realizar la devolucin Error no existe ms de un pago con el mismo nmero de pedido La operacin sobre la que se desea devolver no est autorizada El importe a devolver supera el permitido Inconsistencia de datos, en la validacin de una confirmacin Error no existe operacin sobre la que realizar la devolucin Ya existe una confirmacin asociada a la preautorizacin La preautorizacin sobre la que se desea confirmar no est autorizada El importe a confirmar supera el permitido Error. Nmero de tarjeta no disponible Error. El nmero de tarjeta no puede tener ms de 19 posiciones Error. El nmero de tarjeta no es numrico Error. Mes de caducidad no disponible Error. El mes de la caducidad no es numrico Error. El mes de la caducidad no es vlido Error. Ao de caducidad no disponible Error. El Ao de la caducidad no es numrico Tarjeta caducada Operacin no anulable Error falta Ds_Merchant_Order Error el Ds_Merchant_Order tiene menos de 4 posiciones o ms de 12 Error el Ds_Merchant_Order no tiene las cuatro primeras posiciones numricas Mtodo de pago no disponible Error al realizar el pago con tarjeta La sesin es nueva, se han perdido los datos almacenados El valor de Ds_Merchant_ExpiryDate no ocupa 4 posiciones El valor de Ds_Merchant_ExpiryDate es nulo Tarjeta no encontrada en la tabla de rangos Error. El tipo de transaccin especificado en Ds_Merchant_Transaction_Type no esta permitido Error no existe operacin sobre la que realizar el pago de la cuota
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 23
SIS0116 SIS0117 SIS0118 SIS0119 SIS0120 SIS0121 SIS0122 SIS0123 SIS0124 SIS0132 SIS0139 SIS0142 SIS0216 SIS0217 SIS0221 SIS0222 SIS0223 SIS0225 SIS0226 SIS0227 SIS0252 SIS0253 SIS0261 SIS0274
La operacin sobre la que se desea pagar una cuota no es una operacin vlida La operacin sobre la que se desea pagar una cuota no est autorizada Se ha excedido el importe total de las cuotas Valor del campo Ds_Merchant_DateFrecuency no vlido Valor del campo Ds_Merchant_CargeExpiryDate no vlido Valor del campo Ds_Merchant_SumTotal no vlido Valor del campo Ds_merchant_DateFrecuency o Ds_Merchant_SumTotal tiene formato incorrecto Se ha excedido la fecha tope para realizar transacciones No ha transcurrido la frecuencia mnima en un pago recurrente sucesivo La fecha de Confirmacin de Autorizacin no puede superar en ms de 7 das a la de Preautorizacin Error el pago recurrente inicial est duplicado Tiempo excedido para el pago Error Ds_Merchant_CVV2 tiene mas de 3/4 posiciones Error de formato en Ds_Merchant_CVV2 Error el CVV2 es obligatorio Ya existe una anulacin asociada a la preautorizacin La preautorizacin que se desea anular no est autorizada Error no existe operacin sobre la que realizar la anulacin Inconsistencia de datos, en la validacin de una anulacin Valor del campo Ds_Merchan_TransactionDate no vlido El comercio no permite el envo de tarjeta La tarjeta no cumple el check-digit Operacin detenida por superar el control de restricciones en la entrada al SIS Tipo de operacin desconocida o no permitida por esta entrada al SIS
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 24
5.
O(erati$a ,CC
# con*in,acin se de*a++ar<n *odas a7,e++as carac*er;s*icas adiciona+es de +a o)era*i0a 4CC 7,e *en6an +os co-ercios 7,e hayan con*ra*ado es*e ser0icio.
NOTA7 Co-o se -,es*ra en e+ 6r<%ico +a o)era*i0a 4CC se /asa en e+ en0;o de dos )e*iciones a+ Be/Ser0ice de+ 2"V Vir*,a+. "ara 6aran*i8ar e+ correc*o %,nciona-ien*o de+ sis*e-a, es necesario 7,e e+ co-ercio -an*en6a +a sesin en*re +a )ri-era y +a se6,nda ++a-ada a+ Be/Ser0ice. !+ -an*eni-ien*o de +a sesin de)ender< de+ so%*Fare ,*i+i8ado )ara rea+i8ar +a ++a-ada a+ Be/Ser0ice. "or e:e-)+o si se ,*i+i8a e+ #"3 de #?is, ser< s,%icien*e con ,*i+i8ar e+ -is-o IS*,/O )ara +as dos )e*iciones y %i:ar +a )ro)iedad setMaintainSession(trueK an*es de rea+i8ar +a )ri-era ++a-ada.
5.-
M=to#o #e acce o
!+ -A*odo de acceso ItrataPeticionO: )er-i*e +a rea+i8acin de o)eraciones a *ra0As de+ 2"V Vir*,a+ Be/Ser0ice. Se ,sa e+ -is-o -A*odo *an*o )ara rea+i8ar +os )a6os *radiciona+es co-o )ara +a o)era*i0a 4CC y, en %,ncin de +os ca-)os 7,e se re-i*an en e+ H ( de )e*icin, se rea+i8ar< ,na , o*ra o)cin.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 2=
!+ -A*odo de acceso Icon u"ta,CCO: )er-i*e hacer cons,+*as de+ 4CC asociado a ,n i-)or*e y ,na -oneda con an*erioridad a e:ec,*ar +a *ransaccin. !s -era-en*e in%or-a*i0o.
5./
Men a8e #e (etici%n inicia"

!+ -ensa:e de )e*icin inicia+ J1. "e*icin de )a6oK )osee +as -is-as carac*eris*icas 7,e +o descri*o an*erior-en*e en e+ a)ar*ado 3.1 de +a 6,;a de+ 2"V Vir*,a+ Be/Ser0ice.
5.2
Men a8e #e re (ue ta ,CC

# con*in,acin se descri/en +os da*os necesarios y s,s carac*er;s*icas, 7,e se reci/ir<n en +os -ensa:es de res),es*a 4CC J2. Res),es*a -onedas 4CCK de+ 2"V Vir*,a+ en e+ %or-a*o H ( descri*o an*erior-en*e )ara +a o)era*i0a 4CC y 7,e sir0en co-o e:e-)+o )ara +a )os*erior con%ir-acin 4CC.
'o-/re de+ da*o
(on6. / 2i)o
4escri)cin
CAMPOS ESPECFICOS DE LA OPERTIVA DCC moneda litMoneda litMonedaR cambio importe checked margenDCC nombreEntidad DS_MERCHANT_SESION 3/N -/A 3/R - /N -/N true/false -/N -/A - / AN Obligatorio. Valor del identificador de la moneda (ISO-4217), Obligatorio. Literal asociado a la moneda. Obligatorio. Literal reducida asociado a la moneda. Obligatorio. Valor del cambio de la moneda. Obligatorio. Importe en la moneda. Obligatorio. Indica divisa comprobada. Obligatorio. Margen DCC aplicado por la entidad al importe. Obligatorio. Nombre de la entidad bancaria que aplica el DCC. Obligatorio. Identificador de la sesin para continuar la operacin en operativas DCC.
5.2.-
E8e)("o #e re (ue ta ,CC
LR!2&R'&H (N
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 26
LC&43P&N0L/C&43P&N L4CCN L-onedaN826L/-onedaN L+i* onedaN"&1'4 S2!R(3'PL/+i* onedaN L+i* onedaRNP5"L/+i* onedaRN Lca-/ioN1.413@88L/ca-/ioN Li-)or*eN1.03L/i-)or*eN LchecQedN*r,eL/checQedN L/4CCN L4CCN L-onedaN9@8L/-onedaN L+i* onedaN!,rosL/+i* onedaN Li-)or*eN1.4=L/i-)or*eN L/4CCN L-ar6en4CCN2.=L/-ar6en4CCN Lno-/re!n*idadNS3' C#"21R#L/no-/re!n*idadN L4SM !RCD#'2MS!S3&'N0HC+?2s%QVR6S(820R48(0-L/4SM !RCD#'2MS!S3&'N L/R!2&R'&H (N
5.4
Men a8e #e confir)aci%n ,CC

# con*in,acin se descri/en +os da*os necesarios y s,s carac*er;s*icas )ara en0iar ,na )e*icin de con%ir-acin 4CC J3. Con%ir-acin -oneda 4CCK a+ 2"V Vir*,a+ Be/ser0ice en e+ %or-a*o y 7,e sir0en co-o e:e-)+o )ara con%ir-ar e+ an*erior -ensa:e de )e*icin 4CC
'o-/re de+ da*o
(on6. / 2i)o
4escri)cin
CAMPOS ADICIONALES REQUERIDOS EN LA SEGUNDA PETICIN Sis_Divisa 16/A-N Obligatorio. Dos valores separados por #. El primero es el identificador de la moneda (ISO4217), el segundo el importe en dicha moneda. Obligatorio. Identificador de la sesin para continuar la operacin en operativas DCC.
DS_MERCHANT_SESION
5.4.-
E8e)("o #e )en a8e #e confir)aci%n #e )one#a ,CC
< DATOSENTRADA > <DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE> <Sis_Divisa>826#1.03</Sis_Divisa>

Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 2@
<DS_MERCHANT_SESION>vXYlxTsfkVJ6ZL82vJ48Lvm</DS_MERCHANT_SESION> <DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL> <DS_MERCHANT_MERCHANTSIGNATURE>b7a9dcc79fd1146f315ad3461a5a2009850cc375</DS_ME RCHANT_MERCHANTSIGNATURE> </ DATOSENTRADA >
5..
Men a8e #e re (ue ta

!+ -ensa:e de res),es*a J4. Res),es*a de )a6oK )osee +as -is-as carac*er;s*icas 7,e +o descri*o an*erior-en*e en e+ a)ar*ado 3.2 de +a 6,;a de+ 2"V Vir*,a+ Be/Ser0ice.
5.5
Men a8e #e con u"ta ,CC

!+ -ensa:e de cons,+*a 4CC se 6enerar< con +os da*os an*erior-en*e descri*os en ,n H ( 7,e se -andar< a+ -A*odo con u"ta,CC. !s*a cons,+*a es so+a-en*e in%or-a*i0a.
5.5.-
E8e)("o #e )en a8e #e con u"ta ,CC
<DATOSENTRADA> <DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT> <DS_MERCHANT_ORDER>091912584602</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE> <DS_MERCHANT_CURRENCY>826</DS_MERCHANT_CURRENCY> <DS_MERCHANT_TERMINAL>9</DS_MERCHANT_TERMINAL> <DS_MERCHANT_MERCHANTSIGNATURE>e5533fff40f4a26c9de04cb2a1e7861282cc90be</DS_MERCHANT_ MERCHANTSIGNATURE></DATOSENTRADA>
5.1
Men a8e #e re (ue ta #e con u"ta ,CC

!+ -ensa:e de cons,+*a 4CC se 6enerar< con +os da*os an*erior-en*e descri*os en ,n H ( 7,e se -andar< a+ -A*odo con u"ta,CC.
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 28
5.1.-
E8e)("o #e )en a8e #e re (ue ta con u"ta ,CC
<RETORNOXML> <CODIGO>0</CODIGO> <DCC> <moneda>826</moneda> <litMoneda>POUND STERLING</litMoneda> <litMonedaR>GBP</litMonedaR> <cambio>1.413788</cambio> <importe>1.03</importe> <checked>true</checked> </DCC> <DCC><moneda>978</moneda> <importe>1.45</importe> </DCC> <margenDCC>2.5</margenDCC> <nombreEntidad>LA CAIXA </nombreEntidad> </RETORNOXML>
5.8
5.8.-
&ir)a #e" co)ercio

Peticione #e confir)aci%n ,CC
!n e+ caso de 7,e se re7,iera rea+i8ar ,na se6,nda )e*icin a+ 2"V Vir*,a+ Be/Ser0ice, de/ido a 7,e se ad-i*a 4CC en +a o)era*i0a, +a %ir-a se ca+c,+ar< de +a si6,ien*e -anera:
DS_MERCHANT_ORDER + DS_MERCHANT_MERCHANTCODE DS_MERCHANT_SESION + CLAVE SECRETA + Sis_Divisa +
Pedido = 050911523002 Comercio = 999008881 Divisa e importe = 826#1.03 Identificador de sesin = vXYlxTsfkVJ6ZL82vJ48Lvm CLAVE SECRETA=qwertyasdf0123456789
Cadena resultado: 050911523002999008881826#1.03vXYlxTsfkVJ6ZL82vJ48Lvmqwertyasdf0123456789 Resultado SHA-1: b7a9dcc79fd1146f315ad3461a5a2009850cc375
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 29
5.8./
Peticione #e con u"ta #e ,CC

(a %ir-a e+ec*rnica de+ co-ercio se de/er< ca+c,+ar conca*enando e+ 0a+or de +os si6,ien*es ca-)os Jsa+0o 7,e sea a+6,no de 0a+or n,+o en c,yo caso no se considerar< en +a %ir-aK inc+,yendo a+ %ina+ +a c+a0e secre*a de encri)*acin:
DS_MERCHANT_AMOUNT + DS_MERCHANT_ORDER + DS_MERCHANT_MERCHANTCODE + DS_MERCHANT_CURRENCY + CLAVE SECRETA
Importe = 145 (va multiplicado por 100). Pedido = 050911523002 Comercio = 999008881 Moneda = 978 CLAVE SECRETA= qwertyasdf0123456789
Cadena resultado: 145050911523002999008881978qwertyasdf0123456789 Resultado SHA-1: 32e9820a3b3b19e5b51b08478e13defa47d5443a
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 30
ANE6O I7 WS,L #e" er$icio

(a BS4( es*< dis)oni/+e en +as si6,ien*es direcciones:
Entorno 3n*e6racin "r,e/as Rea+
URL h**)s://sisEi.redsys.es:2=443/sis/ser0ices/SerC+sBS!n*radaTBS4( h**)s://sisE*.redsys.es:2=443/sis/ser0ices/SerC+sBS!n*radaTBS4( h**)s://sis.redsys.es/sis/ser0ices/SerC+sBS!n*radaTBS4(
3nc+,i-os +a BS4( de+ en*orno de )rod,ccin Jrea+K.
<?xml version="1.0" encoding="UTF-8"?> <wsdl:definitions targetNamespace="http://webservice.sis.sermepa.es" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://webservice.sis.sermepa.es" xmlns:intf="http://webservice.sis.sermepa.es" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <wsdl:types> <schema elementFormDefault="qualified" targetNamespace="http://webservice.sis.sermepa.es" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://webservice.sis.sermepa.es" xmlns:intf="http://webservice.sis.sermepa.es" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> <element name="trataPeticion"> <complexType> <sequence> <element name="datoEntrada" nillable="true" type="xsd:string"/> </sequence> </complexType> </element> <element name="trataPeticionResponse"> <complexType> <sequence> <element name="trataPeticionReturn" nillable="true" type="xsd:string"/> </sequence> </complexType> </element> <element name="consultaDCC"> <complexType> <sequence> <element name="datoEntrada" nillable="true" type="xsd:string"/> </sequence> </complexType> </element> <element name="consultaDCCResponse"> <complexType> <sequence> <element name="consultaDCCReturn" nillable="true" type="xsd:string"/> </sequence> </complexType> </element> </schema>
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 31
</wsdl:types> <wsdl:message name="consultaDCCRequest"> <wsdl:part element="intf:consultaDCC" name="parameters"/> </wsdl:message> <wsdl:message name="trataPeticionResponse"> <wsdl:part element="intf:trataPeticionResponse" name="parameters"/> </wsdl:message> <wsdl:message name="trataPeticionRequest"> <wsdl:part element="intf:trataPeticion" name="parameters"/> </wsdl:message> <wsdl:message name="consultaDCCResponse"> <wsdl:part element="intf:consultaDCCResponse" name="parameters"/> </wsdl:message> <wsdl:portType name="SerClsWSEntrada"> <wsdl:operation name="trataPeticion"> <wsdl:input message="intf:trataPeticionRequest" name="trataPeticionRequest"/> <wsdl:output message="intf:trataPeticionResponse" name="trataPeticionResponse"/> </wsdl:operation> <wsdl:operation name="consultaDCC"> <wsdl:input message="intf:consultaDCCRequest" name="consultaDCCRequest"/> <wsdl:output message="intf:consultaDCCResponse" name="consultaDCCResponse"/> </wsdl:operation> </wsdl:portType> <wsdl:binding name="SerClsWSEntradaSoapBinding" type="intf:SerClsWSEntrada"> <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="trataPeticion"> <wsdlsoap:operation soapAction=""/> <wsdl:input name="trataPeticionRequest"> <wsdlsoap:body use="literal"/> </wsdl:input> <wsdl:output name="trataPeticionResponse"> <wsdlsoap:body use="literal"/> </wsdl:output> </wsdl:operation> <wsdl:operation name="consultaDCC"> <wsdlsoap:operation soapAction=""/> <wsdl:input name="consultaDCCRequest"> <wsdlsoap:body use="literal"/> </wsdl:input> <wsdl:output name="consultaDCCResponse"> <wsdlsoap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="SerClsWSEntradaService"> <wsdl:port binding="intf:SerClsWSEntradaSoapBinding" name="SerClsWSEntrada"> <wsdlsoap:address location="https://sis.redsys.es/sis/services/SerClsWSEntrada"/> </wsdl:port> </wsdl:service> </wsdl:definitions>
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 32
ANE6O II7 Ca)(o o(ciona"e

#de-<s de +os )ar<-e*ros/ca-)os Jda*osK an*erior-en*e indicados, *a-/iAn ),eden inc+,irse +os descri*os en +a si6,ien*e *a/+a. Son o)ciona+es:
4#2& 4escri)cin de+ )rod,c*o
'& 5R! 4!( 4#2& DS_MER !ANT_"R#D$ TDES R%"T%#N
(on6. / 2i)o 1&5 / A-N
C& !'2#R3&S O(tati$o. 12= se considera s, +on6i*,d -<?i-a. !s*e ca-)o se -os*rar< a+ *i*,+ar en +a )an*a++a de con%ir-acin de +a co-)ra. O(tati$o. S, +on6i*,d -<?i-a es de 60 carac*eres. !s*e ca-)o se -os*rar< a+ *i*,+ar en +a )an*a++a de con%ir-acin de +a co-)ra. O(tati$o. Ca-)o o)ciona+ )ara e+ co-ercio )ara ser inc+,idos en +os da*os en0iados )or +a res),es*a IonE+ineO a+ co-ercio si se ha e+e6ido es*a o)cin. O(tati$o. 3" de+ c+ien*e.
'o-/re y a)e++idos de+ *i*,+ar 4a*os de+ co-ercio
DS_MER !ANT_T%T$LAR
60 / A-N
DS_MER !ANT_MER !ANTDA TA
10&' / A-N
3" de+ C+ien*e
DS_MERCHANT_CLIENTIP
15 /A-N
!n +a res),es*a de0o+0ere-os s+o es*e ca-)o:
4#2& 4a*os co-ercio de+
'& 5R! 4!( 4#2&
(&'P/23" & 10&' / A-N
C& !'2#R3&S O(tati$o. 3n%or-acin o)ciona+ en0iada )or e+ co-ercio en e+ %or-,+ario de )a6o.
DS_MER !ANTDATA
adrid !S"#$#
Re% RS.&"."R&. #'.0008 Versin: 2.0
26/09/2013 33

TPV Virtual Webservice - v1.0 Rs - Op.pro - Man.0008

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

TPV Virtual Webservice - v1.0 Rs - Op.pro - Man.0008

Caricato da

Copyright:

Formati disponibili

SIS TPV VIRTUAL WEBSERVICE

Versin: 2.0 26/09/2013

Redsys C/ Francisco Sancha, 12 28034

Re% RS.&"."R&. #'.0008 Versin: 2.0

Autorizacione ! contro" #e $er i%n

Ver i%n 1.0 2.0

&ec'a 09/02/2012 26/09/2013

Redsys C/ Francisco Sancha, 12 28034

Re% RS.&"."R&. #'.0008 Versin: 2.0