Integracion TPVPC Implantado

Integracion TpvpcImplantado Integracion TpvpcImplantado Integracion TpvpcImplantado Integracion TpvpcImplantado
Versin: 2.27
28/08/2014

Referencia Referencia Referencia Referencia SM.DE.DNC.MAN.0046 SM.DE.DNC.MAN.0046 SM.DE.DNC.MAN.0046 SM.DE.DNC.MAN.0046
Redsys C/ Francisco Sancha, 12 28034 Madrid ESPAA

Ref SM.DE.DNC.MAN.0046

28/08/2014
Versin: 2.27

i

Integracion TpvpcImplantado


Ref SM!E!"CMA"004#

28/08/2014
$ersi%n& 22'

ii

(
a

)
r
o
)
i
e
d
a
d

i
n
*
e
+
e
c
*
,
a
+

d
e

e
s
*
e

d
o
c
,
-
e
n
*
o

)
e
r
*
e
n
e
c
e

a

R
e
d
s
y
s

.
,
e
d
a

)
r
o
h
i
/
i
d
a

s
,

r
e
)
r
o
d
,
c
c
i
%
n
,

0
e
n
*
a
,

o

c
e
s
i
%
n

a

*
e
r
c
e
r
o
s

Autorizaciones y control de versin Autorizaciones y control de versin Autorizaciones y control de versin Autorizaciones y control de versin

AUTOR: Redsys VALIDADO POR: APROBADO POR:
EMPRESA: Redsys EMPRESA: Redsys

EMPRESA: Redsys
Firma: Firma: Firma:
Fecha: 01/04/2011 Fecha: 01/04/2011 Fecha: 01/04/2011
Comentarios: La gestin de la documentacin impresa es responsabilidad de la persona que la imprime.
Las versiones impresas de los documentos no garantizan ser la ltima versin aprobada. Para consultar la ltima
versin acceder a la base de datos de Alejandra.

Versin Versin Versin Versin Fecha Fecha Fecha Fecha Afecta Afecta Afecta Afecta Breve descripcin del cambio Breve descripcin del cambio Breve descripcin del cambio Breve descripcin del cambio
28 12/02/10 !oc,-en*aci%n Se ac*,a+i1a e+ for-a*o de+ doc,-en*o
22 12/03/10 !oc,-en*aci%n
Se a4ade ,n +a r,*a de ,n e5e-)+o de
6n*e7raci%n en $is,a+ 8asic "e*
210 12/03/10 !oc,-en*aci%n Arre7+ados errores en secci%n cons,+*as
211 22/02/10 !oc,-en*aci%n
A7re7ados errores A9:;P$PC9999 de+
co-)onen*e Ac*i0e9 de co-,nicaci%n con
PinPad
212 18/10/10 !oc,-en*aci%n
Se e+i-ina +a o)era*i0a PA" en c+aro an*es
de *ransacci%n
213 23/11/10 !oc,-en*aci%n
Se a4ade +a o)era*i0a de de0o+,ciones con
+ec*,ra
214 01/12/10 !oc,-en*aci%n Ac*,a+i1aci%n de c%di7os de dene7aci%n
213 28/12/10 !oc,-en*aci%n
Ac*,a+i1aci%n de c%di7os de error de
o)eraci%n
21# 04/02/11 !oc,-en*aci%n 6n*e7raci%n 0ersi%n (in,<
21' 1#/02/11 !oc,-en*aci%n 6n*e7raci%n 0ersi%n =A$A
218 01/03/11 !oc,-en*aci%n
Se es)ecifica >,e +a de0o+,ci%n con *ar5e*a
no es 0?+ida )ara @indoAs Mo/i+e



Ref SM!E!"CMA"004#

28/08/2014
$ersi%n& 22'

iii

(
a

)
r
o
)
i
e
d
a
d

i
n
*
e
+
e
c
*
,
a
+

d
e

e
s
*
e

d
o
c
,
-
e
n
*
o

)
e
r
*
e
n
e
c
e

a

R
e
d
s
y
s

.
,
e
d
a

)
r
o
h
i
/
i
d
a

s
,

r
e
)
r
o
d
,
c
c
i
%
n
,

0
e
n
*
a
,

o

c
e
s
i
%
n

a

*
e
r
c
e
r
o
s

212 10/03/11 Ane<o 666
Se a4aden 0arios c%di7os de error )ara +as
diferen*es f,nciones
220 24/03/11 !oc,-en*aci%n
Se a4ade +a o)era*i0a de re)e*iciones de
)a7os con *ar5e*a en archi0o ",e0a
)+an*i++a de doc,-en*aci%n
221 12/12/11 !oc,-en*aci%n
Se a4ade +a o)era*i0a de ree-)+a1o de
)rea,*ori1aciones en e+ in*erfa1 Ac*i0e9
222 12/04/12 !oc,-en*aci%n
Se ac*,a+i1an +as e*i>,e*as de+ -ensa5e
!CC
Se ac*,a+i1an referencias a RE!SBS
223 #/#/12 !oc,-en*aci%n Ada)*aci%n i-?7enes Redsys
224 2'/'/12 !oc,-en*aci%n 6nc+,si%n de o)era*i0a con*ac*+ess
223 13/0#/14 !oc,-en*aci%n
6nc+,si%n de reci/os de o)eraciones AME9,
iden*ificaci%n e infor-aci%n a4adida
Ac*,a+i1aci%n de infor-aci%n en reci/os
Con*ac*+ess
22# 23/0#/14 !oc,-en*aci%n
Reci/os de !e0o+,cines y !e0o+,ciones sin
ori7ina+
22' 28/08/14 !oc,-en*aci%n Ac*,a+i1ado +is*ado de -arcas con CCP



Ref SM!E!"CMA"004#

28/08/2014
$ersi%n& 22'

i0

(
a

)
r
o
)
i
e
d
a
d

i
n
*
e
+
e
c
*
,
a
+

d
e

e
s
*
e

d
o
c
,
-
e
n
*
o

)
e
r
*
e
n
e
c
e

a

R
e
d
s
y
s

.
,
e
d
a

)
r
o
h
i
/
i
d
a

s
,

r
e
)
r
o
d
,
c
c
i
%
n
,

0
e
n
*
a
,

o

c
e
s
i
%
n

a

*
e
r
c
e
r
o
s

NDICE DE CONTENIDO

1. Introduccin ........................................................................................ 1
2. Destinatarios ........................................................................................ 1
3. Integracin TpvpcImplantado .............................................................. 2
31 6niciar Co-,nicaci%n en Modo ;rans)aren*e 3
32 6niciar Co-,nicaci%n en Modo 6n*erfa1 de Cs,ario 4
33 !e*ener +a Co-,nicaci%n 3
34 Rea+i1ar ,n Pa7o o ,na Prea,*ori1aci%n ,*i+i1ando ,n dis)osi*i0o PinPad #
33 Rea+i1ar ,n Pa7o o Prea,*ori1aci%n in*rod,ciendo -an,a+-en*e +os da*os
de +a *ar5e*a '
3# DC%-o 0a+idar si +a o)eraci%n res,+*% AC;ER6FA!AG 10
3' Rea+i1ar ,na o)eraci%n de Confir-aci%n o !e0o+,ci%n 11
38 DC%-o rea+i1ar ,na !e0o+,ci%n/Confir-aci%n desde o*ro *er-ina+G 13
32 Rea+i1ar ,na o)eraci%n de !e0o+,ci%n con +ec*,ra desde e+ Pin)ad 14
310 DC%-o 0a+idar si +a o)eraci%n res,+*% AC;ER6FA!AG 1#
311 Rea+i1ar ,na o)eraci%n de !e0o+,ci%n sin Eri7ina+ 1#
312 Rea+i1ar ,na o)eraci%n de !e0o+,ci%n sin Eri7ina+ in*rod,ciendo
-an,a+-en*e +os da*os de +a *ar5e*a 18
313 DC%-o 0a+idar si +a o)eraci%n res,+*% AC;ER6FA!AG 12
314 Rea+i1ar cons,+*as de E)eraciones 20
313 Rea+i1ar Cons,+*a de ;o*a+es 23
31# Rea+i1ar E)eraci%n !CC 23
31' Rea+i1ar E)eraci%n !CC con En*rada Man,a+ de !a*os 2'
318 E5e-)+o de E)eraci%n !CC 28
312 Rea+i1ar ,na re)e*ici%n de )a7o con *ar5e*a en archi0o 32
4. NE!O I. Integracin ctive! ............................................................ 34
". NE!O II. Integracin #indo$s %o&ile '(oc)et (C* ......................... 3+
,. NE!O III. Errores devueltos ............................................................. 3-
+. NE!O I.. .ersiones /i&rer0a ............................................................. 4"
'1 DC,?ndo de/e rea+i1arse ,na ac*,a+i1aci%n de es*a (i/rerHaG 43



Ref SM!E!"CMA"004#

28/08/2014
$ersi%n& 22'

0

(
a

)
r
o
)
i
e
d
a
d

i
n
*
e
+
e
c
*
,
a
+

d
e

e
s
*
e

d
o
c
,
-
e
n
*
o

)
e
r
*
e
n
e
c
e

a

R
e
d
s
y
s

.
,
e
d
a

)
r
o
h
i
/
i
d
a

s
,

r
e
)
r
o
d
,
c
c
i
%
n
,

0
e
n
*
a
,

o

c
e
s
i
%
n

a

*
e
r
c
e
r
o
s

1. NE!O .. Diccionario de Datos .......................................................... 4+
-. NE!O .I. Cdigos Error T(.(C ......................................................... "1
12. NE!O .II. Cdigos de Denegacin ................................................... "1
11. NE!O .III. E3emplos Impresin de 4eci&os .................................... ,2
111 Reci/o )ara ,na o)eraci%n rea+i1ada con (ec*,ra de 8anda o En*rada
Man,a+ de !a*os #0
112 Reci/o )ara ,na o)eraci%n rea+i1ada con ,na ;ar5e*a con Chi) EM$ #1
113 Reci/o )ara ,na o)eraci%n rea+i1ada con ,na ;ar5e*a !CC #2
114 E5e-)+o de Reci/o de ,na o)eraci%n en +a >,e se reci/e e+ e+e-en*o
IReci/oSo+oC+ien*eJ #3
113 E5e-)+o de Reci/o c,ando se reci/e e+e-en*o Ia,*en*icadoPorPinJ #4
11# E5e-)+o de Reci/o c,ando se reci/e e+e-en*o Io)erCon*ac*(essJ #3
11' E5e-)+o de Reci/o c,ando !enie7a ;ar5e*a EM$ #'
118 E5e-)+o de Reci/o c,ando se rea+i1a ,na o)eraci%n con *ar5e*a AME9 #2
112 E5e-)+o de reci/o de ,na de0o+,ci%n '1
1110 E5e-)+o de reci/o de de0o+,ci%n sin ori7ina+ '2
12. NE!O I!. l llamar a la 5uncin de (ago6 (reautori7acin6
Con5irmacin o Devolucin nos devuelve el cdigo 82 ........................ +4
13. NE!O !. Operativas dicionales ....................................................... +,
131 E)era*i0a !CC rea+i1adas direc*a-en*e en PinPad '#
132 6nhi/ici%n de reci/o '8
133 E5e-)+o de 6n*e7raci%n Ac*i0e9 desde )?7ina K;M( '2
134 E5e-)+o de 6n*e7raci%n de (i/rerHa d++ desde A)+icaci%n en CL '2
133 E5e-)+o de 6n*e7raci%n de Ac*i0e9 desde A)+icaci%n $is,a+ 8asic #0 '2
13# E5e-)+o de 6n*e7raci%n de Ac*i0e9 desde A)+icaci%n $is,a+ 8asic "E;
M2003N '2
13' E5e-)+o de 6n*e7raci%n de Ac*i0e9 desde A)+icaci%n PoAer8,i+der 11 80
138 E5e-)+o de 6n*e7raci%n de (i/rerHa desde CL )ara @indoAs Mo/i+e
MPocOe* PcN 80
132 E5e-)+o de 6n*e7raci%n de Ac*i0e9 desde A)+icaci%n =a0a 80
1310 E5e-)+o de 6n*e7raci%n de (i/rerHa en $is,a+ CPP #0 81
14. NE!O !I. Tratamiento 9irma Digitali7ada ......................................... 12
1". NE!O !II. Tratamiento (IN.............................................................. 1"



Ref SM!E!"CMA"004#

28/08/2014
$ersi%n& 22'

0i

(
a

)
r
o
)
i
e
d
a
d

i
n
*
e
+
e
c
*
,
a
+

d
e

e
s
*
e

d
o
c
,
-
e
n
*
o

)
e
r
*
e
n
e
c
e

a

R
e
d
s
y
s

.
,
e
d
a

)
r
o
h
i
/
i
d
a

s
,

r
e
)
r
o
d
,
c
c
i
%
n
,

0
e
n
*
a
,

o

c
e
s
i
%
n

a

*
e
r
c
e
r
o
s

1,. NE!O !III. Integracin /i&rer0a nativa C:: /inu; ........................... 1+
1#1 Re>,isi*os -Hni-os de ,so de +a +i/rerHa CPP (in,< 8'
1#2 6n*e7raci%n en*orno (in,< 8'
1#3 E5e-)+o de 6n*e7raci%n de (i/rerHa en (in,<& (i/rerHa din?-ica 20
1+. NE!O !I.. Integracin /i&rer0a <. ............................................... -2
1'1 Re>,isi*os -Hni-os de +a +i/rerHa =A$A 22
1'2 !esarro++o 22
1'3 E5ec,ci%n 22




28/08/2014
Versin: 2.27

1

1. Introduccin
Es*e doc,-en*o descri/e +a in*e7raci%n de a)+icaciones )ro)ie*arias
,sadas en co-ercios, con ;)0)c6-)+an*ado Para faci+i*ar +a in*e7raci%n
de +as dis*in*as a)+icaciones, se s,-inis*ra ,na +i/rerHa din?-ica M!((N
>,e es co-)a*i/+e con )r?c*ica-en*e e+ 100Q de +os en*ornos de
desarro++os ,*i+i1ados en sis*e-as o)era*i0os Microsof* @indoAs
(a +i/rerHa ),ede ,*i+i1arse en dos Modos&
%odo Inter5a7 de =suario > /atente, en es*e -odo, *oda
in*er0enci%n o -ensa5es >,e se de/an -os*rar a+ ;i*,+ar de +a
;ar5e*a, +o rea+i1ar? +a )ro)ia a)+icaci%n ;)0)c6-)+an*ado (a
a)+icaci%n de+ co-ercio, s%+o reci/ir? e+ <-+ con e+ res,+*ado de +a
o)eraci%n
%odo Transparente, +a a)+icaci%n de+ co-ercio ser? +a encar7a
de -os*rar *odos +os -ensa5es necesarios a+ co-ercio, +a
a)+icaci%n o +i/rerHa ;)0)c6-)+an*ado no -os*rar? nin7Rn
-ensa5e

(a a)+icaci%n ;)0)c6-)+an*ado c,ando se inicia en Modo (a*en*e, reci/e
+as )e*iciones ,*i+i1ando ,n ),er*o de co-,nicaci%n +oca+ MsocOe*N, con +o
>,e si e+ e>,i)o dis)one de An*i0ir,s o a+7Rn )ro7ra-a de con*ro+, se
de/er? )er-i*ir a +a a)+icaci%n ;)0)c6-)+an*ado, ac*,ar co-o ser0idor
Esta con5iguracin solo se ?a de tener en cuenta cuando se inicie
la li&rer0a en modo /atente.

Es*a +i/rerHa se ir? ac*,a+i1ando en f,nci%n de +os n,e0os re>,eri-ien*os
o f,nciona+idades Se en0iar?n no*ificaciones de es*as ac*,a+i1aciones a
+a direcci%n de correo e+ec*r%nica indicada en +a so+ici*,d de a+*a Si e+
sis*e-a de*ec*a >,e se es*? ,sando ,na 0ersi%n an*i7,a, *a-/iSn +o
infor-ar? con ,n ca-)o es)ecifico en +as res),es*as, en e+ Ane<o 66 se
indica es*a infor-aci%n

2. Destinatarios
Es*e doc,-en*o es*? des*inado a&
CEMERC6ES
E";6!A!ES




28/08/2014
Versin: 2.27

2

3. Integracin TpvpcImplantado
A con*in,aci%n se descri/en *odas +as f,nciones e<)or*adas )or +a
+i/rerHa y ,n e5e-)+o de acceso a es*as f,nciones en e+ +en7,a5e CL
"E;
An*es de )oder rea+i1ar c,a+>,ier o)eraci%n, es necesario inicia+i1ar +a
co-,nicaci%n con ;)0)c6-)+an*ado, )ara e++o e<is*en dos -odos&
1 %odo Transparente, +a a)+icaci%n de+ co-ercio se encar7ar? de
in*erac*,ar con e+ ,s,ario

2 %odo Inter5a7 de =suario, +a a)+icaci%n de+ co-ercio )asar?
+os da*os a +a a)+icaci%n ;)0)c6-)+an*ado, y es*a se encar7ar? de
in*erac*,ar con e+ ,s,ario

(a operacin de iniciali7acin6 slo se de&e reali7ar cada ve7 @ue
se inicie la aplicacin, ,na 0e1 inicia+i1ada, ya no es necesario rea+i1ar
es*e )roceso
En +as si7,ien*es CR(s se ),eden o/*ener +as R+*i-as 0ersiones de+
;)0)c6-)+an*ado, y +a +i/rerHa de in*e7raci%n, )ara a)+icaciones
)ro)ie*arias&
Entorno de 4ealA
h**)&//sis:dser-e)aes/;P$TPC/i-)+an*adoh*-+

Entorno de (rue&asA
h**)&//sas:dser-e)aes/;P$TPC/i-)+an*adoh*-+

%uB importante6 aclarar @ue la versin de li&rer0a del entorno de
prue&as slo es vClida para este entorno6 una ve7 reali7adas las
prue&as en el entorno de prue&as6 se de&e utili7ar B distri&uir en
el caso de @ue 5uese necesario6 la versin descargada desde la
=4/ indicada en DEntorno de 4ealE.




28/08/2014
Versin: 2.27

3

3.1 Iniciar Comunicacin en %odo Transparente
Par?-e*ros de en*rada/sa+ida&
cComercio, nR-ero de co-ercio Es*e da*o es faci+i*ado )or +a en*idad
cTerminal, nR-ero de *er-ina+ Es*e da*o es faci+i*ado )or +a en*idad
cClave9irma, c+a0e de fir-a de+ co-ercio Es*e da*o es faci+i*ado )or +a
en*idad
cCon5(uerto, )ar?-e*ro o)ciona+ >,e indica +a confi7,raci%n de
),er*o partir de la versin 1.2.4.2, es*e )ar?-e*ro no de/e
indicarse, se rec,)erar? +a confi7,raci%n es*a/+ecida en e+ ;P$PC
Para PinPad conec*ados a ),er*o serie&
CEMI),er*oJ&,12200,",8,1
Para PinPad conec*ados a ),er*o CS8, se define de)endiendo de+
-ode+o:
Mode+o i#280, se de/e ,*i+i1ar +a cadena CS8,281#,2321#,2,2
Mode+o i#330, se de/e ,*i+i1ar +a cadena CS8,281#,2323#,2,2
c.ersion, )ar?-e*ro o)ciona+ >,e indica +a 0ersi%n de )ro*oco+o a
,*i+i1ar partir de la versin 1.2.4.2, es*e )ar?-e*ro no de/e
indicarse, se rec,)erar? +a confi7,raci%n es*a/+ecida en e+ ;P$PC
$a+ores )osi/+es U30V, U31V, U40V, U41V o U42V Es*a 0ersi%n 0arHa
en f,nci%n de +a 0ersi%n de sof*Aare de+ -ode+o de )in)ad (a
0ersi%n ac*,a+ es +a 0ersi%n U41V

$a+or de0,e+*o&
0, se inici% correc*a-en*e +a a)+icaci%n
!is*in*o de 0, indica ,n error en +a o)eraci%n En e+ Ane<o 6, se
descri/en +os errores de0,e+*os )or *odas +as f,nciones

in* 5nDllIniTpvpc/atenteM(PC;S;R cComercio, (PC;S;R cTerminal,
(PC;S;R cClave9irma, (PC;S;R cCon5(uerto, (PC;S;R c.ersionNW

E5e-)+o de ++a-ada en CL "E;&

[DllImport("dllTpvpcLatente.dll")]
public static extern int fnDllIniTpvpcLatente(String
cComercio, String cTerminal, String cClaveFirma, String
cConfPuerto, String cVersion);




28/08/2014
Versin: 2.27

4

E5e-)+o de ++a-ada en $is,a+ 8asic "E;
Public Declare Function fnDllIniTpvpcLatente Lib
"dllTpvpcLatente.dll" (ByVal cComercio As String, ByVal
cTerminal As String, ByVal cClaveFirma As String, ByVal
cConfPuerto As String, ByVal cVersion As String) As Integer

3.2 Iniciar Comunicacin en %odo Inter5a7 de =suario
(arCmetros de entrada>salidaA

c=sr, no-/re o iden*ificador de ,s,ario Es*e da*o es faci+i*ado )or +a
en*idad
cClave, c+a0e de acceso de+ ,s,ario Es*e da*o es faci+i*ado )or +a
en*idad
c%odo, indica e+ -odo en e+ >,e se inicia+i1ar? +a a)+icaci%n
;)0)c6-)+an*ado

D1E 8F %odo Inter5a7 de =suario.

in* 5nDllIniTpvpc/atenteE;tM(PC;S;R c=sr, (PC;S;R cClave,
(PC;S;R c%odoNW


public static extern int fnDllIniTpvpcLatenteExt(String
cUsuario, String cClave, String cModo);


Public Declare Function fnDllIniTpvpcLatenteExt Lib
"dllTpvpcLatente.dll" (ByVal cUsuario As String, ByVal cClave
As String, ByVal cModo As String) As Integer




28/08/2014
Versin: 2.27

5

Cna 0e1 inicia+i1ada +a a)+icaci%n en c,a+>,iera de s,s -odos, ya se
),eden rea+i1ar c,a+>,iera de +as o)eraciones ofrecidas )or +a +i/rerHa
M,y i-)or*an*e, recordar >,e es*a f,nci%n s%+o es necesario ++a-ar+a +a
)ri-era 0e1 >,e se inicie +a a)+icaci%n, o c,ando se >,iera ca-/iar +os
da*os de co-ercio o ,s,ario

3.3 Detener la Comunicacin
"o *iene )ar?-e*ros de en*rada
F,er1a +a )arada de ;P$PC (a*en*e "o de0,e+0e errores

in* 5nDll(araTpvpc/atenteMNW


public static extern int fnDllParaTpvpcLatente();


Public Declare Function fnDllParaTpvpcLatente Lib
"dllTpvpcLatente.dll" () As Integer




28/08/2014
Versin: 2.27

6

3.4 4eali7ar un (ago o una (reautori7acin utili7ando un
dispositivo (in(ad

cImporte, i-)or*e de +a *ransacci%n en for-a*o 99999999999
E5e-)+o& 123, 3303, 001, e*c
c9actura, referencia de co-)ra Es*e 0a+or +o ),ede es)ecificar e+
co-ercio )ara ay,dar+e a iden*ificar +a *ransacci%n
cTipoOper, indica e+ *i)o de o)eraci%n a rea+i1ar $a+ores )osi/+es&
UPAXEV :J Se rea+i1ar? ,n Pa7o
UPREAC;ER6FAC6E"V :J Se rea+i1ar? ,na )rea,*ori1aci%n
UPAXET;=;TARCK6$EV :J Se rea+i1ar? ,n )a7o inicia+ con *ar5e*a en
archi0o S%+o )ara a>,e++os co-ercios >,e
*en7an con*ra*ado es*e ser0icio con s,
en*idad
c!%/4esp, /,ffer, >,e a+-acenar? ,na cadena 9M( con e+ res,+*ado de
+a o)eraci%n de )a7o o )rea,*ori1aci%n E+ for-a*o de es*e 9M( se
enc,en*ra de*a++ado en +a doc,-en*aci%n YCone<i%n con ;P$PC a *ra0Ss
de @E8 SER$6CEY 0ersi%n #0
iTam%a;4esp, indica e+ *a-a4o -?<i-o de+ /,ffer donde se
a+-acenar? +a cadena 9M( con e+ res,+*ado de +a o)eraci%n Se
reco-ienda a+ -enos ,n *a-a4o de 1024 /y*es

.alor de retornoA
.alor 2, indica >,e +a o)eraci%n se ha )rocesado correc*a-en*e
M,y i-)or*an*e resa+*ar >,e es*e res,+*ado "E 6"!6CA .CE (A
EPERAC6Z" ES;[ AC;ER6FA!A, *an s%+o es e+ res,+*ado de s,
)roceso
.alor distinto de 2, C%di7o de error indicando e+ -o*i0o de+ fa++o
En e+ Ane<o 666, se de*a++an es*os errores
Giempre @ue se devuelva el cdigo 826 es necesario reali7ar
una consulta de la Hltima operacin reali7ada por el comercio6
para ver si la operacin result autori7ada.

in* 5nDllOper(in(adM(PC;S;R cImporte, (PC;S;R c9actura,
(PC;S;R cTipoOper, (P;S;R c!%/4esp, in* iTam%a;4espNW




28/08/2014
Versin: 2.27

7


public static extern int fnDllOperPinPad(String cImporte,
String cFactura, String cTipoOper, StringBuilder cXMLResp,
int iTamMaxResp);


Public Declare Function fnDllOperPinPad Lib
"dllTpvpcLatente.dll" (ByVal cImporte As String, ByVal
cFActura As String, ByVal cTipoOper As String, ByVal cXMLResp
As String, ByVal iTamMaxREsp As Integer) As Integer

3." 4eali7ar un (ago o (reautori7acin introduciendo
manualmente los datos de la tar3eta
!e)endiendo de+ Modo e+e7ido, se dis)one de dos -S*odos dis*in*os Si
se e+i7i% e+ Modo ;rans)aren*e, +a a)+icaci%n de+ co-ercio de/er?
so+ici*ar y 0a+idar +os da*os de +a *ar5e*a

%odo TransparenteA
Par?-e*ros de en*rada/sa+ida&

cTar3eta, nR-ero de *ar5e*a (as *ar5e*as *ienen ,na +on7i*,d en*re 13 y
12 carac*eres Ca-)o E)ciona+ en Modo Cs,ario, si no se )asa +o )edir?
e+ ;)0)c6-)+an*ado
cCaducidad, cadena con +a cad,cidad de +a *ar5e*a E+ for-a*o es
AAMM E5e-)+o 0#/13, e+ for-a*o serHa 132, Ca-)o E)ciona+ en Modo
Cs,ario, si no se )asa +o )edir? e+ ;)0)c6-)+an*ado
cC.C2, cadena con e+ 0a+or de C$C2 C%di7o de *res dH7i*os de
se7,ridad >,e 0iene i-)reso 7enera+-en*e en e+ re0erso de +a *ar5e*a, y
>,e ser? necesario de)endiendo de +a ac*i0idad de+ co-ercio Ca-)o
E)ciona+ en Modo Cs,ario, si no se )asa +o )edir? e+ ;)0)c6-)+an*ado
E5e-)+o& 123, 3303, 001, e*c
co-ercio )ara ay,dar+e a iden*ificar +a *ransacci%n




28/08/2014
Versin: 2.27

8

cTipoOper, indica e+ *i)o de o)eraci%n a rea+i1ar $a+ores )osi/+es&
UPAXEV :J Se rea+i1ar? ,n Pa7o
UPREAC;ER6FAC6E"V :J Se rea+i1ar? ,na )rea,*ori1aci%n
UPAXET;=;TARCK6$EV :J Se rea+i1ar? ,n )a7o inicia+ con *ar5e*a en
archi0o S%+o )ara a>,e++os co-ercios >,e
*en7an con*ra*ado es*e ser0icio con s,
en*idad
c!%/4esp, /,ffer >,e a+-acenar? ,na cadena 9M( con e+ res,+*ado de
+a o)eraci%n de )a7o o )rea,*ori1aci%n E+ for-a*o de es*e 9M( se
enc,en*ra de*a++ado en +a doc,-en*aci%n YCone<i%n con ;P$PC a *ra0Ss
de @E8 SER$6CEY 0ersi%n #0
a+-acenar? +a cadena <-+ con e+ res,+*ado de +a o)eraci%n Se

$a+or de re*orno&
M,y i-)or*an*e indicar >,e este resultado NO INDIC I=E /
O(E4CIJN EGTK =TO4ILD, *an s%+o es e+ res,+*ado de s,
)roceso
Giempre @ue se devuelva el cdigo 826 es necesario reali7ar
una consulta de la Hltima operacin reali7ada por el comercio6
para ver si la operacin result autori7ada.

in* 5nDllOper%anualE;tM(PC;S;R cTar3eta, (PC;S;R cCaducidad,
(PC;S;R cC.C2, (PC;S;R cImporte, (PC;S;R c9actura, (PC;S;R
cTipoOper, (P;S;R c!%/4esp, in* iTam%a;4espNW


public static extern int fnDllOperManualExt(String cTarjeta,
String cCaducidad, String cCVC2, String cImporte, String
cFactura, String cTipoOper, StringBuilder cXMLResp, int
iTamMaxResp);





28/08/2014
Versin: 2.27

9

Public Declare Function fnDllOperManualExt Lib
"dllTpvpcLatente.dll" (ByVal cTarjeta As String, ByVal
cCaducidad As String, ByVal cCVC2 As String, ByVal cImporte
As String, ByVal cFActura As String, ByVal cTipoOper As
String, ByVal cXMLResp As String, ByVal iTamMaxREsp As
Integer) As Integer

%odo Inter5a7 de =suarioA

Es*a f,nci%n reci/e +os -is-os )ar?-e*ros de en*rada >,e +a f,nci%n
5nDllOper(in(ad

in* 5nDllOper%anualM(PC;S;R cImporte, (PC;S;R c9actura,
(PC;S;R cTipoOper, (P;S;R c!%/4esp, in* iTam%a;4espNW


public static extern int fnDllOperManual(String cImporte,
String cFactura, String cTipoOper, StringBuilder cXMLResp,
int iTamMaxResp);


Public Declare Function fnDllOperManual Lib
cFActura As String, ByVal cTipoOper As String, ByVal cXMLResp




28/08/2014
Versin: 2.27

10

3., MCmo validar si la operacin result =TO4ILDN
En +a cadena con e+ res,+*ado de o)eraci%n, sie-)re de/en a)arecer +os
si7,ien*es e+e-en*os con e+ 0a+or >,e se indica a con*in,aci%n&
OestadoF9O>estadoF
OresultadoFutori7adaO>resultadoF

Si +a res),es*a no con*iene es*os 0a+ores, de/e *o-arse co-o ,na
*ransacci%n !E"EXA!A
E5e-)+o de cadena con e+ res,+*ado de +a o)eraci%n de PAXE o
PREAC;ER6FAC6E"&

<Operaciones version="6.0">
<resultadoOperacion>
<tipoPago>PAGO</tipoPago>
<importe>1.01</importe>
<moneda>978</moneda>
<tarjetaComercioRecibo>************0018</tarjetaComercioRecibo>
<tarjetaClienteRecibo>************0018</tarjetaClienteRecibo>
<marcaTarjeta>2</marcaTarjeta>
<caducidad>1210</caducidad>
<comercio>777888991</comercio>
<terminal>1</terminal>
<pedido>10549</pedido>
<tipoTasaAplicada>DEB</tipoTasaAplicada>
<identificadorRTS>070001070319153828378272</identificadorRTS>
<factura>FAC-LATENTE</factura>
<fechaOperacion>2007-03-19 15:38:28.484</fechaOperacion>
<estado>F</estado>
<resultado>Autorizada</resultado>
<codigoRespuesta>080922</codigoRespuesta>
<Literales>
<literal>NO REFUND</literal>
</Literales>
<firma>664AD45F54C3EB4D06A354E3158A17966012A1B8</firma>
<operacionemv>true</operacionemv>
<conttrans>001391</conttrans>
<sectarjeta>00</sectarjeta>
<idapp>A0000000043060</idapp>
<codrespauto>00</codrespauto>
<resverificacion>0800208000</resverificacion>
</resultadoOperacion>
</Operaciones>

Co-o se ),ede o/ser0ar en e+ e5e-)+o, +a *ransacci%n res,+*%
=TO4ILD, ya >,e a)arecen +os ca-)os estado con 0a+or 9, y
resultado con e+ +i*era+ utori7ada C,a+>,ier o*ro 0a+or, de/e *o-arse
co-o ,na *ransacci%n !ene7ada




28/08/2014
Versin: 2.27

11

3.+ 4eali7ar una operacin de Con5irmacin o Devolucin
Cna confir-aci%n se rea+i1a sie-)re so/re o)eraciones de
)rea,*ori1aci%n rea+i1adas con an*erioridad
Cna de0o+,ci%n, co-o s, )ro)io no-/re indica, rea+i1a e+ a/ono o
de0o+,ci%n de+ i-)or*e indicado, a +a *ar5e*a con +a >,e se rea+i1% +a
o)eraci%n ori7ina+

(arCmetros de EntradaA

cNum(edido, nR-ero de )edido de +a o)eraci%n ori7ina+ E+ ca-)o
)edido se enc,en*ra en *odas +as res),es*as de )e*iciones de
o)eraciones rea+i1adas a+ ;P$PC .alor o&ligatorio en %odo
Transparente.
c4TGOriginal, iden*ificador R;S de +a *ransacci%n ori7ina+ E+ ca-)o
iden*ificadorR;S se enc,en*ra en *odas +as res),es*as de )e*iciones de
o)eraciones rea+i1adas a+ ;P$PC $a+or E)ciona+, en c,a+>,iera de +os
-odos En -odo ;rans)aren*e se reco-ienda s, ,so
cImporte, i-)or*e >,e se >,iere de0o+0er o confir-ar, en for-a*o
99999999999 E5e-)+o& 123, 3303, 001, e*c .alor o&ligatorio en
%odo Transparente.
c9actura, ca-)o s,-inis*rado )or e+ co-ercio, )ara asociar ,na
descri)ci%n o 0a+or a +a o)eraci%n Es*e 0a+or es 7enerado )or e+
co-ercio y e+ ;P$PC no rea+i1ar? nin7,na 0a+idaci%n so/re e+ -is-o
cTipoOper, indica e+ *i)o de o)eraci%n a rea+i1ar P,ede *o-ar dos
)osi/+es 0a+ores&
CON9I4%CION, rea+i1ar? ,na confir-aci%n so/re ,na
PREAC;ER6FAC6Z" >,e se a,*ori1% con an*erioridad
DE.O/=CION, rea+i1ar? ,na de0o+,ci%n de ,na o)eraci%n >,e se
a,*ori1% con an*erioridad
.alor o&ligatorio en %odo Transparente.

+a o)eraci%n de DE.O/=CION o CON9I4%CION E+ for-a*o de es*e
9M( se enc,en*ra de*a++ado en +a doc,-en*aci%n YCone<i%n con ;P$PC a
*ra0Ss de @E8 SER$6CEY 0ersi%n #0





28/08/2014
Versin: 2.27

12

.alor de retornoA
M,y i-)or*an*e indicar >,e es*e res,+*ado "E 6"!6CA .CE (A
EPERAC6Z" ES;\ AC;ER6FA!A, *an s%+o es e+ res,+*ado de s,
)roceso

in* 5nDllOperComConta&leM(PC;S;R cNum(edido, (PC;S;R
c4TGOriginal, (PC;S;R cImporte, (PC;S;R c9actura, (PC;S;R
cTipoOper, (P;S;R c!%/4esp, in* iTam%a;4espNW


public static extern int fnDllOperComContable(String
cNumPedido, String cRTSOriginal, String cImporte, String
iTamMaxResp);


Public Declare Function fnDllOperComContable Lib
"dllTpvpcLatente.dll" (ByVal cNumPedido As String, ByVal
cRTSOriginal As String, ByVal cImporte As String, ByVal
cFactura As String, ByVal cTipoOper As String, ByVal cXMLResp




28/08/2014
Versin: 2.27

13

3.1 MCmo reali7ar una Devolucin>Con5irmacin desde
otro terminalN
C,ando se >,iere rea+i1ar ,na de0o+,ci%n Mo confir-aci%nN desde ,n
;er-ina+ dis*in*o a+ >,e rea+i1% +a o)eraci%n ori7ina+, e<is*en dos
o)ciones&

1]N !e0o+,ci%n/Confir-aci%n a )ar*ir de+ nR-ero de )edido de +a
o)eraci%n ori7ina+
C,ando s%+o se dis)one de+ nR-ero de )edido )ara iden*ificar +a
o)eraci%n ori7ina+, es necesario es)ecificar e+ ;er-ina+ )or e+ >,e se
rea+i1% dicha o)eraci%n Se enc,en*ra dis)oni/+e +a si7,ien*e f,nci%n&

in* 5nDllOperComConta&leTerminalM(PC;S;R cNumTerminal,
(PC;S;R cNum(edido, (PC;S;R c4TGOriginal, (PC;S;R
cImporte, (PC;S;R c9actura, (PC;S;R cTipoOper, (P;S;R
c!%/4esp, in* iTam%a;4espNW


public static extern int
fnDllOperComContableTerminal(String cNumTerminal, String
cNumPedido, String cRTSOriginal, String cImporte, String
iTamMaxResp);

Public Declare Function fnDllOperComContableTerminal Lib
"dllTpvpcLatente.dll" (ByVal cNumTerminal As String, ByVal
cNumPedido As String, ByVal cRTSOriginal As String, ByVal
cImporte As String, ByVal cFactura As String, ByVal
cTipoOper As String, ByVal cXMLResp As String, ByVal
iTamMaxREsp As Integer) As Integer

2]N !e0o+,ci%n/Confir-aci%n a )ar*ir de+ iden*ificador R;S de +a
*ransacci%n ori7ina+
C,ando se dis)one de+ iden*ificador de o)eraci%n idR;S, /as*a con
rea+i1ar +a ++a-ada a +a f,nci%n 5nDllOperComConta&le co-o si
f,ese desde e+ ;er-ina+ ori7ina+, )ero ,na 0e1 inicia+i1ado con ,n
;er-ina+ diferen*e




28/08/2014
Versin: 2.27

14

Nota& es*a o)era*i0a no f,ncionar? si e+ *)0 *iene asi7nado ,n c%di7o
de co-ercio dis*in*o a+ de +a o)eraci%n ori7ina+

3.- 4eali7ar una operacin de Devolucin con lectura
desde el (inpad
Cna de0o+,ci%n, co-o s, )ro)io no-/re indica, rea+i1a e+ a/ono o
de0o+,ci%n de+ i-)or*e indicado, a +a *ar5e*a con +a >,e se rea+i1% +a
o)eraci%n ori7ina+ Para -ayor se7,ridad, se ),ede o/+i7ar a )asar +a
*ar5e*a ori7ina+ con +a >,e se hi1o e+ )a7o, de for-a >,e e+ c+ien*e es*S
)resen*e
Es i-)or*an*e se4a+ar >,e es*e *i)o de de0o+,ci%n no es*? so)or*ada en
@indoAs Mo/i+e


cImporte, i-)or*e >,e se >,iere de0o+0er, en for-a*o 99999999999
E5e-)+o& 123, 3303, 001, e*c .alor o&ligatorio en %odo
Transparente.
Transparente.
o)eraciones rea+i1adas a+ ;P$PC $a+or E)ciona+, en c,a+>,iera de +os
-odos En -odo ;rans)aren*e se reco-ienda s, ,so
c!%/4esp, /,ffer, >,e a+-acenar? ,na cadena 9M( con e+ res,+*ado de
+a o)eraci%n de DE.O/=CION E+ for-a*o de es*e 9M( se enc,en*ra
de*a++ado en +a doc,-en*aci%n YCone<i%n con ;P$PC a *ra0Ss de @E8
SER$6CEY 0ersion #0




28/08/2014
Versin: 2.27

15

.alor de retornoA
)roceso

in* 5nDllComConta&leTr3M(PC;S;R cImporte, (PC;S;R c9actura,
(PC;S;R cNum(edido, (PC;S;R c4TGOriginal, (P;S;R c!%/4esp,
in* iTam%a;4espNW


public static extern int fnDllComContableTrj(String cImporte,
String cFactura, String cNumPedido, String cRTSOriginal,
StringBuilder cXMLResp, int iTamMaxResp);


Public Declare Function fnDllComContableTrj Lib
cFactura As String, ByVal cNumPedido As String, ByVal
cRTSOriginal As String, ByVal cXMLResp As String, ByVal




28/08/2014
Versin: 2.27

16

3.12 MCmo validar si la operacin result =TO4ILDN
En +a cadena con e+ res,+*ado de o)eraci%n, sie-)re de/en a)arecer +os
OestadoF9O>estadoF

E5e-)+o de cadena con e+ res,+*ado de +a o)eraci%n de !E$E(CC6E" o
CE"F6RMAC6E"&

<comunicacionContable tipo="DEVOLUCION">
<resultadoComunicacion>
<factura>FAC_384572</factura>
<pedidoBase>10549</pedidoBase>
<fechaOperacion>2007-03-19 16:41:16</fechaOperacion>
<estado>F</estado>
<firma>DBBCA72FC4A5FEBB76E3260789DDCF51A3903D4F</firma>
</resultadoComunicacion>
</comunicacionContable>
</Operaciones>

En e+ e5e-)+o descri*o +a o)eraci%n ha res,+*ado a,*ori1ada

3.11 4eali7ar una operacin de Devolucin sin Original
Para rea+i1ar es*e *i)o de o)eraci%n, e+ co-ercio de/e *ener )re0ia-en*e
ha/i+i*ada +a o)era*i0a Es*as de0o+,ciones rea+i1an e+ a/ono de+ i-)or*e
es)ecificado en +a *ar5e*a +eHda desde e+ Pin)ad Co-o s, no-/re indica,
es*a o)eraci%n no 0a+ida con*ra nin7,na o)eraci%n rea+i1ada con
an*erioridad

(arCmetros de entradaA




28/08/2014
Versin: 2.27

17

%odo Transparente.
+a o)eraci%n de DE.O/=CION

.alor de retornoA
)roceso

in* 5nDllDevGinOrigTr3 M(PC;S;R cImporte, (PC;S;R c9actura,
(P;S;R c!%/4esp, in* iTam%a;4espN


public static extern int fnDllDevSinOrigTrj(String cImporte,
String cFactura, StringBuilder cXMLResp, int iTamMaxResp);

E5e-)+o de ++a-ada en $is,a+ 8asic "E;&

Public Declare Function 5nDllDevGinOrigTr3 Lib
cFactura As String, ByVal cXMLResp As String, ByVal




28/08/2014
Versin: 2.27

18

3.12 4eali7ar una operacin de Devolucin sin Original
introduciendo manualmente los datos de la tar3eta
Para rea+i1ar es*e *i)o de o)eraci%n, e+ co-ercio de/e *ener )re0ia-en*e
ha/i+i*ada +a o)era*i0a Es*as de0o+,ciones rea+i1an e+ a/ono de+ i-)or*e
es)ecificado en +a *ar5e*a indicada Co-o s, no-/re indica, es*a
o)eraci%n no 0a+ida con*ra nin7,na o)eraci%n rea+i1ada con an*erioridad


cTar3eta, nR-ero de *ar5e*a (as *ar5e*as *ienen ,na +on7i*,d en*re 13 y
12 carac*eres Ca-)o E)ciona+ si es*? *ra/a5ando en Modo 6n*erfa1 de
Cs,ario, en es*e -odo +o so+ici*ar? +a a)+icaci%n ;)0)c6-)+an*ado
cCaducidad, cadena con +a cad,cidad de +a *ar5e*a E+ for-a*o es
AAMM E5e-)+o 0#/13, e+ for-a*o serHa 132, Ca-)o E)ciona+ si es*?
*ra/a5ando en Modo 6n*erfa1 de Cs,ario, en es*e -odo +o so+ici*ar? +a
a)+icaci%n ;)0)c6-)+an*ado
%odo Transparente.
+a o)eraci%n de DE.O/=CION

.alor de retornoA
)roceso

in* 5nDllOperDevGinOrigM(PC;S;R cTar3eta, (PC;S;R cCaducidad,
(PC;S;R cImporte, (PC;S;R c9actura, (P;S;R c!%/4esp, in*
iTam%a;4espN




28/08/2014
Versin: 2.27

19


public static extern int fnDllOperDevSinOrig(String cTarjeta,
String cCaducidad, String cImporte, String cFactura,

E5e-)+o de ++a-ada en $is,a+ 8asic "E; &

Public Declare Function 5nDllOperDevGinOrig Lib
"dllTpvpcLatente.dll" (ByVal cTarjeta As String, ByVal
cCaducidad As String, ByVal cImporte As String, ByVal
cFactura As String, ByVal cXMLResp As String, ByVal

3.13 MCmo validar si la operacin result =TO4ILDN
En +a cadena con e+ res,+*ado de o)eraci%n sie-)re de/en a)arecer +os
OestadoF9O>estadoF





28/08/2014
Versin: 2.27

20

E5e-)+o de cadena con e+ res,+*ado de +a o)eraci%n de !E$E(CC6E"
S6" ER6X6"A(&
<fechaOperacion>2007-04-13 14:05:53</fechaOperacion>
<estado>F</estado>
<firma>09BCDC2AB6B9178D3F3ADF7EBEC879BE9F631D80</firma>
</Operaciones>

En es*e e5e-)+o +a o)eraci%n ha res,+*ado a,*ori1ada

3.14 4eali7ar consultas de Operaciones
Es*a o)era*i0a )er-i*e rea+i1ar cons,+*as de o)eraciones so/re e+
co-ercio:*er-ina+ en +a f,nci%n de 6nicia+i1aci%n (os 9M( de res),es*a
se descri/en con de*a++e en e+ doc,-en*o ;P$PC @S Cons,+*as En es*e
doc,-en*o se -os*rar?n a+7,nos 9M( de e5e-)+o, )ero no se en*rar? en
de*a++e en +a e<)+icaci%n de s,s ca-)os


cNum(edido, nR-ero de )edido de +a o)eraci%n a rec,)erar Se ),ede
es)ecificar ,n 0a+or "C(( si no se desea rea+i1ar /Rs>,edas )or es*e
ca-)o
c4TG, iden*ificador de *ransacci%n, s%+o se de0o+0er?n +os da*os de +a
o)eraci%n so+ici*ada Se ),ede es)ecificar ,n 0a+or "C((, si no se desea
rea+i1ar /Rs>,edas )or es*e ca-)o Si se indica es*e ca-)o, se
i7norar? e+ res*o de +os ca-)os es)ecificados
c9actura, ca-)o de fac*,ra o referencia >,e ),ede es)ecificar e+
co-ercio en +as o)eraciones rea+i1adas en e+ ;P$PC, o "C((, si no se
desea rea+i1ar /Rs>,edas )or es*e ca-)o
c9ec?aIni, fecha de inicio de o)eraci%n E+ for-a*o de/e ser e+
si7,ien*e& BBBBMMdd KK--ss, 200'0413 1'2203 Se ),ede es)ecificar
,n 0a+or "C((, si no se desea rea+i1ar /Rs>,edas )or es*e ca-)o




28/08/2014
Versin: 2.27

21

c9ec?a9in, fecha de fin de o)eraci%n E+ for-a*o de/e ser e+ si7,ien*e&
BBBBMMdd KK--ss, 200'0413 182203 Se ),ede es)ecificar ,n 0a+or
"C((, si no se desea rea+i1ar /Rs>,edas )or es*e ca-)o
cTipo, *i)o de E)eraci%n Se ),eden indicar +os si7,ien*es 0a+ores&
:J PAXE
:J PREAC;ER6FAC6E"
:J CE"F6RMAC6E"
:J !E$E(CC6E"
Se ),ede es)ecificar ,n 0a+or "C((, si no se desea rea+i1ar
/Rs>,edas )or es*e ca-)o
c4esultado, res,+*ado de +a o)eraci%n Se )odr? cons,+*ar +as
o)eraciones A,*ori1adas o !ene7adas Se ),eden indicar +os si7,ien*es
0a+ores&
:J AC;ER6FA!A, rec,)era s%+o +as o)eraciones a,*ori1adas
:J !E"EXA!A, rec,)era s%+o +as o)eraciones dene7adas
Se ),ede es)ecificar ,n 0a+or "C((, si no se desea rea+i1ar
/Rs>,edas )or es*e ca-)o
cNum(agina, indica e+ nR-ero de )?7ina a rec,)erar E+ @e/Ser0ice
rea+i1a ,na )a7inaci%n de cons,+*a, a>,H se indica, en caso de de0o+0er
0arias )?7inas, e+ nR-ero de )?7ina a rec,)erar Si se >,iere rec,)erar
+a )ri-era )?7ina, se de/e indicar e+ nR-ero 0
c!%/4esp, /,ffer >,e a+-acenar? +a cadena con e+ 9M( de res),es*a
reci/ido desde e+ ;P$PC E+ 9M( se descri/e en de*a++e en e+ doc,-en*o
;P$PC @S Cons,+*as 2d1
iTam%a;4esp, *a-a4o -?<i-o de +a cadena >,e ),ede a+-acenar e+
/,ffer c9M(Res)

.alor de retornoA
P 2, +a o)eraci%n se )roces% correc*a-en*e Es*e res,+*ado no indica
>,e se haya a,*ori1ado o dene7ado, si-)+e-en*e >,e +a )e*ici%n se
ha rea+i1ado con S<i*o Para 0er e+ res,+*ado de +a o)eraci%n se de/e
ana+i1ar +a res),es*a reci/ida en c9M(Res)
QP 2, C%di7o de error indicando e+ -o*i0o de+ fa++o !escri)ci%n de +os
)osi/+es c%di7os de error&
:1 "o se han es*a/+ecido correc*a-en*e +os da*os de
confi7,raci%n Es necesario 0o+0er a ++a-ar a +a f,nci%n
fn!++6ni;)0)c(a*en*e Si e+ )ro/+e-a )ersis*e con*ac*ar con +a
en*idad




28/08/2014
Versin: 2.27

22

:2 Se )rod,5o ,n error in*erno de+ sis*e-a a+ rea+i1ar +a
o)eraci%n Si e+ )ro/+e-a )ersis*e con*ac*e con s, en*idad
:3 Error en +os )ar?-e*ros de en*rada Si e+ )ro/+e-a )ersis*e
con*ac*ar con +a en*idad

in* 5nDllOperConsultaM(PC;S;R cNum(edido, (PC;S;R c4TG,
(PC;S;R c9actura, (PC;S;R c9ec?aIni, (PC;S;R c9ec?a9in,
(PC;S;R cTipo, (PC;S;R c4esultado, (PC;S;R cNum(agina, (P;S;R
c!%/4esp, in* iTam%a;4espNW


public static extern int fnDllOperConsulta(String cNumPedido,
String cRTS, String cFactura, String cFechaIni, String
cFechaFin, String cTipo, String cResultado, String
cNumPagina, StringBuilder cXMLResp, int iTamMaxResp);


Public Declare Function fnDllOperConsulta Lib
"dllTpvpcLatente.dll" (ByVal cNumPedido As String, ByVal cRTS
As String, ByVal cFactura As String, ByVal cFechaIni As
String, ByVal cFechaFin As String, ByVal cTipo As String,
ByVal cResultado As String, ByVal cNumPagina As String, ByVal
cXMLResp As String, ByVal iTamMaxREsp As Integer) As Integer

E5e-)+o de res),es*a&

<consultas version="2.1">
<resultadoConsulta>
<operacion>
<tipoOper>Autorizacion</tipoOper>
<tarjeta>************5532</tarjeta>
<factura>IDOPER_PINPAD</factura>
<estado>F</estado>
<resultado>AUTORIZADA</resultado>




28/08/2014
Versin: 2.27

23

</operacion>
<operacion>
<estado>F</estado>
</operacion>
<numoperaciones>2</numoperaciones>
<numpagina>1</numpagina>
<totalpaginas>1</totalpaginas>
<timestamp>20070423 125118</timestamp>
<firma>8E7C43989E4586F3CA3ED781EF3CB2E1270C0075</firma>
</resultadoConsulta>
</consultas>

3.1" 4eali7ar Consulta de Totales
Es*a o)era*i0a de0,e+0e e+ *o*a+ de o)eraciones rea+i1adas )or e+
co-ercio/*er-ina+ en +a fecha indicada


c9ec?a, fecha de+ dHa )ara rec,)erar +os *o*a+es Si no se es)ecifica, se
,*i+i1ar? e+ dHa ac*,a+
cDesglose.%, YSY indica >,e se rea+ice ,n des7+ose )or -arca de
;ar5e*a $isa / Mas*er
cDesglose%arcas, YSY indica >,e se rea+ice ,n des7+ose )or Marcas de
;ar5e*a

.alor de retornoA
P 2, +a o)eraci%n se )roces% correc*a-en*e Es*e res,+*ado no indica
>,e se haya a,*ori1ado o dene7ado, si-)+e-en*e >,e +a )e*ici%n se
ha rea+i1ado con S<i*o Para 0er e+ res,+*ado de +a o)eraci%n se de/e
ana+i1ar +a res),es*a reci/ida en c9M(Res)
QP 2, C%di7o de error indicando e+ -o*i0o de+ fa++o !escri)ci%n de +os




28/08/2014
Versin: 2.27

24

:1 "o se han es*a/+ecido correc*a-en*e +os da*os de confi7,raci%n
Es necesario 0o+0er a ++a-ar a +a f,nci%n 5nDllIniTpvpc/atente Si e+
)ro/+e-a )ersis*e con*ac*ar con +a en*idad
:2 Se )rod,5o ,n error in*erno de+ sis*e-a a+ rea+i1ar +a o)eraci%n Si
e+ )ro/+e-a )ersis*e con*ac*e con s, en*idad
:3 Error en +os )ar?-e*ros de en*rada

in* 5nDllOperTotalesM(PC;S;R c9ec?a, (P;S;R cDesglose.%,
(P;S;R cDesglose%arcas, (P;S;R c!%/4esp, in* iTam%a;4espN


public static extern int fnDllOperTotales(String cFecha,
String cDesgloseVM, String cDesgloseMarcas, StringBuilder
cXMLResp, int iTamMaxResp)


Public Declare Function fnDllOperTotales Lib
"dllTpvpcLatente.dll" (ByVal cFecha As String, ByVal
cDesgloseVM As String, ByVal cDesgloseMarcas As String, ByVal

E5e-)+o de Res),es*a&

<resultadoConsultaTotales>
<Totales>
<fecha>2007-04-23</fecha>
<formato_moneda>#.##0,00</formato_moneda>
<Autorizaciones>
<autorizadas>0</autorizadas>
<denegadas>0</denegadas>
<importe_autorizadas>0.0</importe_autorizadas>
</Autorizaciones>
<Devoluciones>
</Devoluciones>
<PreAutorizaciones>




28/08/2014
Versin: 2.27

25

</PreAutorizaciones>
<Confirmaciones>
</Confirmaciones>
<total_neto>0.00</total_neto>
</Totales>
<firma>D8C17407BFB547749864A68250B611F41377C502</firma>
</resultadoConsultaTotales>
</consultas>

3.1, 4eali7ar Operacin DCC
Rea+i1a ,na o)eraci%n de Pa7o o Prea,*ori1aci%n ,*i+i1ando +a o)ci%n
Pa7o en !i0isas o !CC M!ina-yc C,rrency Con0ersionN Es*e -S*odo
s%+o es ++a-ado con +os da*os de res),es*a o/*enidos en +a ++a-ada a +a
f,nci%n fn!++E)erPinPad


E5e-)+o& 123, 3303, 001, e*c Mis-o 0a+or >,e e+ >,e se ,*i+i1% en
5nDllOper(in(ad
co-ercio Mis-o 0a+or >,e e+ >,e se ,*i+i1% en fn!++E)erPinPad
cTipoOper, o)eraci%n Pa7o o Prea,*ori1aci%n Mis-o 0a+or >,e e+ >,e
se ,*i+i1% en fn!++E)erPinPad
cCodDivisa, c%di7o de di0isa en e+ >,e se desea rea+i1ar +a *ransacci%n
Se de/e es)ecificar e+ c%di7o de +a -oneda >,e ha se+eccionado e+
;i*,+ar, es decir, e+ 0a+or de+ ca-)o codigoDivisa, si e+ *i*,+ar
se+eccion% )a7ar en s, -oneda, o e+ ca-)o monedaOriginal
c!%/4esp, !e0,e+0e ,n 9M( de Res),es*a con e+ res,+*ado de +a
o)eraci%n de )a7o o )rea,*ori1aci%n (a +i/rerHa 0a+idar? >,e +a fir-a
reci/ida es correc*a E+ for-a*o de es*e 9M( se enc,en*ra de*a++ado en
+a doc,-en*aci%n YCone<i%n con ;P$PC a *ra0Ss de @E8 SER$6CEY
0ersi%n #0
iTam%a;4esp, indica e+ *a-a4o -?<i-o de+ /,ffer de res),es*a Se

.alor de retornoA




28/08/2014
Versin: 2.27

26

En caso de >,e +a o)eraci%n se en0iase correc*a-en*e +a f,nci%n
de0o+0er? 0 Si e+ ;P$PC de0,e+0e ,n 9M( con ,n c%di7o de error, +a
f,nci%n *a-/iSn de0o+0er? 0, ya >,e es*e c%di7o s%+o indica si se
),do en0iar correc*a-en*e +a )e*ici%n
^ 0, )e*ici%n rea+i1ada correc*a-en*e Es necesario re0isar e+
9M( con +a res),es*a de +a *ransacci%n
_^ 0, C%di7o de error indicando e+ -o*i0o de+ fa++o
!escri)ci%n de +os )osi/+es c%di7os de error&
fn!++6ni;)0)c(a*en*e Si e+ )ro/+e-a )ersis*e con*ac*ar
con +a en*idad
:2 Se ha so/re)asado e+ ;i-eE,* es)ecificado )or +a
a)+icaci%n
:3 Error de+ Sis*e-a Es necesario reiniciar a)+icaci%n
:4 (os da*os de en*rada no *ienen ,n for-a*o correc*o
Re0isar +is*a de )ar?-e*ros

in* 5nDllOper(in(adDCCM(PC;S;R cImporte, (PC;S;R c9actura,
(PC;S;R cTipoOper, (PC;S;R cCodDivisa, (P;S;R c!ml4esp, in*
iTam%a;4espNW


public static extern int fnDllOperPinPadDCC(String cImporte,
String cFactura, String cTipoOper, String cCodDivisa,


Public Declare Function fnDllOperPinPadDCC Lib
cFActura As String, ByVal cTipoOper As String, ByVal
cCodDivisa As String, ByVal cXMLResp As String, ByVal




28/08/2014
Versin: 2.27

27

3.1+ 4eali7ar Operacin DCC con Entrada %anual de Datos
Rea+i1a ,na o)eraci%n de Pa7o o Prea,*ori1aci%n ,*i+i1ando +a o)ci%n
Pa7o en !i0isas o !CC M!ina-yc C,rrency Con0ersionN Es*e -S*odo
s%+o es ++a-ado con +os da*os de res),es*a o/*enidos en +a ++a-ada a +a
f,nci%n 5nDllOper%anualE;t


cCodDivisa, c%di7o de di0isa en e+ >,e se desea rea+i1ar +a *ransacci%n
Se de/e es)ecificar e+ c%di7o de +a -oneda >,e ha se+eccionado e+
;i*,+ar, es decir, e+ 0a+or de+ ca-)o codi7o!i0isa, si e+ *i*,+ar se+eccion%
)a7ar en s, -oneda, o e+ ca-)o -onedaEri7ina+
c!%/4esp, !e0,e+0e ,n 9M( de Res),es*a con e+ res,+*ado de +a
o)eraci%n de )a7o o )rea,*ori1aci%n (a +i/rerHa 0a+idar? >,e +a fir-a
reci/ida es correc*a E+ for-a*o de es*e 9M( se enc,en*ra de*a++ado en
+a doc,-en*aci%n YCone<i%n con ;P$PC a *ra0Ss de @E8 SER$6CEY
0ersi%n #0
iTam%a;4esp, indica e+ *a-a4o -?<i-o de+ /,ffer de res),es*a Se

.alor de retornoA
En caso de >,e +a o)eraci%n se en0iase correc*a-en*e +a f,nci%n
de0o+0er? 0 Si e+ ;P$PC de0,e+0e ,n 9M( con ,n c%di7o de error, +a
f,nci%n *a-/iSn de0o+0er? 0, ya >,e es*e c%di7o s%+o indica si se ),do
en0iar correc*a-en*e +a )e*ici%n
^ 0, )e*ici%n rea+i1ada correc*a-en*e Es necesario re0isar e+ 9M(
con +a res),es*a de +a *ransacci%n
_^ 0, C%di7o de error indicando e+ -o*i0o de+ fa++o !escri)ci%n de +os
fn!++6ni;)0)c(a*en*e Si e+ )ro/+e-a )ersis*e con*ac*ar con +a
en*idad
:2 Se ha so/re)asado e+ ;i-eE,* es)ecificado )or +a
a)+icaci%n
:3 Error de+ Sis*e-a Es necesario reiniciar a)+icaci%n
:4 (os da*os de en*rada no *ienen ,n for-a*o correc*o
Re0isar +is*a de )ar?-e*ros




28/08/2014
Versin: 2.27

28

in* 5nDllOper%anualDCCM(PC;S;R cCodDivisa, (P;S;R c!%/4esp,
in* iTam%a;4espNW


public static extern int fnDllOperManualDCC(String
cCodDivisa, StringBuilder cXMLResp, int iTamMaxResp);


Public Declare Function fnDllOperManualDCC Lib
"dllTpvpcLatente.dll" (ByVal cCodDivisa As String, ByVal

3.11 E3emplo de Operacin DCC
(rimeroA Se rea+i1ar? ,na o)eraci%n de Pa7o o Prea,*ori1aci%n
es*?ndar E5e-)+o&
fnDllOperPinPad (25.36, OPER-DCC-TST, PAGO, cXmlResp, 1024);

Si +a o)eraci%n es !CC, en +a 0aria/+e c9-+Res) o/*endre-os e+
si7,ien*e 9M( de res),es*a&

<resultadoConsulta>
<divisas>
<importeOriginal>25.36</importeOriginal>
<monedaOriginal>978</monedaOriginal>
<importeDivisa>17.81</importeDivisa>
<codigoDivisa>826</codigoDivisa>
<nombreDivisa>POUND STERLING</nombreDivisa>
<simboloDivisa>GBP</simboloDivisa>
<formatoDivisa>2</formatoDivisa>
<porcentajeComision>1.7500</porcentajeComision>
<tasaDivisaConComision>1.424209</tasaDivisaConComision>
<tasaDivisaSinComision>1.449133</tasaDivisaSinComision>
<csb>4000</csb>
<nombreEntTermAct>REDSYS </nombreEntTermAct>
</divisas>
<firma>3CB335CF2F15DDDC6623B3A30C48AD9B6873679F</firma>
<InfoAuxiliar>
<aux.PaisTarjeta>826</aux.PaisTarjeta>




28/08/2014
Versin: 2.27

29

<aux.MarcaTarjeta>1</aux.MarcaTarjeta>
<aux.TipoTarjeta>1</aux.TipoTarjeta>
<aux.NumeroTarjeta>
</aux.NumeroTarjeta>
<aux.NombreMarcaTarjeta>VISA</aux.NombreMarcaTarjeta>
</InfoAuxiliar>
</Operaciones>

Gegundo& Se -os*rar? a+ *i*,+ar ,na )an*a++a donde se so+ici*ar? >,e
se+eccione +a -oneda con +a >,e >,iere rea+i1ar +a *ransacci%n E5e-)+o
M+os +i*era+es en ne7ri*a de/en a)arecer sie-)re y en in7+SsN&

M,es*re e+ si7,ien*e -ensa5e a+ c+ien*e&

Rou ?ave t?e c?oice o5 paBing Bour &ill in eit?erA
Ii-)or*eEri7ina+ J E=4 or Ii-)or*e!i0isaJ Isi-/o+o!i0isaJ
Gervice and E;c?ange rate provided &B Ino-/reEn*;er-Ac*J A Isi-/o+o!i0isaJ 1.22 P
I*asa!i0isaConCo-isionJ E=4
INC/=DEG I)orcen*a5eCo-isionJS %4T =( over source rate provided &B
Ia,<"o-/reMarca;ar5e*aJ.
NO CO%%IGGION

Se+eccione di0isa se7Rn indicaciones de+ c+ien*e&

Onom&reDivisaF OimporteDivisaF E=4O OimporteOriginalF




28/08/2014
Versin: 2.27

30

Co-o se 0e en e+ e5e-)+o, hay >,e ,*i+i1ar +a infor-aci%n de0,e+*a en e+
an*erior 9M( de res),es*a

Tercero& Rea+i1ar +a *ransacci%n en +a -oneda se+eccionada )or e+
*i*,+ar&
fnDllOperPinPadDCC(25.36, OPER-DCC-TST, PAGO, 826, cXmlResp, 1024);

E+ 9M( de Res),es*a&

<factura>OPER-DCC-TST</factura>
<tasaCambio>1.424209</tasaCambio>
<pocentajeComision>1.7500</pocentajeComision>
<estado>F</estado>
<Literales>
<literal>I ACCEPT THAT I HAVE BEEN OFFERED A CHOICE OF CURRENCIES FOR PAYMENT. I
ACCEPT THE CONVERSION RATE AND FINAL AMOUNT. I UNDERSTAND THAT THE CHOICE OF
TRANSACTION CURRENCY IS FINAL.</literal>
<literal>
</literal>
<datosDCC>
<linLitTrans>TRANSACTION CURRENCY</linLitTrans>
<linLitDivisa>GBP</linLitDivisa>
<linMarca>WHOLESALE RATE PROVIDED BY VISA</linMarca>
<linMarkUp>MARK-UP: 1.7500 %</linMarkUp>
<linLitComision>NO COMMISSION</linLitComision>
<linLitEntidad>SERVICE AND#N#EXCHANGE RATE PROVIDED BY#N#REDSYS</linLitEntidad>
<linCambio>GBP 1.00 = 1.424209 EUR</linCambio>
<linLitInf>Questions, if any, please#N#call (+34) 91 343 32 18#N#</linLitInf>
</datosDCC>
</Literales>
<firma>AEC91DBE60EE3A12EE8F95E16CA18EFECE41556D</firma>
</Operaciones>

continuacin mostramos un reci&o '5ormato slo te;to* con la
in5ormacin a imprimir B elemento ;ml @ue la contiene.




28/08/2014
Versin: 2.27

31

En a+7,nos e+e-en*os se ),ede reci/ir e+ car?c*er L"L, es*e car?c*er
indica ,n re*orno de carro o n,e0a +Hnea

El elemento linCam&io slo de&e mostrarse en el reci&o o copia
@ue se @uedarC el comercio.

Olin/itTransF

Olin/itDivisaF

Olin%arcaF

Olin%ar)=pF
Olin/itComisionF

Olin/itEntidadF

OlinCam&ioF

OliteralF

Olin/itIn5F




28/08/2014
Versin: 2.27

32

3.1- 4eali7ar una repeticin de pago con tar3eta en arc?ivo
Cna re)e*ici%n de )a7o con *ar5e*a en archi0o se rea+i1a sie-)re so/re
,na o)eraci%n inicia+ de )a7o con *ar5e*a en archi0o rea+i1ada con
an*erioridad
Se ),eden rea+i1ar has*a 22 re)e*iciones de ,n )a7o con *ar5e*a en
archi0o, sie-)re con e+ -is-o i-)or*e y +a -is-a *ar5e*a >,e e+ )a7o
ori7ina+


Transparente.
Transparente
+a o)eraci%n E+ for-a*o de es*e 9M( se enc,en*ra de*a++ado en +a
doc,-en*aci%n YCone<i%n con ;P$PC a *ra0Ss de @E8 SER$6CEY 0ersi%n
#0
a+-acenar? +a cadena 9M( con e+ res,+*ado de +a o)eraci%n Se

.alor de retornoA
)roceso




28/08/2014
Versin: 2.27

33

in* 5nDllOper(agoT3trc?ivoM(PC;S;R cNum(edido, (PC;S;R
c4TGOriginal, (PC;S;R c9actura, (P;S;R c!%/4esp, in*
iTam%a;4espNW


public static extern int fnDllOperPagoTjtArchivo(String
cNumPedido, String cRTSOriginal, String cFactura,


Public Declare Function fnDllOperPagoTjtArchivo Lib
"dllTpvpcLatente.dll" (ByVal cNumPedido As String, ByVal
cRTSOriginal As String, ByVal cFactura As String, ByVal




28/08/2014
Versin: 2.27

34

4. NE!O I. Integracin ctive!
(a +i/rerHa s,-inis*rada *a-/iSn dis)one de ,n co-)onen*e Ac*i0e9,
>,e )er-i*e +a in*e7raci%n de ;)0)c6-)+an*ado con a>,e++os en*ornos de
desarro++o o a)+icaciones >,e no ),eden in*e7rar +i/rerHas din?-icas Cn
c+aro e5e-)+o serHa ,na a)+icaci%n @e/ >,e ,*i+ice e+ "a0e7ador 6n*erne*
E<)+orer
Para rea+i1ar +a in*e7raci%n se ad5,n*a e+ C(S6! y no-/re de+ E/5e*o En
+a -ayorHa de +os en*ornos de desarro++o, se dis)one de asis*en*es )ara
e+ ,so de co-)onen*es Ac*i0e< Mconocidos *a-/iSn co-o o/5e*os CEMN

C/GIDA DU2-CE28,E1U8412+84,"81DU1C2DD,,
Identi5icador O&3etoA DllTpvpc/atente.TpvpImplantado

A con*in,aci%n se define +a corre+aci%n en*re +os -S*odos de+ Ac*i0e9 y
+as f,nciones de +a +i/rerHa E+ Ac*i0e9 si-)+e-en*e hace de en0o+*orio
)ara rea+i1ar +as ++a-adas a +a +i/rerHa, se indica e+ no-/re de+ -S*odo
en e+ Ac*i0e9 y s, corres)ondencia con +a +i/rerHa

in* IniTpvpc/atenteM8S;R &stComercio, 8S;R &stTerminal, 8S;R
&stClave9irma, 8S;R &stCon5(uerto, 8S;R &st.ersionN

int fnDllIniTpvpcLatente(LPCTSTR cComercio, LPCTSTR cTerminal, LPCTSTR cClaveFirma,
LPCTSTR cConfPuerto, LPCTSTR cVersion)

in* Oper(in(adM8S;R &stImporte, 8S;R &st9actura, 8S;R &stTipoOper, 8S;R
`&st!%/4espN

int fnDllOperPinPad(LPCTSTR cImporte, LPCTSTR cFactura, LPCTSTR cTipoOper, LPTSTR
cXMLResp, int iTamMaxResp);

in* Oper%anualE;tM8S;R &stTar3eta, 8S;R &stCaducidad, 8S;R &stC.C2,
8S;R &stImporte, 8S;R &st9actura, 8S;R &stTipoOper, 8S;R `&st!%/4espN

int fnDllOperManualxt(LPCTSTR cTar!eta, LPCTSTR cCaducidad, LPCTSTR cCVC",
LPCTSTR cImporte, LPCTSTR cFactura, LPCTSTR cTipoOper, LPTSTR cXMLResp, int
iTamMaxResp)

in* OperComConta&leM8S;R &stNum(edido, 8S;R &st4TGOriginal, 8S;R
&stImporte, 8S;R &st9actura, 8S;R &stTipoOper, 8S;R `&st!%/4espN




28/08/2014
Versin: 2.27

35

int fnDllOperComConta#le(LPCTSTR c$umPedido, LPCTSTR cRT%Original, LPCTSTR
cImporte, LPCTSTR cFactura, LPCTSTR cTipoOper, LPTSTR cXMLResp, int iTamMaxResp)

in* Trata(etComConta&leTr3 M8S;R &stImporte, 8S;R &st9actura, 8S;R
&stNum(edido, 8S;R &st4TGOriginal, 8S;R `&st!%/4espN

int fnDllComConta#leTr!(LPCTSTR cImporte, LPCTSTR cFactura, LPCTSTR c$umPedido,
LPCTSTR cRT%Original LPTSTR cXMLResp, int iTamMaxResp)

in* Trata(etDevGinOrigTr3M8S;R &stImporte, 8S;R &st9actura, 8S;R
`&st!%/4espN

int fnDllDev%inOrigTr!(LPCTSTR cImporte, LPCTSTR cFactura, LPTSTR cXMLResp, int
iTamMaxResp)

in* OperDevGinOriginalM8S;R &stTar3eta, 8S;R &stCaducidad, 8S;R
&stImporte, 8S;R &st9actura, 8S;R `&st!%/4espN

int fnDllOperDev%inOrig(LPCTSTR cTar!eta, LPCTSTR cCaducidad, LPCTSTR cImporte,
LPCTSTR cFactura, LPTSTR cXMLResp, int iTamMaxResp)

in* OperConsultaM8S;R &stNum(edido, 8S;R &st4TG, 8S;R &st9actura, 8S;R
&st9ec?aIni, 8S;R &st9ec?a9in, 8S;R &stTipo, 8S;R &st4esultado, 8S;R
&stNum(agina, 8S;R `&st!%/4espN

int fnDllOperConsulta(LPCTSTR c$umPedido, LPCTSTR cRT%, LPCTSTR cFactura, LPCTSTR
cFec&aIni, LPCTSTR cFec&aFin, LPCTSTR cTipo, LPCTSTR cResultado, LPCTSTR
c$umPagina, LPTSTR cXMLResp, int iTamMaxResp);

in* OperTotalesM8S;R &st9ec?a, 8S;R &stDesglose.%, 8S;R
&stDesglose%arcas, 8S;R `&st!%/4espN

int fnDllOperTotales(LPCTSTR cFec&a, LPTSTR cDesgloseVM, LPTSTR cDesgloseMarcas,
LPTSTR cXMLResp, int iTamMaxResp)

in* Oper(in(adDCCM8S;R &stImporte, 8S;R &st9actura, 8S;R &stTipoOper,
8S;R &stCodDivisa, 8S;R `&st!%/4espN




28/08/2014
Versin: 2.27

36

int fnDllOperPinPadDCC(LPCTSTR cImporte, LPCTSTR cFactura, LPCTSTR cTipoOper,
LPCTSTR cCodDivisa, LPTSTR cXmlResp, int iTamMaxResp);

in* Trata(et(agoT3trc?ivoM8S;R &stNum(edido, 8S;R &st4TGOriginal, 8S;R
8S;R &st9actura, 8S;R `&st!%/4espN

int fnDllOperPagoT!t'rc&ivo(LPCTSTR c$umPedido, LPCTSTR cRT%Original, LPCTSTR
cFactura, LPTSTR cXMLResp, int iTamMaxResp);

in* Opernul(reautM8S;R &stNum(edido, 8S;R &st4TGOriginal, 8S;R
&st9actura, 8S;R `&st!%/4espNW

int fnDllOper'nulPreaut(LPCTSTR c$umPedido, LPCTSTR cRT%Original, LPCTSTR
cFactura, LPTSTR cXMLResp, int iTamMaxResp);

in* Oper4eempla7o(reautM8S;R &stImporte, 8S;R &stNum(edido, 8S;R
&st4TGOriginal, 8S;R &st9actura, 8S;R `&st!%/4espNW

int fnDllOperReempPreaut(LPCTSTR c$umPedido, LPCTSTR cRT%Original( LPCTSTR
cImporte, LPCTSTR cFactura, LPTSTR cXMLResp, int iTamMaxResp);




28/08/2014
Versin: 2.27

37

". NE!O II. Integracin #indo$s %o&ile '(oc)et (C*
En es*e ane<o se de*a++ar?n +as -odificaciones >,e afec*an a +a
in*e7raci%n de +a +i/rerHa en es*a )+a*afor-a

9uncionalidad no disponi&le paraA
%odo Inter5a7 de =suario "o es*? dis)oni/+e, s%+o se ),ede iniciar
+a +i/rerHa en Modo ;rans)aren*e

cceso utili7ando ctive! "o es*? dis)oni/+e es*e -odo de
acceso, se de/er? ,*i+i1ar +a in*e7raci%n con +a +i/rerHa din?-ica o
!((

Res)ec*o a +a doc,-en*aci%n, no-/re de f,nciones y )ar?-e*ros son
e<ac*a-en*e i7,a+es, +a Rnica consideraci%n a *ener en c,en*a es e+
no-/re de +a +i/rerHa >,e )ara @indoAs Mo/i+e ca-/ia de
d++;)0)c(a*en*ed++ a d++;)0)c6-)+an*ado@Md++

En +os e5e-)+os de ++a-ada )ara en*orno de !esarro++o "E; >,e se
-,es*ran en es*e doc,-en*o, +o Rnico >,e es necesario ca-/iar es e+
no-/re de +a +i/rerHa A con*in,aci%n -os*ra-os ,n e5e-)+o de es*os
ca-/ios&



E5e-)+o de ++a-ada en CL "E; )ara @indoAs Mo/i+e&

[DllImport("dllTpvpcImplantadoWM.dll")]





28/08/2014
Versin: 2.27

38

Public Declare Function fnDllIniTpvpcLatente Lib "
dllTpvpcLatente.dll" (ByVal cComercio As String, ByVal

E5e-)+o de ++a-ada en $is,a+ 8asic "E; )ara @indoAs Mo/i+e&
Public Declare Function fnDllIniTpvpcLatente Lib
"dllTpvpcImplantadoWM.dll" (ByVal cComercio As String, ByVal




28/08/2014
Versin: 2.27

39

,. NE!O III. Errores devueltos

9=NCIJN
CJD
DEGC4I(CIJN
fn!++6ni;)0)c(a*en*e 81
Error 6n*erno de+ Sis*e-a Ser?
necesario reiniciar +a car7a de +a +i/rerHa
din?-ica Si e+ )ro/+e-a )ersis*e,
no*ificar )ro/+e-a a en*idad
fn!++6ni;)0)c(a*en*e 82
Error a+ car7ar e+ 9M( con +os da*os de
confi7,raci%n
fn!++6ni;)0)c(a*en*e 83
"o se ha es)ecificado nin7Rn 0a+or en
e+ e+e-en*o
da*osConf/da*osCo-ercio/co-ercio
fn!++6ni;)0)c(a*en*e 84
e+ e+e-en*o
da*osConf/da*osCo-ercio/*er-ina+
fn!++6ni;)0)c(a*en*e 8"
e+ e+e-en*o
da*osConf/da*osCo-ercio/c+a0e
fn!++6ni;)0)c(a*en*e 8,
e+ e+e-en*o
da*osConf/accesoCs,ario/,s,ario
fn!++6ni;)0)c(a*en*e 8+
e+ e+e-en*o
da*osConf/accesoCs,ario/c+a0e
fn!++6ni;)0)c(a*en*e 81
e+ e+e-en*o da*osConf/-odo
fn!++6ni;)0)c(a*en*e 8-
"o se ha es)ecificado ni acceso con
da*os de co-ercio ni ,s,ario Es
o/+i7a*orio es)ecificar ,no de +os dos
accesos
fn!++6ni;)0)c(a*en*e 812
e+ e+e-en*o
da*osConf/conf!is)osi*i0o/),er*o Si no
se >,iere ,sar ,n )in)ad, no es
necesario inc+,ir e+ e+e-en*o
conf!is)osi*i0o Si se inc+,ye se de/en
confi7,rar *odos +os e+e-en*os
fn!++6ni;)0)c(a*en*e 811
e+ e+e-en*o
da*osConf/conf!is)osi*i0o/0ersion
fn!++6ni;)0)c(a*en*e 812
Error 6n*erno de+ sis*e-a
fn!++6ni;)0)c(a*en*e 813
Error a+ rea+i1ar e+ desc,/ri-ien*o de+
PinPad Se s,)er% e+ ;i-eE,* -?<i-o
de es)era
fn!++6ni;)0)c(a*en*e 814 "o se ),do iniciar +a in*erfa1 7r?fica de+




28/08/2014
Versin: 2.27

40

;P$PC (a*en*e
fn!++6ni;)0)c(a*en*e 81,
Pro/+e-a en +a co-,nicaci%n con e+
Ser0icio @e/ de+ ;P$PC Re0isar
cone<i%n a 6n*erne*, e in*en*ar ,na
n,e0a inicia+i1aci%n c,ando e+ ser0icio
es*S res*a/+ecido.
fn!++6ni;)0)c(a*en*e 811
Se en0Ha correc*a-en*e +a )e*ici%n a+
;P$PC, )ero a+7,no de +os da*os
es*a/+ecidos no es correc*o Re0ise
c%di7o de co-ercio, *er-ina+ y +a c+a0e
de fir-a.
fn!++6ni;)0)c(a*en*e 81-
E+ Pin)ad no es*? confi7,rado
correc*a-en*e, es necesario con*ac*ar
con +a en*idad
fn!++6ni;)0)c(a*en*e 822
E+ P,er*o de co-,nicaci%n es)ecificado
no es correc*o.
fn!++6ni;)0)c(a*en*e 821
Se ha es)ecificado ,na 0ersi%n >,e es
inco-)a*i/+e con e+ PinPad ins*a+ado
Cons,+*ar con +a en*idad e+ 0a+or
correc*o
fn!++6ni;)0)c(a*en*e 842
(a 0ersi%n de +a +i/rerHa ha cad,cado y
de/e ac*,a+i1arse

fn!++6ni;)0)c(a*en*eE<* 81
Error 6n*erno de+ Sis*e-a Ser?
necesario reiniciar +a car7a de +a +i/rerHa
din?-ica Si e+ )ro/+e-a )ersis*e,
no*ificar )ro/+e-a a en*idad

fn!++6ni;)0)c(a*en*eE<* 82
Error a+ car7ar e+ 9M( con +os da*os de
confi7,raci%n Re0isar >,e se han
ins*a+ado *odas +as +i/rerHas
fn!++6ni;)0)c(a*en*eE<* 83
e+ e+e-en*o
da*osConf/da*osCo-ercio/co-ercio
fn!++6ni;)0)c(a*en*eE<* 84
e+ e+e-en*o
da*osConf/da*osCo-ercio/*er-ina+
fn!++6ni;)0)c(a*en*eE<* 8"
e+ e+e-en*o
da*osConf/da*osCo-ercio/c+a0e
fn!++6ni;)0)c(a*en*eE<* 8,
e+ e+e-en*o
da*osConf/accesoCs,ario/,s,ario
fn!++6ni;)0)c(a*en*eE<* 8+
e+ e+e-en*o




28/08/2014
Versin: 2.27

41

da*osConf/accesoCs,ario/c+a0e
fn!++6ni;)0)c(a*en*eE<* 81
e+ e+e-en*o da*osConf/-odo
fn!++6ni;)0)c(a*en*eE<* 8-
"o se ha es)ecificado ni acceso con
da*os de co-ercio ni ,s,ario Es
o/+i7a*orio es)ecificar ,no de +os dos
accesos
fn!++6ni;)0)c(a*en*eE<* 812
e+ e+e-en*o
da*osConf/conf!is)osi*i0o/),er*o Si no
se >,iere ,sar ,n )in)ad, no es
necesario inc+,ir e+ e+e-en*o
conf!is)osi*i0o Si se inc+,ye se de/en
confi7,rar *odos +os e+e-en*os
fn!++6ni;)0)c(a*en*eE<* 811
e+ e+e-en*o
da*osConf/conf!is)osi*i0o/0ersion
fn!++6ni;)0)c(a*en*eE<* 812
fn!++6ni;)0)c(a*en*eE<* 813
Error a+ rea+i1ar e+ desc,/ri-ien*o de+
PinPad Se s,)er% e+ ;i-eE,* -?<i-o
de es)era
fn!++6ni;)0)c(a*en*eE<* 814
"o se ),do iniciar +a in*erfa1 7r?fica de+
;P$PC (a*en*e

fn!++E)erMan,a+E<* 81
"o se han es*a/+ecido correc*a-en*e
+os da*os de confi7,raci%n Es necesario
0o+0er a ++a-ar a +a f,nci%n
fn!++6ni;)0)c(a*en*e Si e+ )ro/+e-a
)ersis*e con*ac*ar con +a en*idad
Se ha so/re)asado e+ ;i-eE,*
es)ecificado )or +a a)+icaci%n
Error de+ Sis*e-a Es necesario reiniciar
a)+icaci%n
(os da*os de en*rada no *ienen ,n
for-a*o correc*o Re0isar +is*a de
)ar?-e*ros
fn!++E)erMan,a+E<* 81+
E+ ;a-a4o de+ /,ffer de res),es*a no
es s,ficien*e Se reco-ienda ,*i+i1ar e+
0a+or indicado en +a doc,-en*aci%n
E+ for-a*o de a+7Rn )ar?-e*ro es
incorrec*o Por e5e-)+o, re0ise >,e e+
)ar?-e*ro cImporte *iene for-a*o
L00000 3000 e,ros cImporte^
300000




28/08/2014
Versin: 2.27

42

fn!++E)erPinPad 81
fn!++E)erPinPad 82
fn!++E)erPinPad 83
a)+icaci%n
fn!++E)erPinPad 84
)ar?-e*ros
fn!++E)erPinPad 81+
fn!++E)erPinPad 811
300000

fn!++E)erCo-Con*a/+e 81
Se )rod,5o ,n error in*erno de+ sis*e-a
a+ rea+i1ar +a o)eraci%n Si e+ )ro/+e-a
)ersis*e con*ac*e con s, en*idad
Error en +os )ar?-e*ros de en*rada Si
e+ )ro/+e-a )ersis*e con*ac*ar con +a
en*idad

fn!++E)erCons,+*a 81
5nDllIniTpvpc/atente Si e+ )ro/+e-a
Error en +os )ar?-e*ros de en*rada
fn!++E)erCons,+*a 81"
E)eraci%n no so)or*ada




28/08/2014
Versin: 2.27

43

fn!++E)er;o*a+es 81
fn!++E)er;o*a+es 82
fn!++E)er;o*a+es 83
Error en +os )ar?-e*ros de en*rada
fn!++E)er;o*a+es 812
fn!++E)er;o*a+es 81"

fn!++E)erPinPad!CC 81
a)+icaci%n
)ar?-e*ros
fn!++E)erPinPad!CC 81"
fn!++E)erPinPad!CC 81+
300000

fn!++!e0SinEri7;r5 81
+a a)+icaci%n




28/08/2014
Versin: 2.27

44

)ersis*e, con*ac*e con s, en*idad
fn!++!e0SinEri7;r5 8"
Error en +os )ar?-e*ros de en*rada Si
e+ )ro/+e-a )ersis*e, con*ac*ar con +a
en*idad
fn!++!e0SinEri7;r5 81"
fn!++!e0SinEri7;r5 81+
E+ *a-a4o de+ /,ffer de res),es*a no es
s,ficien*e Se reco-ienda ,sar e+ 0a+or
indicado en +a doc,-en*aci%n
)ar?-e*ros

fn!++Co-Con*a/+e;r5 81
a)+icaci%n
fn!++Co-Con*a/+e;r5 81"
fn!++Co-Con*a/+e;r5 81+
E+ *a-a4o de+ /,ffer de res),es*a no es
s,ficien*e Se reco-ienda ,sar e+ 0a+or
indicado en +a doc,-en*aci%n
)ar?-e*ros




28/08/2014
Versin: 2.27

45

+. NE!O I.. .ersiones /i&rer0a
Sie-)re >,e +a +i/rerHa s,fra a+7,na -odificaci%n, se ac*,a+i1ar? +a
infor-aci%n en e+ ser0idor, )ara >,e +as dis*in*as a)+icaciones >,e ,sen es*a
+i/rerHa se ac*,a+icen, si +o consideran necesario, con +a R+*i-a 0ersi%n Se
aconse5a -an*ener sie-)re +a R+*i-a 0ersi%n dis)oni/+e de +a +i/rerHa
En a+7,nas de es*as ac*,a+i1aciones, e+ ,so de ,na n,e0a 0ersi%n de +a
+i/rerHa, i-)+icar? ca-/ios en +a a)+icaci%n de+ co-ercio (a in*erfa1 de
++a-adas a +as f,nciones no se 0er? n,nca afec*ada, se -odificar?n +os 9M(
de Res),es*a, o se a7re7ar?n f,nciones n,e0as

+.1 MCuCndo de&e reali7arse una actuali7acin de esta
/i&rer0aN
Sie-)re >,e +a f,nci%n de inicio 5nDllIniTpvpc/atente de0,e+0a e+
c%di7o de error 842, indicar? >,e es necesario rea+i1ar +a ac*,a+i1aci%n,
ya >,e +a 0ersi%n ac*,a+ se enc,en*ra cad,cada ;a-/iSn se )odr?
de*ec*ar En +os 9M( de res),es*a de +as o)eraciones 5nDllOper(in(ad,
5nDllOperComConta&le, 5nDllOper%anual, a)arecer? ,n e+e-en*o
versdllimpl con +a R+*i-a 0ersi%n dis)oni/+e

E5& Se rea+i1a ,na )e*ici%n de !e0o+,ci%n de ,na o)eraci%n a,*ori1ada
con an*erioridad ,*i+i1ando +a f,nci%n 5nDllOperComConta&le

9M( de Res),es*a reci/ido&

<factura>
</factura> <identificadorRTS>070001071212171835457307</identificadorRTS>
<pedidoBase>2548</pedidoBase>
<estado>F</estado>
<firma>140D936EE212A03B823F766FF43E4C03365AC429</firma>
<versdllimpl fecha="20090430" tipo="RQS">1.0.4.1</versdllimpl>
</Operaciones>




28/08/2014
Versin: 2.27

46

En e+ doc,-en*o de Actualizacin de Versiones, se de*a++a *odo e+
)roceso necesario )ara rea+i1ar ,na ac*,a+i1aci%n c,ando Ss*a se
enc,en*re dis)oni/+e




28/08/2014
Versin: 2.27

47

1. NE!O .. Diccionario de Datos
A con*in,aci%n se descri/en *odos +os ca-)os >,e se ),eden encon*rar
en +os 9M( de res),es*a de +os dis*in*os -S*odos de +a +i/rerHa
tar3eta& nR-ero de *ar5e*a Cons*ar? de 13 a 12 )osiciones Es*e ca-)o
so+a-en*e )odr? ser infor-ado si e+ co-ercio >,e rea+i1a +a *ransacci%n
*iene )er-iso )ara rea+i1ar en*rada -an,a+ de da*os Cons,+*e con s,
En*idad si s, co-ercio dis)one de es*a )osi/i+idad
caducidad& cad,cidad de +a *ar5e*a en for-a*o AAMM Es*e ca-)o
so+a-en*e )odr? ser infor-ado si e+ co-ercio >,e rea+i1a +a *ransacci%n
*iene )er-iso )ara rea+i1ar en*rada -an,a+ de da*os Cons,+*e con s,
En*idad si s, co-ercio dis)one de es*a )osi/i+idad
cvc2& c%di7o de *res dH7i*os de se7,ridad >,e 0iene i-)reso
7enera+-en*e en e+ re0erso de +a *ar5e*a, y >,e ser? necesario
de)endiendo de +a ac*i0idad de+ co-ercio Cons,+*e con s, En*idad si s,
co-ercio de/e en0iar o/+i7a*oria-en*e es*e ca-)o
importe& 6-)or*e de +a o)eraci%n en for-a*o """ E5& 100
moneda& c%di7o de +a -oneda de +a o)eraci%n $a+ores :J 2'8 ME,rosN,
840 M!%+aresN Es*e da*o de)ende de +a -oneda >,e *en7a asociada e+
*er-ina+ )or e+ >,e se rea+ice +a o)eraci%n
comercio& FCC o c%di7o de+ co-ercio Cons*a de 2 dH7i*os
terminal& *er-ina+ en e+ >,e se rea+i1a +a o)eraci%n ",-Srico de+ 1 a+
22 Es i-)rescindi/+e >,e e+ *er-ina+ se enc,en*re dado de a+*a en
RE!SBS an*es de rea+i1ar a+7,na o)eraci%n so/re S+
cs&& Merchan* a+ >,e )er*enece e+ *er-ina+ Cons*a de 4 dH7i*os
5actura& cadena a+fan,-Srica >,e e+ co-ercio )odr? ,*i+i1ar co-o
iden*ificador )ara asociar ,na 0en*a con s, *ransacci%n ;P$PC
corres)ondien*e RE!SBS no 0a+idar? e+ for-a*o ni +a d,)+icidad de es*a
cadena, siendo res)onsa/i+idad de+ co-ercio E+ *a-a4o -?<i-o de es*a
cadena ),ede ser de 20 carac*eres
pedidoA nR-ero de )edido , o)eraci%n asociado a +a *ransacci%n Es*e
nR-ero es de0,e+*o )or e+ ;P$PC y ser0ir? )ara iden*ificar ,na
de*er-inada o)eraci%n en ,n co-ercio / *er-ina+ definido
identi5icador4TG& iden*ificador de +a o)eraci%n Es*a cadena de 24
)osiciones es de0,e+*a )or e+ ;P$PC y ser0ir? )ara iden*ificar ,na
de*er-inada o)eraci%n en ,n co-ercio / *er-ina+ definido
tipo(ago& *i)o de o)eraci%n >,e desea rea+i1arse $a+ores& PAXE :J
a,*ori1aci%n nor-a+, PREAC;ER6FAC6E" :J )rea,*ori1aci%n, RECARXA :
J recar7a de -%0i+es, PREAC;TREEMP(AFE :J ree-)+a1o de
)rea,*ori1aciones, A"C(AC6E" :J an,+aci%n de )rea,*ori1aciones
5irma& con*iene +a fir-a de+ -ensa5e en for-a*o Ke<adeci-a+ M40
carac*eresN
5ec?aOperacion& fecha y hora de +a o)eraci%n en for-a*o BBBB:MM:!!
hh&--&ss-i+ise7
estado& es*ado de +a o)eraci%n $a+ores :J 9 Mfina+i1adaN, (Men
)rocesoN, TMfa++o *ScnicoN, VM!ene7adaN
resultado& res,+*ado de +a o)eraci%n $a+ores :J A,*ori1ada, !ene7ada




28/08/2014
Versin: 2.27

48

codigo4espuesta& con*iene e+ cdigo de autori7acin de +a
o)eraci%n, en e+ caso de o)eraci%n Ace)*ada, o e+ c%di7o de dene7aci%n
en caso de >,e +a o)eraci%n hay sido !ene7ada M0er Ane<o $66N Es*e
ca-)o no se infor-a en e+ caso de +as !e0o+,ciones/Confir-aciones
A,*ori1adas
pedidoUase& nR-ero de )edido de +a o)eraci%n so/re +a >,e se >,iere
rea+i1ar ,na o)eraci%n de de0o+,ci%n, confir-aci%n, an,+aci%n o
ree-)+a1o
id4TGOriginal& iden*ificadorR;S de +a o)eraci%n ori7ina+ so/re +a >,e se
rea+i1ar? ,na o)eraci%n de de0o+,ci%n, confir-aci%n, an,+aci%n o
ree-)+a1o
timestampA fecha y hora en +a >,e se -on*a e+ -ensa5e de )e*ici%n, en
for-a*o yyyydd !!mmss Es*e da*o )er-i*ir? conocer si ,n -ensa5e
es*? cad,cado, con e+ fin de i-)edir >,e ,na )ersona no a,*ori1ada
re,*i+ice e+ -ensa5e )ara rea+i1ar o)eraciones
descripcion& de*a++e de+ error )rod,cido En caso de ,n error de
for-a*o, se inc+,ye e+ ca-)o >,e )ro0oca e+ error (a inc+,si%n de es*e
ca-)o en e+ -ensa5e de sa+ida es o)ciona+
mensa3e& -ensa5e de infor-aci%n de+ error
codigo& c%di7o de error de0,e+*o )or e+ ;P$PC
codigoDivisa& c%di7o n,-Srico asociado a +a -oneda en +a >,e se
desea rea+i1ar +a *ransacci%n !CC M!yna-ic C,rrency Con0ersionN
importeDivisa& 6-)or*e res,+*an*e de +a o)eraci%n !CC en +a di0isa
es)ecificada en e+ codi7o!i0isa
importeOriginal& 6-)or*e de+ >,e se desea o/*ener e+ ca-/io en +a
corres)ondien*e di0isa )ara o)eraciones !CC E+ c%di7o de +a -oneda
asociada a dicho i-)or*e se es)ecifica en e+ a*ri/,*o acodonedab Si no
se infor-a dicho a*ri/,*o, *o-a e+ 0a+or )or defec*o a2'8b MECREN
tasaCam&io& ca-/io a)+icado )ara rea+i1ar +a con0ersi%n de -oneda
)ara +a o)era*i0a !CC
nom&reDivisa& no-/re de +a -oneda en +a >,e se desea rea+i1ar +a
*ransacci%n !CC M!yna-ic C,rrency Con0ersionN
sim&oloDivisa& codi7o red,cido >,e iden*ifica a +a -oneda en +a >,e se
desea rea+i1ar +a *ransacci%n !CC
5ormatoDivisa& nR-ero de deci-a+es de +a -oneda en +a >,e se desea
rea+i1ar +a *ransacci%n !CC
porcenta3eComision& co-isi%n Men QN >,e se a)+ica )ara ca+c,+ar e+
i-)or*e de +a di0isa
tasaDivisaConComision& ca-/io a)+icado )ara rea+i1ar +a con0ersi%n
de -oneda )ara +a o)era*i0a !CC Mi7,a+ >,e *asaCa-/ioN
tasaDivisaGinComision& ca-/io a)+icado )ara rea+i1ar +a con0ersi%n de
-oneda )ara +a o)era*i0a !CC sin a)+icar+e e+ )orcen*a5e de +a co-isi%n
literal& +i*era+es >,e de0,e+0e e+ ;P$PC y >,e de/en a)arecer en +a
/o+e*a >,e i-)ri-e e+ co-ercio, en e+ orden en >,e se en0Han en e+
-ensa5e de res),es*a
numTelW5ono 'datos4ecarga*& nR-ero de *e+Sfono a recar7ar
idOperador& iden*ificador de+ o)erador a+ >,e es*? asociada +a *ar5e*a
*e+ef%nica S,s 0a+ores son 0 :J AME"A, 1 :J ME$6S;AR, 2 :J
$E!AFE"E, 3 :J ECScA(;E(, 4 :J 9FERA




28/08/2014
Versin: 2.27

49

idTransOperador& nR-ero de referencia asi7nado a +a *ransacci%n )or
e+ o)erador corres)ondien*e Es*e 0a+or de/e a)arecer en e+ reci/o de +a
o)eraci%n
pla7o(ago& c%di7o de fracciona-ien*o >,e indica e+ *i)o de
a)+a1a-ien*o >,e se rea+i1ar?
tar3etaComercio4eci&o& nR-ero de +a *ar5e*a >,e se i-)ri-ir? en e+
reci/o de+ co-ercio Es*a se i-)ri-ir? en +a /o+e*a as*eriscada o no
de)endiendo de +a confi7,raci%n de+ co-ercio )ara s, )ro)ia /o+e*a
tar3etaCliente4eci&o& nR-ero de +a *ar5e*a >,e se i-)ri-ir? en e+
reci/o de+ c+ien*e Es*a se i-)ri-ir? en +a /o+e*a as*eriscada o no
de)endiendo de +a confi7,raci%n de+ co-ercio )ara +a /o+e*a de+ c+ien*e
titularTar3eta& no-/re de+ *i*,+ar de +a *ar5e*a
tipoOperacionA *i)o de +a o)eraci%n rea+i1ada MA,*ori1acion,
Prea,rori1acion, !e0o+,cion, Confir-acionN
5ec?aOper& fecha de +a o)eraci%n en for-a*o BBBB:MM:!! )ara +as
cons,+*a de ,na o)eraci%n
operacionemv& 6ndica >,e se *ra*a de ,na o)eraci%n EM$
conttransA Contador de *ransacciones reci/ido de *ar5e*a EM$
sectar3etaA Ca-)o reci/ido de *ar5e*a EM$
idappA Campo reci/ido de *ar5e*a EM$
eti@uetappA Ca-)o reci/ido de *ar5e*a EM$
resveri5icacionA Ca-)o reci/ido de *ar5e*a EM$
marcaTar3etaA Indica +a -arca de +a *ar5e*a ,*i+i1ada en +a o)eraci%n
S,s )osi/+es 0a+ores son&

Marca 6ndicador
$6SA 1
MAS;ERCAR! 2
!6"ERS #
AME9 8
=C8 2
CCP 22

paisTar3eta& 6ndica e+ c%di7o 6SE:31## n,-Srico de 3 cifras de +a
*ar5e*a S%+o dis)oni/+e en de*er-inadas o)era*i0as
tipoTasaplicadaA 6ndica +a *asa a)+icada MCrSdi*o / !S/i*oN en +a
res),es*a de +as a,*ori1aciones Ec de *ar5e*as naciona+es en *er-ina+es
naciona+es S,s 0a+ores son CrSdi*o :J CRE!, !S/i*o :J !E8
4eci&oGoloClienteA 6ndicador )ara i-)ri-ir s%+o e+ reci/o )ara e+
c+ien*e
reci&oOpcionalA 6ndicador >,e )er-i*e no i-)ri-ir reci/os, sie-)re
>,e se reci/a en +a res),es*a con 0a+or ;RCE




28/08/2014
Versin: 2.27

50

autenticado(or(inA 6ndicador de a,*en*icaci%n )or )in, afec*a a +a
i-)resi%n de reci/o "o se de/e i-)ri-ir e+ rec,adro de fir-a, en e+
Reci/o )ara e+ co-ercio, ya >,e e+ ,s,ario se a,*en*ico in*rod,ciendo e+
P6" de s, *ar5e*a




28/08/2014
Versin: 2.27

51

-. NE!O .I. Cdigos Error T(.(C
A con*in,aci%n se de*a++an +os c%di7os de error -?s co-,nes >,e ),ede
de0o+0er e+ ;P$PC&
GO(8T(.(C2222
Se ha )rod,cido ,n error a+ 0a+idar e+ -ensa5e
GO(8T(.(C2221 Error 7enSrico
GO(8T(.(C2222 Fir-a incorrec*a
GO(8T(.(C2223 (a 0ersi%n de+ -ensa5e no es*? so)or*ada
GO(8T(.(C2224
E+ -ensa5e no con*iene +os e+e-en*os
re>,eridos
GO(8T(.(C222"
A+7,nos e+e-en*os no con*ienen +os 0a+ores
es)erados
GO(8T(.(C222, E+ -ensa5e es*? cad,cado
GO(8T(.(C222+ Se ha )rod,cido ,n error desconocido
GO(8T(.(C2221
(a 0ersi%n de+ -ensa5e no so)or*a +a o)era*i0a
es)ecificada
GO(8T(.(C222-
E+ -ensa5e de )e*ici%n de cons,+*a no ),ede
inc+,ir /anda y nR-ero de *ar5e*a en e+ -is-o
-ensa5e
GO(8T(.(C2212
E+ -S*odo a+ >,e se en0Ha +a no es e+ adec,ado
GO(8T(.(C2214
"o e<is*e ,na o)eraci%n con esos da*os
GO(8T(.(C221"
C+a0e no +oca+i1ada
T(.(C222-
E+ i-)or*e de +a de0o+,ci%n s,)era e+ i-)or*e de
+a o)eraci%n ori7ina+
T(.(C2214
Se ha )rod,cido ,n error en e+ sis*e-a
6n*Sn*e+o -?s *arde, o )%n7ase en con*ac*o con
e+ Ad-inis*rador
T(.(C221"
Fa+*an da*os )ara ++e0ar a ca/o +a o)eraci%n
so+ici*ada
T(.(C221,
E+ co-ercio no )osee nin7Rn *er-ina+ ;P$PC
0?+ido
T(.(C2211
(a *ar5e*a no se ha +eHdo correc*a-en*e
Ase7Rrese de >,e +a asociaci%n +ec*or/*er-ina+
es +a correc*a, e in*Sn*e+o de n,e0o
T(.(C221-




28/08/2014
Versin: 2.27

52

Ase7Rrese de >,e +a asociaci%n +ec*or/*er-ina+
es +a correc*a, e in*Sn*e+o de n,e0o
T(.(C2222
Se ha )rod,cido ,n error a+ rea+i1ar +a o)eraci%n
6n*Sn*e+o de n,e0o
T(.(C2221
"o se han reci/ido *odos +os da*os necesarios
)ara -odificar s, con*rase4a
T(.(C2224
(a con*rase4a es)ecificada no ),ede ser
,*i+i1ada )or -o*i0os de se7,ridad Por fa0or,
indi>,e o*ra
T(.(C222"
E+ for-a*o de+ nR-ero de *ar5e*a in*rod,cido no
es 0?+ido
T(.(C222,
Ase7Rrese de >,e +a *ar5e*a es*? en /,en
es*ado, e in*Sn*e+o de n,e0o
T(.(C222+
E+ for-a*o de +a fecha de cad,cidad in*rod,cida
no es 0?+ido
T(.(C2232
E+ sis*e-a es*? oc,)ado Rein*Sn*e+o de n,e0o
en ,nos ins*an*es Si e+ )ro/+e-a )ersis*e,
)%n7ase en con*ac*o con s, ad-inis*rador
T(.(C2231
6n*Sn*e+o de n,e0o
T(.(C2232
E+ sis*e-a no ),ede acceder a +as o)eraciones
re>,eridas en es*e -o-en*o
T(.(C2233 Fa+*an da*os )ara rea+i1ar +a a,*en*icaci%n
T(.(C2234
E+ ,s,ario con e+ >,e in*en*a acceder ha sido
/+o>,eado P%n7ase en con*ac*o con s,
ad-inis*rador )ara des/+o>,ear+o
T(.(C223"
E+ ,s,ario con e+ >,e in*en*a acceder es*? dado
de /a5a P%n7ase en con*ac*o con s,
ad-inis*rador
T(.(C223,
Fa+*an da*os )ara ++e0ar a ca/o +a o)eraci%n
so+ici*ada
T(.(C223+
E+ sis*e-a no ),ede acceder a+ ,s,ario
es)ecificado en es*e -o-en*o
T(.(C223-
E+ )erfi+ de+ ,s,ario es)ecificado s%+o *iene
acceso a+ M%d,+o de Ad-inis*raci%n ;P$PC Por
fa0or, indi>,e o*ro ,s,ario
T(.(C2242
E+ sis*e-a no ha )odido co-)+e*ar +a o)eraci%n
es)ecificada Por fa0or, in*Sn*e+o de n,e0o
T(.(C2242
E+ sis*e-a no so)or*a ac*,a+-en*e e+ -S*odo de




28/08/2014
Versin: 2.27

53

a,*en*icaci%n es)ecificado Por fa0or,
-odifH>,e+o en in*en*e de n,e0o +a o)eraci%n
T(.(C2243
Es*? in*en*ando rea+i1ar ,na o)eraci%n de a+*a
so/re ,n ,s,ario ya e<is*en*e
T(.(C2244
E+ for-a*o de+ nR-ero de *e+Sfono in*rod,cido
no es 0?+ido
T(.(C2241
E+ -edio de )a7o es)ecificado no es 0?+ido, o no
es so)or*ado )or e+ co-ercio Por fa0or, )%n7ase
en con*ac*o con s, ad-inis*rador
T(.(C22"1
"o se han definido cri*erios s,ficien*es )ara
rea+i1ar +a o)eraci%n so+ici*ada
T(.(C22"2
(a con*rase4a no es correc*a, in*Sn*e+o de
n,e0o
T(.(C22"3 E+ ,s,ario es)ecificado no e<is*e
T(.(C22""
E+ co-ercio no *iene ha/i+i*ada +a o)era*i0a de
En*rada Man,a+ de da*os
T(.(C22",
E+ ,s,ario ha sido creado sa*isfac*oria-en*e,
)ero se ha )rod,cido ,n error a+ *Sr-ino de +a
o)eraci%n Si es*e )ro/+e-a )ersis*e en e+
f,*,ro, )%n7ase en con*ac*o con s,
ad-inis*rador
T(.(C22"+ E+ c%di7o de en*idad es)ecificado no e<is*e
T(.(C22"1
(a -oneda es)ecificada no coincide con +a
-oneda de+ *er-ina+
T(.(C22"-
E+ sis*e-a no ),ede acceder a+ *er-ina+
es)ecificado Ase7Rrese de >,e e+ *er-ina+
e<is*e, e in*en*e de n,e0o +a o)eraci%n
T(.(C22,2
"o e<is*e nin7Rn *er-ina+ a)ro)iado )ara *ra*ar
+a -arca de *ar5e*a in*rod,cida
T(.(C22,1
T(.(C22,2
E+ ,s,ario ha sido -odificado sa*isfac*oria-en*e,
)ero se ha )rod,cido ,n error a+ *Sr-ino de +a
o)eraci%n Si es*e )ro/+e-a )ersis*e en e+
f,*,ro, )%n7ase en con*ac*o con s,
ad-inis*rador
T(.(C22,3
T(.(C22,4
E+ ,s,ario ha sido dado de /a5a
sa*isfac*oria-en*e, )ero se ha )rod,cido ,n
error a+ *Sr-ino de +a o)eraci%n Si es*e




28/08/2014
Versin: 2.27

54

)ro/+e-a )ersis*e en e+ f,*,ro, )%n7ase en
con*ac*o con s, ad-inis*rador
T(.(C22," E+ ,s,ario es)ecificado ya es*? dado de /a5a
T(.(C22,,
"o se han encon*rado ,s,arios >,e c,-)+an +os
cri*erios de /Rs>,eda definidos
T(.(C22+1
Prea,*ori1aciones
T(.(C22+2
(a o)eraci%n no ),ede co-)+e*arse de/ido a >,e
no se ha reci/ido e+ da*o de a,*en*icaci%n de +a
*ar5e*a& C$C2
T(.(C22+4
E+ C$C2 in*rod,cido no coincide con e+
es)ecificado en +a *ar5e*a Ase7Rrese de >,e ha
in*rod,cido correc*a-en*e +os dH7i*os >,e fi7,ran
en e+ re0erso de +a *ar5e*a
T(.(C22+"
E+ )erfi+ de+ ,s,ario es)ecificado no *iene acceso
a+ ;P$PC
T(.(C22++
Acceso dene7ado a+ sis*e-a E+ -ensa5e de
acceso no es 0?+ido Co-)r,e/a e+ for-a*o de+
-ensa5e, +a fir-a y +a fecha de+ -is-o
T(.(C22+1
Es*? in*en*ando rea+i1ar ,na o)eraci%n so/re +a
>,e no *iene )er-isos asi7nados Por fa0or,
)%n7ase en con*ac*o con s, Ad-inis*rador
T(.(C22+-
E+ co-ercio / *er-ina+ >,e ha es)ecificado no
e<is*e Ase7Rrese de >,e ha in*rod,cido
correc*a-en*e +os da*os y )%n7ase en con*ac*o
con s, Ad-inis*rador
T(.(C2211
Con*rase4a incorrec*a Para rea+i1ar +a o)eraci%n
re>,erida es necesario >,e es)ecifi>,e s,
con*rase4a ac*,a+
T(.(C2213
(a confi7,raci%n de s, +ec*or no es +a correc*a
Por fa0or, rein*en*e +a o)eraci%n y cons,+*e con
s, Ad-inis*rador
T(.(C2214
Co-)r,e/e e+ es*ado de +a *ar5e*a y >,e e+ +ec*or
sea e+ correc*o, o )%n7ase en con*ac*o con s,
Ad-inis*rador
T(.(C221"
Ase7Rrese de >,e +a *ar5e*a es*? en /,en
es*ado, e in*Sn*e+o de n,e0o
T(.(C221+
E+ sis*e-a es*? oc,)ado Rein*Sn*e+o de n,e0o
en ,nos ins*an*es Si e+ )ro/+e-a )ersis*e,




28/08/2014
Versin: 2.27

55

)%n7ase en con*ac*o con s, ad-inis*rador
T(.(C221-
6n*Sn*e+o de n,e0o
T(.(C22-2
E+ *er-ina+ no *iene asociado nin7Rn +ec*or
0?+ido Por fa0or, confi7,re e+ *er-ina+ o
)%n7ase en con*ac*o con e+ Ad-inis*rador
T(.(C22-1
Se ha )rod,cido ,n error (a o)eraci%n
es)ecificada no e<is*e
T(.(C22-2
6n*Sn*e+o de n,e0o
T(.(C22-3
6n*Sn*e+o de n,e0o
T(.(C22-4
"o es )osi/+e rea+i1ar -?s confir-aciones so/re
+a )rea,*ori1aci%n ori7ina+
T(.(C22-,
Se ha )rod,cido ,n error en e+ sis*e-a E+
for-a*o de +os da*os )asados no es correc*o
T(.(C22-+
S, con*rase4a no ),ede -odificarse Ba ha
rea+i1ado +as -odificaciones )er-i*idas )ara
hoy
T(.(C22--
E+ co-ercio no es*? ha/i+i*ado )ara o)erar con +a
*ar5e*a de fide+i1aci%n indicada
T(.(C2122
"o ),ede rea+i1ar ,na
!E$E(CC6E"/CE"F6RMAC6E" so/re +a
o)eraci%n es)ecificada
T(.(C2121 (a fir-a no es correc*a
T(.(C2122
E+ cer*ificado no es 0?+ido o no es*? fir-ado )or
,na CA en +a >,e se confHe
T(.(C2123
E+ cer*ificado >,e es*? in*en*ando asociar ya es*?
asociado a o*ro ,s,ario
T(.(C2124
(a *ar5e*a no es*? asociada a nin7Rn ,s,ario
0?+ido en ;P$TPC
T(.(C212+
E+ co-ercio no *iene confi7,rada +a -oneda
es)ecificada
T(.(C2121
Se ha )rod,cido ,n error a+ rea+i1ar +a
con0ersi%n de di0isas
T(.(C212-
(a *ar5e*a no ad-i*e e+ )a7o en +a di0isa
es)ecificada
T(.(C2112 E+ nR-ero de )+a1os indicado no es 0?+ido
T(.(C2112
E+ i-)or*e de ,na recar7a )ara +a o)eradora




28/08/2014
Versin: 2.27

56

es)ecificada de/e ser -R+*i)+o de 300 E,ros
T(.(C2113
E+ i-)or*e de ,na recar7a )ara +a o)eradora
es)ecificada de/e ser -R+*i)+o de 1000 E,ros
T(.(C2114
En*rada Man,a+ de da*os
T(.(C211"
(a *ar5e*a ,*i+i1ada no ad-i*e a)+a1a-ien*o de
)a7os
T(.(C211+
E+ sis*e-a ya es*? )rocesando ,na o)eraci%n
con +os -is-os da*os Si desea rea+i1ar ,na
n,e0a o)eraci%n, rein*Sn*e+o en ,nos ins*an*es
T(.(C2111
E+ sis*e-a ha de*ec*ado >,e e<is*e ,na
o)eraci%n an*erior con +os -is-os da*os, con
res,+*ado AC;ER6FA!A Si desea d,)+icar +a
o)eraci%n, rein*Sn*e+o en ,nos ins*an*es
T(.(C211-
res,+*ado de ERRER Si desea re)e*ir de n,e0o
+a o)eraci%n, rein*Sn*e+o en ,nos ins*an*es
T(.(C2122
res,+*ado RECKAFA!A Si desea re)e*ir de
n,e0o +a o)eraci%n, rein*Sn*e+o en ,nos
ins*an*es
T(.(C2121
"o se ),ede rea+i1ar +a acci%n re>,erida so/re +a
o)eraci%n
T(.(C2122
"o se ha )odido ++e0ar a ca/o +a o)eraci%n
so+ici*ada de/ido a ,n error en e+ i-)or*e
T(.(C2123
"o se ),ede rea+i1ar +a acci%n re>,erida so/re
,na o)eraci%n >,e res,+*% err%nea o dene7ada
T(.(C2124
"o se ),ede rea+i1ar +a acci%n re>,erida de/ido
a ,n error
T(.(C212, (a *ar5e*a ,*i+i1ada no es 0?+ida
T(.(C212+
"o e<is*e nin7,na +is*a ne7ra )ara e+ co-ercio
es)ecificado
T(.(C2121
"o se ),ede ac*,a+i1ar +a infor-aci%n de +a
descar7a )ara e+ co-ercio
T(.(C212-
"o se ),ede asi7nar +a o)era*i0a de (is*a "e7ra
a+ co-ercio "o e<is*e nin7,na +is*a ne7ra
definida )ara ese co-ercio
T(.(C2131 E+ co-ercio no *iene ac*i0ada es*a o)era*i0a




28/08/2014
Versin: 2.27

57

T(.(C213" Error a+ *ra*ar -ensa5e PCP
T(.(C2141 "o es )osi/+e rea+i1ar e+ a)+a1a-ien*o de+ )a7o
T(.(CXE%.2222 Error in*erno en e+ )ro*oco+o ;P$PC EM$
T(.(CXE%.2224 Error en e+ )roceso ;(S
T(.(CXE%.222" Pin En(ine So+ici*ado no 6n*rod,cido
T(.(CXE%.222, ;er-ina+ no E)era*i0o Sin C+a0es Si-S*ricas
!8T(.(C2221
(a confi7,raci%n es)ecificada no es correc*a
Re0ise e+ ca-)o descri)ci%n )ara -?s
infor-aci%n
!8T(.(C2222
Error en +a co-,nicaci%n con ;P$PC Re0isar
cone<i%n con 6n*erne*
!8T(.(C2223
Error en +a co-,nicaci%n con e+ PinPad Re0ise
confi7,raci%n y cone<i%n fHsica con e+ dis)osi*i0o
!8T(.(C2224
Pro/+e-a en +a confi7,raci%n de+ P,er*o de
co-,nicaciones
!8T(.(C222"
Error en e+ co-)onen*e Ac*i0e9 de co-,nicaci%n
con Pin)ad Es necesario reins*a+ar a)+icaci%n
!8T(.(C222, Error en e+ PinPad, -ensa5e reci/ido no 0a+ido




28/08/2014
Versin: 2.27

58

12. NE!O .II. Cdigos de Denegacin
C,ando ,na )e*ici%n de a,*ori1aci%n da co-o res,+*ado ,na o)eraci%n
dene7ada, en e+ ca-)o codigo4espuesta se de0,e+0e e+ c%di7o de
dene7aci%n asociado a dicha res),es*a Es*e c%di7o indica e+ -o*i0o )or
e+ c,a+ se ha dene7ado +a o)eraci%n
(os c%di7os -?s co-,nes se de*a++an a con*in,aci%n&

Cdigo Descripcin
101 (a *ar5e*a es*? cad,cada
102 ;ar5e*a /+o>,eada )or e+ /anco e-isor
104 E)eraci%n no )er-i*ida )ara esa *ar5e*a o *er-ina+
10# 6n*en*os de P6" e<cedidos
10', 1#' Por fa0or, con*ac*e con e+ /anco e-isor de +a *ar5e*a
102 6den*ificaci%n in0?+ida de *er-ina+ o es*a/+eci-ien*o
110 6-)or*e in0?+ido
112 Se re>,iere P6" o/+i7a*orio
114 ;ar5e*a no so)or*a e+ *i)o de o)eraci%n so+ici*ado
11# !is)oni/+e ins,ficien*e
11' P6" incorrec*o
118 ;ar5e*a no re7is*rada
112 !esconocido
120 E)eraciones dene7adas )or S6S
121 E<cede +H-i*e de i-)or*e en an*ici)os de efec*i0o
122 !ene7aci%n )or con*ro+es so/re e+ $CA
123 CAC$ err%neo
124 ;i*,+ar necesi*a ca-/io de P6" )re0io a o)erar
123 ;ar5e*a no efec*i0a
12# 8+o>,e de P6" in0?+ido
122 ;ar5e*a no o)era*i0a Merror en C$C2N
130 Moneda no so)or*ada )or e+ e-isor
1#0
E+ *er-ina+ indica >,e +a o)eraci%n de cons,-o CEPS no ha
fina+i1ado correc*a-en*e
1#1 Marca no ad-i*ida )or e+ e-isor




28/08/2014
Versin: 2.27

59

180 ;ar5e*a no so)or*ada )or e+ sis*e-a
181 ;ar5e*a con res*ricciones dS/i*o
182 ;ar5e*a con res*ricciones crSdi*o
183 ;ar5e*a con res*ricciones dS/i*o Mc,en*a de crSdi*oN
184 Error en a,*en*icaci%n
183 Con*ro+ dis)osi*i0os no ada)*ados EM$
18' Error en cri)*o7rafHa EM$
120 !ene7ada )or e+ /anco e-isor de +a *ar5e*a, )or di0ersos -o*i0os
121 Fecha de cad,cidad err%nea
122 !a*os de case no encon*rados
123 6-)or*e e<cedido
124 Recha1o )or e+ o)erador *e+ef%nico
123 Con*ro+ Fa++/acO
128 !ene7aci%n !CC )ara en0Ho de con*ra0a+ores
201 ;ar5e*a cad,cada Erden de re*irar +a *ar5e
202, 208,
202
;ar5e*a /+o>,eada )or e+ /anco e-isor Erden de re*irar +a *ar5e*a
204 E)eraci%n no )er-i*ida )ara esa *ar5e*a o *er-ina+
20# 6n*en*os de P6" e<cedidos Re*ener *ar5e*a
20' ;ar5e*a en condiciones es)ecia+es Re*ener *ar5e*a
210 Re*enci%n )or con*ro+es so/re e+ $CA
280 C$$1/C$C1 o C$$2/C$C2 err%neo Re*ener *ar5e*a
220 !ene7ada )or di0ersos -o*i0os Erden de re*irar +a *ar5e*a
212 "R-ero de *ar5e*a ine<is*en*e




28/08/2014
Versin: 2.27

60

11. NE!O .III. E3emplos Impresin de 4eci&os
A con*in,aci%n se -,es*ran e5e-)+os de c%-o +as a)+icaciones de +os
co-ercios de/er?n i-)ri-ir +os reci/os, c,ando rea+icen +a in*e7raci%n
con TpvpcImplantado en %odo Transparente

11.1 4eci&o para una operacin reali7ada con /ectura de
Uanda o Entrada %anual de Datos




28/08/2014
Versin: 2.27

61

11.2 4eci&o para una operacin reali7ada con una Tar3eta
con C?ip E%.




28/08/2014
Versin: 2.27

62

11.3 4eci&o para una operacin reali7ada con una Tar3eta
DCC




28/08/2014
Versin: 2.27

63

11.4 E3emplo de 4eci&o de una operacin en la @ue se
reci&e el elemento O4eci&oGoloClienteF
En algunos PinPad, existe la posibilidad de capturar la firma por el propio PinPad, con
lo que no es necesario imprimir el Ejemplar para el comercio.




28/08/2014
Versin: 2.27

64

11." E3emplo de 4eci&o cuando se reci&e elemento
Oautenticado(or(inF
C,ando se reci/a e+ e+e-en*o a,*en*icadoPorPin, se de/e i-)ri-ir en
+,7ar de+ rec,adro de fir-a, e+ +i*era+ >,e se reci/e en e+ e+e-en*o
literales>autenticado(or(in
<tipoTasaAplicada>CRED</tipoTasaAplicada>
<estado>F</estado>
<Literales>
<literal> </literal>
<autenticadoPorPin>OPERACION CON PIN. FIRMA NO
NECESARIA.</autenticadoPorPin>
</Literales>
<firma>2F88A699FD6E68E4C5BD6E33058B3101DB0E68D4</firma>
<idapp>A0000000031010</idapp>
<etiquetaApp>VISA CLASSIC</etiquetaApp>
<resverificacion>0880008000</resverificacion >
<autenticadoPorPin>TRUE</autenticadoPorPin>
</Operaciones>




28/08/2014
Versin: 2.27

65

11., E3emplo de 4eci&o cuando se reci&e elemento
OoperContact/essF
C,ando se reci/a e+ e+e-en*o o)erCon*ac*(ess con
0a+or ;RCE, se de/e i-)ri-ir +a i-a7en >,e indica
e+ *i)o de o)era*i0a en e+ reci/o Es*o es necesario
rea+i1ar+o inde)endien*e-en*e a o*ras )osi/+es
e*i>,e*as >,e se inc+,yan en +a res),es*a, co-o
),eden ser e+ caso de Ua,*en*icadoPorPinV o
UReci/oSo+oC+ien*eV
<estado>F</estado>




28/08/2014
Versin: 2.27

66

<Literales>
<literal> </literal>
</Literales>
<firma>2F88A699FD6E68E4C5BD6E33058B3101DB0E68D4</firma>
<idapp>A0000000031010</idapp>
<etiquetaApp>VISA CLASSIC</etiquetaApp>
<resverificacion>0880008000</resverificacion >
<operContactLess> TRUE </ operContactLess >
</Operaciones>

(as e*i>,e*as es)ecHficas >,e ),eden aco-)a4ar a ,na o)eraci%n
Con*ac*+ess&
Io)erCon*ac*(essJ & iden*ifica +a o)eraci%n co-o Con*ac*+ess




28/08/2014
Versin: 2.27

67

IReci/oSo+oC+ien*eJ & no es o/+i7a*orio i-)ri-ir +a co)ia de+ co-ercio de
ac,erdo a +os )ar?-e*ros de confi7,raci%n de+ *er-ina+ y +os da*os de +a o)eraci%n
Sie-)re >,e a)are1ca es*a e*i>,e*a, no se de/er? i-)ri-ir +a ca5a de fir-a
Ia,*en*icadoPorPinJ & +a o)eraci%n ha sido a,*en*icada -edian*e e+ -S*odo
de 0erificaci%n de P6" de +a *ar5e*a En es*e caso *a-)oco es necesario i-)ri-ir +a
/o+e*a de+ co-ercio Sie-)re >,e a)are1ca es*a e*i>,e*a, no se de/er? i-)ri-ir +a
ca5a de fir-a
I(i*era+esJIa,*en*idadoPorPinJ & +i*era+ >,e se/e i-)ri-irse sie-)re >,e
a)are1ca P,ede *ener 0arios 0a+ores, co-o )or e5e-)+o&
EPERAC6Z" CE" P6" F6RMA "E "ECESAR6A
EPERAC6Z" CE";AC;(ESS F6RMA "E "ECESAR6A

11.+ E3emplo de 4eci&o cuando Deniega Tar3eta E%.
C,ando ,na o)eraci%n se rea+i1a con ,na *ar5e*a con chi) EM$, ),ede
s,ceder >,e e+ ;P$PC de c%-o a,*ori1ada +a o)eraci%n, )ero sea +a
*ar5e*a >,ien denie7,e En es*e caso, se reci/ir?n en e+ <-+ de res,+*ado
de +a o)eraci%n ,nos n,e0os e+e-en*os c,yo 0a+or ser? necesario
i-)ri-ir+os en e+ reci/o A con*in,aci%n de*a++a-os es*os n,e0os
e+e-en*os Me+ 0a+or de es*os de/e ser i-)reso *a+ c,a+ se de0,e+0e en e+
reci/o o *icOe*N&

.al"922, en e+ reci/o e+ no-/re de/e a)arecer co-o "922
.al"92", en e+ reci/o e+ no-/re de/e a)arecer co-o "92"
.al"92, en e+ reci/o e+ no-/re de/e a)arecer co-o "92
.al12, en e+ reci/o e+ no-/re de/e a)arecer co-o 12
.al-, en e+ reci/o e+ no-/re de/e a)arecer co-o -
.al-C, en e+ reci/o e+ no-/re de/e a)arecer co-o -C
.al-912, en e+ reci/o e+ no-/re de/e a)arecer co-o -912
.al-91+, en e+ reci/o e+ no-/re de/e a)arecer co-o -91+
.al-92,, en e+ reci/o e+ no-/re de/e a)arecer co-o -92,





28/08/2014
Versin: 2.27

68

<factura>DENIEGA-TARJ</factura>
<estado>F</estado>
<resultado>Denegada</resultado>
<Literales>
<literal></literal>
</Literales>
<firma>4D52D852A674557958BAB9236B567792D4ED082D</firma>
<idapp>A0000000031010</idapp>
<codrespauto></codrespauto>
<resverificacion>4000008000</resverificacion>
<Val5F20>46554C4C2046554E4354494F4E414C</Val5F20>
<Val5F25>101231</Val5F25>
<Val5F2A>0978</Val5F2A>
<Val82>5C00</Val82>
<Val9A>081017</Val9A>
<Val9C>00</Val9C>
<Val9F10>06011A03900000</Val9F10>
<Val9F1A>0724</Val9F1A>
<Val9F17>03</Val9F17>
<Val9F26>395E4D911AB0196D</Val9F26>
<Val9F27>00</Val9F27>
<Val9F33>E0F0C0</Val9F33>
<Val9F40>4000F0B001</Val9F40>
<Val9F34>410302</Val9F34>
<Val9F37>37AEC214</Val9F37>
</Operaciones>




28/08/2014
Versin: 2.27

69

11.1 E3emplo de 4eci&o cuando se reali7a una operacin
con tar3eta %E!
C,ando se reci/a e+ e+e-en*o -arca;ar5e*a con 0a+or 8, es*o indica >,e
+a *ar5e*a con +a >,e se ha hecho +a o)eraci%n es ,na *ar5e*a AME9, y +os
ca-/ios en e+ reci/o son +os si7,ien*es&
Ca-/iar e+ +o7o en e+ reci/o, *a+ y co-o se -,es*ra en e+
e5e-)+o
6-)ri-ir +a cad,cidad de +a *ar5e*a




28/08/2014
Versin: 2.27

70

En e+ si7,ien*e 9M( de e5e-)+o se -,es*ra e+ en ne7ri*a e+ e+e-en*o con
e+ >,e reconocere-os >,e +a o)eraci%n se corres)onde con ,na hecha
con *ar5e*a AME9&

<tarjetaClienteRecibo>***********1005</tarjetaClienteRecibo>
<tarjetaComercioRecibo>374907*****1005</tarjetaComercioRecibo>
<paisTarjeta>840</paisTarjeta>
<factura>FAC-LATENTE</factura>




28/08/2014
Versin: 2.27

71

<estado>F</estado>
<firma>42687D0CCDDB630F2B72D58413D2C7E26442DA82</firma>
</Operaciones>

11.- E3emplo de reci&o de una devolucin

IE)eraciones 0ersion^Y#0YJ
Ico-,nicacionCon*a/+e *i)o^Y!E$E(CC6E"YJ
Ires,+*adoCo-,nicacionJ
Ii-)or*eJ080I/i-)or*eJ
I-onedaJ2'8I/-onedaJ
Ico-ercioJ'''888221I/co-ercioJ
I*er-ina+J1I/*er-ina+J
I)edidoJ18'22I/)edidoJ
Ifac*,raJFAC:(A;E";EI/fac*,raJ

Iiden*ificadorR;SJ0'8020140#2310321813212'I/iden*ificadorR;SJ
I-arca;ar5e*aJ1I/-arca;ar5e*aJ




28/08/2014
Versin: 2.27

72

I)edido8aseJ18'20I/)edido8aseJ
IfechaE)eracionJ2014:0#:23
02&33&080I/fechaE)eracionJ
Ies*adoJFI/es*adoJ
Ires,+*adoJA,*ori1adaI/res,+*adoJ

Ifir-aJ!2E11#4A4#42A108A82A32##2382E3#'802!4E10I/fir-aJ
I/res,+*adoCo-,nicacionJ
I/co-,nicacionCon*a/+eJ
I/E)eracionesJ

11.12 E3emplo de reci&o de devolucin sin original

IE)eraciones 0ersion^Y#4YJ
Ico-,nicacionCon*a/+e *i)o^Y!E$E(S6"ER6XYJ
Ires,+*adoCo-,nicacionJ
Ii-)or*eJ100I/i-)or*eJ




28/08/2014
Versin: 2.27

73

I-onedaJ2'8I/-onedaJ
Ico-ercioJ'''888221I/co-ercioJ
I*er-ina+J1I/*er-ina+J
I*ar5e*aJ````````````2222I/*ar5e*aJ
Icad,cidadJ0000I/cad,cidadJ
I)edidoJ18'2#I/)edidoJ
Iiden*ificadorR;SJ0'8020140#23110001132128I/iden*ificadorR;SJ
I-arca;ar5e*aJ1I/-arca;ar5e*aJ
IfechaE)eracionJ2014:0#:23
11&2#&3'0I/fechaE)eracionJ
Ies*adoJFI/es*adoJ
Ires,+*adoJA,*ori1adaI/res,+*adoJ
Ifir-aJ33833'AA881!3CF83A12C43C222E3C8C3!A02!AI/fir-aJ
I/res,+*adoCo-,nicacionJ
I/co-,nicacionCon*a/+eJ
I/E)eracionesJ




28/08/2014
Versin: 2.27

74

12. NE!O I!. l llamar a la 5uncin de (ago6
(reautori7acin6 Con5irmacin o Devolucin nos
devuelve el cdigo 82
En a+7,nos casos, de/ido en +a -ayorHa de +os casos )or ,n )ro/+e-a en
+a +Hnea de cone<i%n a 6n*erne*, o fa++o en e+ dis)osi*i0o Men e+ caso de +as
o)eraciones de Pa7o o Prea,*ori1aci%n rea+i1adas desde e+ PinPadN +as
si7,ien*es f,nciones nos ),eden de0o+0er e+ c%di7o de re*orno :2&

MIuW ?acer en estos casosN

Es*a )r?c*ica no es o/+i7a*oria, )ero sH -,y reco-enda/+e, ya >,e
e0i*ar? e+ *ener >,e cons,+*ar +a o)eraci%n -an,a+-en*e desde e+
-%d,+o de ad-inis*raci%n, )ara co-)ro/ar si +a o)eraci%n res,+*%
A,*ori1ada o !ene7ada
!e es*a for-a, +a a)+icaci%n de+ co-ercio, a,*o-?*ica-en*e, )odr?
decidir si es necesario 0o+0er a en0iar +a *ransacci%n o si-)+e-en*e,
i-)ri-ir e+ reci/o con e+ 5,s*ifican*e de+ Pa7o

E3emploA Se rea+i1a ,na o)eraci%n )or 100 E,ros

Ca)*,ra-os +a hora ac*,a+ de+ Sis*e-a& Por e5e-)+o, 20080102 101323
;odos +os +en7,a5es de desarro++o dis)onen de f,nciones )ara rec,)erar
+a hora de+ Sis*e-a
Res,+*ado ^ 5nDllOper(in(adMU100V, UFAC12343#'82V, UPAXEV,
c!%/4esp, 1024N

Si Res,+*ado es i7,a+ a :2&

Rea+i1a-os ,na o)eraci%n de cons,+*a con e+ in*er0a+o *e-)ora+ definido
en*re die1 -in,*os an*es y die1 -in,*os des),Ss de +a hora de +a
o)eraci%n ori7ina+
Res,+*Cs*r ^ 5nDllOperConsultaMn,++, n,++, UFAC12343#'82V,
U2221212- 122"2"V, U2221212- 122"2"V, UPAXEV, n,++, U0V,
c9M(Res), 1024NW




28/08/2014
Versin: 2.27

75

Si Res,+*Cs*r es i7,a+ a 0, en +a 0aria/+e c9M(Res) *endre-os ,n <-+
co-o e+ >,e se -,es*ra a con*in,aci%n&

<?xml version="1.0" encoding="utf-8"?>
<resultadoConsulta>
<operacion>
<identificadorRTSBase></identificadorRTSBase>
<factura>FAC123456789</factura>
<estado>F</estado>
</operacion>
<numoperaciones>1</numoperaciones>
<numpagina>0</numpagina>
<totalpaginas>1</totalpaginas>
<firma>089A2555411FF75D1E0DE794421411CF110EF638</firma>
</consultas>

"E;A& En es*e caso +a o)eraci%n res,+*o A,*ori1ada

Gi 4esultCstr es igual a 826 se de&erC revisar la cone;in a
Internet6 si el pro&lema persiste6 contactar con la entidad para
in5ormar de la Incidencia




28/08/2014
Versin: 2.27

76

13. NE!O !. Operativas dicionales
En es*e Ane<o, se descri/e +a o)era*i0a adiciona+ >,e sa+e de+ f+,5o
nor-a+ de +as *ransacciones descri*as en +os ),n*os an*eriores
Esta operativa no se activa por de5ecto6 por tanto6 serC
responsa&ilidad del comercio solicitar su activacin a la entidad.
/a con5iguracin se reali7a en &ase al comercio B al nHmero de
terminal.

13.1 Operativa DCC reali7adas directamente en (in(ad.
A+7,nos -ode+os de PinPad dis)onen de +a )osi/i+idad de >,e e+ ;i*,+ar
se+eccione +a -oneda de +a *ransacci%n en e+ )ro)io dis)osi*i0o, con +o
>,e )ara +a a)+icaci%n >,e ,*i+ice +a +i/rerHa ser? *rans)aren*e y no
*endr? >,e -os*rar nin7Rn -ensa5e a+ ;i*,+ar (o >,e si *endr? >,e
hacer es ana+i1ar e+ <-+ de res),es*a reci/ido, )ara, en caso de >,e
f,ese necesario, i-)ri-ir e+ reci/o con +os da*os !CC

Giempre @ue en el ;ml de 4espuesta apare7ca el elemento
<codigoDivisa>, serC necesario imprimir el reci&o con los
datos DCC. En e+ ),n*o D!emplo de Operaci)n DCCE se enc,en*ra
,n e5e-)+o de c%-o i-)ri-ir ,n reci/o !CC

E5e-)+os de E)eraciones !CC rea+i1ada en ,n dis)osi*i0o con ca)acidad
!CC&

(+a-ada&

res,+*ado ^ 5nDllOper(in(adMU1000V, UOPER DCC PINPADV, UPAXEV,
c!%/4esp, 1024N

Res),es*a&

E+ ;i*,+ar decide )a7ar en s, -oneda&





28/08/2014
Versin: 2.27

77

<factura>OPER DCC PINPAD</factura>
<tasaCambio>1.424209</tasaCambio>
<pocentajeComision>1.7500</pocentajeComision>
<estado>F</estado>
<Literales>
<literal>I ACCEPT THAT I HAVE BEEN OFFERED A CHOICE OF CURRENCIES FOR
PAYMENT. I ACCEPT THE CONVERSION RATE AND FINAL AMOUNT. I UNDERSTAND
THAT THE CHOICE OF TRANSACTION CURRENCY IS FINAL.</literal>
<literal>
</literal>
<datosDCC>
<linLitTrans>TRANSACTION CURRENCY</linLitTrans>
<linLitDivisa>GBP</linLitDivisa>
<linMarca>WHOLESALE RATE PROVIDED BY VISA</linMarca>
<linMarkUp>MARK-UP: 1.7500 %</linMarkUp>
<linLitComision>NO COMMISSION</linLitComision>
<linLitEntidad>SERVICE AND#N#EXCHANGE RATE PROVIDED
BY#N#REDSYS</linLitEntidad>
<linCambio>GBP 1.00 = 1.424209 EUR</linCambio>
<linLitInf>Questions, if any, please#N#call (+34) 91 343 32 18#N#</linLitInf>
</datosDCC>
</Literales>
<firma>84F71795299CC2AA4657E26E9070CD3DE697CDEB</firma>
</Operaciones>

E+ ;i*,+ar decide )a7ar en +a -oneda de+ co-ercio *no &a+ operativa
DCC,&

<factura>OPER EURO PINPAD</factura>




28/08/2014
Versin: 2.27

78

<estado>F</estado>
<Literales>
<literal></literal>
</Literales>
<firma>BDD7ED68B1E775594DC9540CBE9E77A68540E2F4</firma>
</Operaciones>

13.2 In?i&icin de reci&o.
C,ando e+ co-ercio *en7a ac*i0ada es*a o)era*i0a, no es o/+i7a*orio
i-)ri-ir e+ reci/o de +a o)eraci%n si e+ i-)or*e de +a o)eraci%n no
s,)era ,n de*er-inado ,-/ra+ Es*e con*ro+ es rea+i1ado )or ;P$PC, y
en +a res),es*a a +a o)eraci%n ),ede indicar +a necesidad de i-)ri-ir e+
reci/o

Giempre @ue en el !%/ de respuesta apare7ca el elemento
<reciboOpcional>, con el valor TRUE no es o&ligatorio
imprimir el reci&o de la operacin 'tanto el reci&o cliente como el
reci&o del comercio*. simismo6 tampoco es necesario solicitar
5irma al cliente.

E5e-)+o de E)eraci%n en +a >,e +a i-)resi%n de+ reci/o es o)ciona+&

(+a-ada&
resultado = fnDllOperPinPad(10.00, OPER SIN RECIBO PINPAD, PAGO,
cXMLResp, 1024)

Res),es*a&





28/08/2014
Versin: 2.27

79

<factura>OPER SIN RECIBO PINPAD</factura>
<estado>F</estado>
<reciboOpcional>TRUE</reciboOpcional>
<firma>84F71795299CC2AA4657E26E9070CD3DE697CDEB</firma>
</Operaciones>

13.3 E3emplo de Integracin ctive! desde pCgina YT%/
En +a si7,ien*e CR(, se enc,en*ra e5e-)+o de ,so de+ Ac*i0e9 En es*e
e5e-)+o no 0ienen descri*os *odos +os -S*odos "o se de/e *o-ar es*e
e5e-)+o co-o ,na referencia de ,so, s, )ro)%si*o es s%+o ay,dar en e+
)roceso de in*e7raci%n
h**)&//sas:dser-e)aes/;P$TPC/;)0)c6-)+an*adoh*-

13.4 E3emplo de Integracin de /i&rer0a .dll desde
plicacin en CZ
E5e-)+o de 6n*e7raci%n Ac*i0e9 desde a)+icaci%n CL "E;, se -,es*ra
c%-o ,sar +a in*e7raci%n de +a +i/rerHa din?-ica En e+ e5e-)+o se ,sa +a
c+ase C+s;)0)c(a*en*ecs, co-o in*erfa1 de co-,nicaci%n con +a +i/rerHa
Sie-)re e<is*e +a )osi/i+idad de rea+i1ar +a in*e7raci%n ,*i+i1ando e+
Ac*i0e9
h**)&//sas:dser-e)aes/;P$TPC/Ac*i0e9/E5;)0)c6-)+an*ado"E;1i)

13." E3emplo de Integracin de ctive! desde plicacin
.isual Uasic ,.2
An*es de a/rir es*e )royec*o, es necesario *ener ins*a+ada y re7is*rada +a
+i/rerHa de co-,nicaci%n
h**)&//sas:dser-e)aes/;P$TPC/Ac*i0e9/E5;)0)c6-)+an*ado$8#1i)

13., E3emplo de Integracin de ctive! desde plicacin
.isual Uasic .NET '222"*
http://sas-d.sermepa.es/TPV_PC/ActiveX/ClienteVB_2005_Net.zip




28/08/2014
Versin: 2.27

80

13.+ E3emplo de Integracin de ctive! desde plicacin
(o$erUuilder 11
h**)&//sas:dser-e)aes/;P$TPC/Ac*i0e9/C+ien*ePoAer8,i+derT111i)

13.1 E3emplo de Integracin de /i&rer0a desde CZ para
#indo$s %o&ile '(oc)et (c*
An*es de a/rir es*e )royec*o, es necesario *ener ins*a+ada +a +i/rerHa
d++;)0)c6-)+an*ado@Md++ Es*a +i/rerHa de/e es*ar en e+ -is-o
direc*orio >,e e+ archi0o e5ec,*a/+e
h**)&//sas:dser-e)aes/;P$TPC/Ac*i0e9/A))Pr,e/a1i)

13.- E3emplo de Integracin de ctive! desde plicacin
<ava
+i/rerHa de co-,nicaci%n Para es*e )royec*o se ha ,sado +a +i/rerHa
=ACE8 M=A0a:CEM 8rid7eN Para -?s infor-aci%n 0er
h**)&//so,rcefor7ene*/)ro5ec*s/5aco/:)ro5ec*/

Es*a +i/rerHa ,sa dos co-)onen*es&
o Por ,n +ado ,*i+i1a M*an*o )ara co-)i+ar co-o )ara e5ec,*arN ,n
fichero 5ar M5aco/5arN Por +o *an*o, a +a hora de e5ec,*ar e+
e5e-)+o es necesario *ener en e+ c+ass)a*h +a r,*a a dicho fichero
o Por o*ra )ar*e, ,*i+i1a ,n fichero !(( M5aco/:1143:<8#d++ o
5aco/:1143:<#4d++, de)endiendo de +a ar>,i*ec*,ra de +a
-?>,ina donde se e5ec,*eN )ara co-,nicaci%n con +a +i/rerHa
na*i0a Es necesario es)ecificar +a r,*a donde reside e+ fichero >,e
corres)onde a n,es*ra ar>,i*ec*,ra -edian*e e+ )ar?-e*ro
java.library.path. Por e5e-)+o, a +a hora de e5ec,*ar e+
)ro7ra-a de e5e-)+o&
5a0a dc+ass)a*h Ir,*aTaT5aco/5arJWQC(ASSPA;KQ
d!5a0a+i/rary)a*h^C&eT*ra/a5oe5aco/:1143ed++
esser-e)a*)0)ci-)+an*ado;)0)c(a*en*e=ACE8

h**)&//sas:dser-e)aes/;P$TPC/Ac*i0e9/C+ien*e6-)+an*ado=a0a1i)




28/08/2014
Versin: 2.27

81

13.12 E3emplo de Integracin de /i&rer0a en .isual C:: ,.2
Cna 0e1 desco-)ri-ido e+ archi0o 1i), e<is*e ,na car)e*a S!c, >,e
con*iene +os archi0os +i/ y h necesarios )ara co-)i+ar e+ e5e-)+o o
c,a+>,ier )royec*o >,e rea+ice +a in*e7raci%n con $C
6-)or*an*e *ener en c,en*a, >,e es necesario inicia+i1ar e+ -ode+o de
hi+os )ara +i/rerHas CEM

E5& Co6ni*ia+i1eM"C((NW

h**)&//sas:dser-e)aes/;P$TPC/Ac*i0e9/C+ien*e$C1i)




28/08/2014
Versin: 2.27

82

14. NE!O !I. Tratamiento 9irma Digitali7ada
C,ando ,na o)eraci%n *iene asociada ,na fir-a di7i*a+, e+ co-ercio s%+o
*endr? +a o/+i7aci%n de 7enerar +a /o+e*a )ara e+ c+ien*e sin +a necesidad
de fir-a En es*e caso, se reci/ir? en e+ 9M( de res),es*a e+ *a7
IReci/oSo+oC+ien*eJ i7,a+ a ;RCE&

<titularTarjeta> REDSYS/SERVIRED </titularTarjeta>
<estado>F</estado>
<Literales>
<literal></literal>
</Literales>
<firma>E9A797406B8D56949B7B64A092F45AD8D4C20A45</firma>
<ReciboSoloCliente>TRUE</ReciboSoloCliente>
</Operaciones>




28/08/2014
Versin: 2.27

83

A,n>,e e+ co-ercio y e+ Pin)ad *en7an +a )osi/i+idad de fir-a
!i7i*a+i1ada, si e+ c+ien*e no fir-a en e+ dis)osi*i0o M`N, se de/er?
i-)ri-ir *an*o e+ reci/o c+ien*e co-o e+ co-ercio Mcon +a ca5e*i++a de
fir-aN En es*e caso no se reci/ir? e+ *a7 O4eci&oGoloClienteF&

<titularTarjeta>REDSYS/SERVIRED </titularTarjeta>
<estado>F</estado>
<Literales>
<literal></literal>
</Literales>
<firma>7064C7A60A974BF59A2B1D50CBD64E549803C281</firma>
</Operaciones>




28/08/2014
Versin: 2.27

84

'[* NOTA aun 5irmando el cliente en el (inpad6 la eti@ueta
O4eci&eGoloClienteF puede no aparecer 'la operacin se
considerarC autori7ada B sin 5irma* de&ido a un pro&lema en la
recepcin de esta. En este caso6 el comercio de&erC imprimir las
dos &oletas como arri&a e;puesto6 B el cliente 5irmar la copia
para el comercio.




28/08/2014
Versin: 2.27

85

1". NE!O !II. Tratamiento (IN
C,ando ,na o)eraci%n re>,iere a,*en*icaci%n de *i*,+ar -edian*e P6"
desde e+ dis)osi*i0o PinPad, no es necesario +a rea+i1aci%n de fir-a Mya
sea -an,a+ o di7i*a+i1adaN )or )ar*e de+ *i*,+ar de +a *ar5e*a E+ res,+*ado
se -os*rar? en +a res),es*a -edian*e e+ e+e-en*o <autenticadoPorPin>
co-o se -,es*ra en e+ e5e-)+o si7,ien*e&

<tipoTasaAplicada>DEB</tipoTasaAplicada>
<titularTarjeta>DE PRUEBAS N1/TARJETA </titularTarjeta>
<estado>F</estado>
<Literales>
<literal></literal>
</Literales>
<firma>24008043E0FEEE639C930EC7B82294A6FA7A8BFF</firma>
<resverificacion>000000C000</resverificacion>
<idapp>A0000000043060</idapp>
<etiquetaApp>MAESTRO</etiquetaApp>
</Operaciones>

C,ando a)arece e+ *a7 Iautenticado(or(inJ i7,a+ a ;RCE, no es
o/+i7a*orio i-)ri-ir +a /o+e*a de+ co-ercio, )ero sH +a /o+e*a de+ c+ien*e
Si se desea i-)ri-ir +a /o+e*a de+ co-ercio se de/er? i-)ri-ir e+ +i*era+
de +a e*i>,e*a (i*era+es/a,*en*icadoPorPin en +,7ar de +a ca5e*i++a de +a
fir-a&




28/08/2014
Versin: 2.27

86




28/08/2014
Versin: 2.27

87

1,. NE!O !III. Integracin /i&rer0a nativa C:: /inu;
1,.1 4e@uisitos m0nimos de uso de la li&rer0a C:: /inu;
cerne+& 2420 Mi38#N
Co-)i+ador& 7cc 322

1,.2 Integracin entorno /inu;
(a in*e7raci%n de ;)0)c6-)+an*ado es *a-/iSn )osi/+e con sis*e-as
(in,< Para e++o se ha desarro++ado ,na +i/rerHa es)ecHfica co-)a*i/+e con
es*os sis*e-as o)era*i0os, en concre*o se *ra*a de ,na +i/rerHa din?-ica&
+i/6-)+an*ado(in,<so
Es*a +i/rerHa e<)or*a +as f,nciones de ;)0)c6-)+an*ado ya descri*as
an*erior-en*e, de *a+ for-a >,e e+ desarro++ador ),ede ,sar ,n fichero
de ca/ecera M;)0)c(a*en*ehN >,e *iene +as definiciones de +as f,nciones
)ara )oder desarro++ar s, a)+icaci%n y, )os*erior-en*e, ,sar +as +i/rerHas
)ara rea+i1ar e+ en+a1ado y +a e5ec,ci%n
(a Rnica diferencia con +as f,nciones de ;)0)c6-)+an*ado ya descri*as
an*erior-en*e radica en +os *i)os de da*os, >,e )asan a ser *i)os de
da*os /?sicos de CPP Es*e es e+ con*enido de+ fichero de ca/ecera
;)0)c(a*en*eh&

/* Funcin que inicia la aplicacin TPVPC LATENTE */
extern "C" int fnDllIniTpvpcLatente(char * cComercio, char * cTerminal, char * cClaveFirma,
char * cConfPuerto, char * cVersion);

/* Fuerza la parada de TPVPC Latente. No devuelve errores. */
extern "C" int fnDllParaTpvpcLatente();

/* Funcin que realiza una peticin de Pago o Preautorizacin al TPVPC
utilizando un dispositivo PINPAD */
extern "C" int fnDllOperPinPad(char * cImporte, char * cFactura, char
* cTipoOper, char * cXMLResp, int iTamMaxResp);

/* Funcin que confirma como se quiere realizar una operacin que es
DCC.




28/08/2014
Versin: 2.27

88

* Este mtodo slo debe ser llamado despus de fnDllOperPinPad */
extern "C" int fnDllOperPinPadDCC(char * cImporte, char * cFactura,
char * cTipoOper, char * cCodDivisa, char * cXmlResp, int
iTamMaxResp);

/* Funcin que confirma como se quiere realizar una operacin que es
DCC.
* Este mtodo slo debe ser llamado despus de fnDllOperManualExt */
extern "C" int fnDllOperManualDCC(char * cCodDivisa, char * cXMLResp,
int iTamMaxResp);

/* Funcin que realiza una peticin de Pago o Preautorizacin al TPVPC
tecleando
* manualmente la tarjeta, caducidad y cvc2 */
extern "C" int fnDllOperManualExt(char * cTarjeta, char * cCaducidad,
char * cCVC2, char * cImporte, char * cFactura, char * cTipoOper,
char * cXMLResp, int iTamMaxResp);

/* Funcin que realizar una peticin de Devolucin/Confirmacin de
una operacin realizada en el TPVPC */
extern "C" int fnDllOperComContable(char * cNumPedido, char *
cRTSOriginal, char * cImporte, char * cFactura, char * cTipoOper, char
* cXMLResp, int iTamMaxResp);

/* Funcin que realizar una peticin de Devolucin/Confirmacin de
una operacin realizada en el TPVPC */
extern "C" int fnDllOperComContableTerminal(char * cNumTerminal, char
* cNumPedido, char * cRTSOriginal, char * cImporte, char * cFactura,
char * cTipoOper, char * cXMLResp, int iTamMaxResp);

/* Funcin que realizar una peticin de Devolucin Sin Original */
extern "C" int fnDllOperDevSinOrig(char * cTarjeta, char * cCaducidad,
char * cImporte, char * cFactura, char * cXMLResp, int iTamMaxResp);

/* Funcin para realizar consulta de operaciones realizadas con el
* comercio terminal especificado en la funcin de Inicializacin */




28/08/2014
Versin: 2.27

89

extern "C" int fnDllOperConsulta(char * cNumPedido, char * cRTS, char
* cFactura, char * cFechaIni, char * cFechaFin, char * cTipo, char *
cResultado, char * cNumPagina, char * cXMLResp, int iTamMaxResp);

/* Funcin que realiza una consulta de Totales, sobre el
comercio/terminal especificado al iniciar la librera */
extern "C" int fnDllOperTotales(char * cFecha, char * cDesgloseVM,
char * cDesgloseMarcas, char * cXMLResp, int iTamMaxResp);

/* Funcin que realizar una Anulacin de una operacin de
Preautorizacin realizada en el TPVPC */
extern "C" int fnDllOperAnulPreaut(char * cNumPedido, char *
cRTSOriginal, char * cFactura, char * cXMLResp, int iTamMaxResp);

/* Funcin que realizar un Reemplazo de una operacin de
Preautorizacin realizada en el TPVPC */
extern "C" int fnDllOperReempPreaut(char * cNumPedido, char *
cRTSOriginal, char * cImporte, char * cFactura, char * cXMLResp, int
iTamMaxResp);

/* Mtodo que continua una operacin de la que se han devuelto
Opciones de Pago */
extern "C" int fnDLLTrataOpcionesPago(char * cOpcionPago, char *
cXMLResp, , int iTamMaxResp);

;a-/iSn e<is*e ,na in*erfa1 )ara ,sar ,n o/5e*o CPP >,e se ),ede
encon*rar en +a definici%n de +a +i/rerHa D/i&T(.(C.?E

Para in*e7rar +a a)+icaci%n con +a +i/rerHa, es necesario inc+,ir e+ fichero
de ca/ecera en *odos +os ficheros >,e rea+icen +as ++a-adas a +as
f,nciones de +a +i/rerHa S,)on7a-os >,e *ene-os ,n fichero >,e
con*iene e+ c%di7o f,en*e de +a a)+icaci%n Es necesario inc+,ir en es*e
fichero ,na referencia a+ fichero de ca/ecera con +a definici%n de +as
f,nciones de +a +i/rerHa&

#include "TpvpcLatente.h"




28/08/2014
Versin: 2.27

90

=,n*o con +a +i/rerHa se dis*ri/,ye ,n archi0o caTpvpcImplantado.pem
con +os cer*ificados de $erisi7n necesarios )ara +a co-,nicaci%n SS( en
e+ en*orno de REA( (a +i/rerHa se ha co-)i+ado ,*i+i1ando +a +i/rerHa
o)enSS(, no es necesario *ener+a ins*a+ada en e+ sis*e-a, )ero si de/e
es*ar accesi/+e en e+ direc*orio de e5ec,ci%n de +a a)+icaci%n e+ archi0o
caTpvpcImplantado.pem.

Gi 5uese necesaria la actuali7acin de estos certi5icados6 se
podrC descargar la Hltima versin disponi&le de la li&rer0a6
solicitar este arc?ivo a soportetpvpc\redsBs.es o reali7arlo de
5orma manual 'openssl necesario para generar el 5ormato (E%*.
(ara la descarga manual6 se pueden descargar desde un
navegador de la =4/ ?ttpsA>>tpvpc.sermepa.es>T(.X(C>?tml>

Si +a +i/rerHa re>,iere +a 7eneraci%n de ,n fichero de (o7, Ss*e se
ac*i0ar? de -anera re-o*a en caso de incidencia Se 7enerar? en e+
direc*orio de e5ec,ci%n de +a a)+icaci%n con e+ no-/re
logDllImplantado.t;t

1,.3 E3emplo de Integracin de /i&rer0a en /inu;A /i&rer0a
dinCmica

Es*e )roceso consis*e en *ener +a +i/rerHa en ,n fichero se)arado de+
e5ec,*a/+e, >,e es car7ado de for-a din?-ica d,ran*e +a e5ec,ci%n de +a
a)+icaci%n, Rnica-en*e c,ando a+7,na de +as f,nciones de +a +i/rerHa es
++a-ada !e es*a for-a, se o)*i-i1a e+ *a-a4o de+ fichero e5ec,*a/+e, se
ahorra -e-oria y es -?s f?ci+ e+ -an*eni-ien*o de +a a)+icaci%n an*e
n,e0as 0ersiones de +a +i/rerHa
Cna 0e1 fina+i1ado e+ desarro++o, )ara 7enerar e+ )ro7ra-a e5ec,*a/+e,
de/e-os )roceder de +a si7,ien*e for-a&
Co)iar e+ fichero con +a +i/rerHa M+i/6-)+an*ado(in,<soN en ,n
direc*orio de +i/rerHas de+ sis*e-a M)or e5e-)+o, /o)*/+i/N

Co-)i+ar e+ )ro7ra-a indicando +a r,*a de +as +i/rerHas con e+
)ar?-e*ro d( e indicar, con e+ )ar?-e*ro d+ e+ no-/re de +a
+i/rerHa a ,sar Msin e+ )refi5o a+i/bN&

g++ -Wall L/opt/lib aplicacin.cpp lTpvpcImplantado lpthread o
<nombre_fichero_ejecutable>




28/08/2014
Versin: 2.27

91

donde <nombre_fichero_ejecutable> es no-/re de+ fichero
e5ec,*a/+e de +a a)+icaci%n

A +a hora de e5ec,*ar +a a)+icaci%n, a+ *ra*arse de ,na +i/rerHa
din?-ica, Ss*a de/e es*ar en e+ PA;K de /Rs>,eda de+ sis*e-a
Para e++o e<is*en diferen*es )osi/i+idades, en es*e doc,-en*o se
reco-iendan dos o)ciones, )ero +a decisi%n de c%-o confi7,rar
es*e acceso es res)onsa/i+idad de+ desarro++ador&

- Opcin & es necesario inc+,ir en +a 0aria/+e de sis*e-a
LD_LIBRARY_PATH +a r,*a donde se ha a+-acenado +a
+i/rerHa din?-ica, en e+ caso de >,e no es*S inc+,ida&

export LD_LIBRARY_PATH=/opt/lib:$LD_LIBRARY_PATH

Es*a ins*r,cci%n se ),ede 7,ardar en ,no de +os
ficheros de arran>,e de+ sis*e-a )ara >,e s%+o se de/a
hacer ,na Rnica 0e1
- Opcin U& crear ,n en+ace si-/%+ico a +a +i/rerHa en e+
direc*orio /,sr/+i/&

cd >usr>li&
sudo ln ]s O(TYX/IUF>li&Implantado/inu;.so
li&Implantado/inu;.so




28/08/2014
Versin: 2.27

92

1+. NE!O !I.. Integracin /i&rer0a <.
(a in*e7raci%n de ;)0)c6-)+an*ado es *a-/iSn )osi/+e con sis*e-as (in,< y
MAC ES Para e++o se ha desarro++ado ,na +i/rerHa en =A$A M-,+*i)+a*afor-aN
>,e es co-)a*i/+e con es*os sis*e-as o)era*i0os Co-o es -,+*i)+a*afor-a,
*a-/iSn ),ede ser ,sada en e+ sis*e-a o)era*i0o @indoAs
Si /ien es*a +i/rerHa es -,+*i)+a*afor-a, ,sa ,na +i/rerHa na*i0a de
co-,nicaci%n con ),er*os serie, >,e es es)ecHfica )ara cada )+a*afor-a
Por o*ra )ar*e, es*a +i/rerHa =A$A *iene +a )osi/i+idad de ,sar a>,e++os Pin)ad
c,ya cone<i%n sea E*herne*
Es*a +i/rerHa e<)or*a +as f,nciones de ;)0)c6-)+an*ado ya descri*as
an*erior-en*e E+ desarro++ador Rnica-en*e de/e i-)or*ar +a c+ase
esser-e)ai-)+an*adoSerC+s;)0)c(a*en*e, >,e con*iene +os -S*odos a
,sar Asi-is-o, de/er? a4adir a+ c+ass)a*h de e5ec,ci%n de +a a)+icaci%n +os
ficheros =AR con*enidos en +a car)e*a 6nc+,de

1+.1 4e@uisitos m0nimos de la li&rer0a <.
=!c o =RE 130 o s,)erior
1+.2 Desarrollo
(as f,nciones descri*as an*erior-en*e se i-)+e-en*an en +a c+ase
esser-e)ai-)+an*adoSerC+s;)0)c(a*en*e co-o -S*odos es*?*icos
Es*a c+ase se enc,en*ra en e+ fichero i-)+an*ado5ar
Co-o )ar*ic,+aridad, e+ -S*odo fn!++6ni;)0)c(a*en*e reci/e s%+o 3
)ar?-e*ros, ya >,e rec,)era +a confi7,raci%n de+ ),er*o desde e+
M%d,+o de Ad-inis*raci%n de ;P$PC E<is*e, asi-is-o, +a 0ersi%n con 3
)ar?-e*ros, )ero es*? -arcada co-o o/so+e*a, ya >,e en f,*,ras
0ersiones se e+i-inar?
E5e-)+o de ++a-ada a+ -S*odo fn!++6ni;)0)c(a*en*e&

import es.sermepa.implantado.SerClsTpvpcLatente;
.
String cComercio = 123443210;
String cTerminal = 1;
String cClaveFirma = AAABBB;
int retorno = SerClsTpvpcLatente.fnDllIniTpvpcLatente(cComercio, cTerminal,
cClaveFirma);
1+.3 E3ecucin




28/08/2014
Versin: 2.27

93

Es necesario inc+,ir en e+ C(ASSPA;K de +a a)+icaci%n +os ficheros
i-)+an*ado5ar, +a*en*e5ar y *odos +os ficheros =AR >,e se inc+,yen en +a
car)e*a Uinc+,deV
Para confi7,rar e+ acceso a ),er*os serie, es necesario ins*a+ar +a +i/rerHa
na*i0a R9;9, inc+,ida en e+ direc*orio inc+,de/r<*<:21:'
!en*ro de es*e direc*orio, hay s,/direc*orios )ara cada sis*e-a&
(ara /inu;A Se+eccionar e+ fichero +i/r<*<Seria+so >,e se enc,en*ra
en ,na de +as s,/car)e*as de inc+,de/r<*<:21:'/(in,<
(ara %acXOGX!A Se+eccionar e+ fichero +i/r<*<Seria+5ni+i/ >,e se
enc,en*ra en +a car)e*a inc+,de/MacTEST9
(ara #indo$sA Se+eccionar e+ fichero r<*<Seria+d++ >,e se enc,en*ra
en +a car)e*a inc+,de/@indoAs

Cna 0e1 se+eccionado e+ fichero deseado My co)iado a+ direc*orio
re>,eridoN, es necesario a4adir ,n )ar?-e*ro de e5ec,ci%n de -?>,ina
0ir*,a+ =a0a M)ar?-e*ro 5a0a+i/rary)a*hN
Para confi7,rar +a e5ec,ci%n con es*a +i/rerHa&
#indo$sA
o 6nc+,ir e+ fichero 5ar R9;9co--5ar en e+ C(ASSPA;K de +a
a)+icaci%n Es*e fichero se enc,en*ra en e+ direc*orio Uinc+,deV de
+a a)+icaci%n
o X,ardar e+ fichero inc+,deer<*<:21:'e@indoAser<*<Seria+d++ en
,na car)e*a referencia/+e o /ien en e+ direc*orio
I5a0aT0-Je5ree+i/ee<*
o E5ec,*ar +a a)+icaci%n 5a0a con e+ )ar?-e*ro 5a0a+i/rary)a*h
referenciando +a car)e*a donde se ha 7,ardado e+ fichero
E5e-)+o&
java -Djava.library.path=%PATH_APP%\include\rxtx-2.1-7\Windows .
/inu;>%acXOGX!A
o 6nc+,ir e+ fichero 5ar R9;9co--5ar en e+ C(ASSPA;K de +a
a)+icaci%n Es*e fichero se enc,en*ra en e+ direc*orio Uinc+,deV de
+a a)+icaci%n
o Para Mac ES 9& X,ardar e+ fichero MacTEST9e+i/r<*<Seria+5ni+i/
en +a car)e*a /(i/rary/=a0a/E<*ensions
o Para (in,<& X,ardar e+ fichero +i/r<*<Seria+so corres)ondien*e a
s, ar>,i*ec*,ra Mse+eccionar ,na de +a car)e*a (in,<N en e+
direc*orio I5a0aT0-Je5ree+i/ee<*
o E5ec,*ar +a a)+icaci%n 5a0a con e+ )ar?-e*ro 5a0a+i/rary)a*h
referenciando +a car)e*a donde se ha 7,ardado e+ fichero
E5e-)+o&




28/08/2014
Versin: 2.27

94

java -Djava.library.path=/Library/Java/Extensions .

o E+ ,s,ario >,e e5ec,*a de/e *ener )er-isos de ad-inis*rador en e+
e>,i)o, ade-?s de )er*enecer a +os 7r,)os ,,c) y +ocO Men
a+7,nas -?>,inas, T,,c) y T+ocON&
- Cn ,s,ario se a4ade a +os 7r,)os +ocO o ,,c) edi*ando e+
fichero /e*c/7ro,)s
- Por e5e-)+o& )ara a4adir e+ ,s,ario Y*)0)ci-)+an*adoY a+
7r,)o +ocO&
fSi*,aci%n )re0iag
loc"#$#%&#
fSi*,aci%n fina+g
loc"#$#%&#tp'pcimplantado
- En es*e -o-en*o, e+ ,s,ario Y*)0)ci-)+an*adoY ya
)er*enece ya a+ 7r,)o +ocO

o Es necesario *ener )er-iso de escri*,ra en +os direc*orios
('ar(spool(uucp
('ar(loc"
Para )er-i*ir )er-iso de +ec*,ra:escri*,ra, e5ec,*ar&
c)mod *** ('ar(spool(uucp
c)mod *** ('ar(loc"

o Es necesario *a-/iSn 0erificar >,e e+ ,s,ario *iene )er-isos de
+ec*,ra y escri*,ra en e+ ),er*o serie se+eccionado&
Por e5e-)+o, siendo e+ ),er*o serie si7,ien*e& /de0/**yS1,
e5ec,*ar e+ co-ando&
c)mod *** (de'(ttyS+

Para e5ec,ci%n con Pro<y, es necesario ,sar +os )ar?-e*ros de -?>,ina
0ir*,a+ M:!N http.proxyHost MKos* de+ )ro<yN, http.proxyPort MP,er*o de
esc,cha de+ )ro<yN, http.proxyUser MCs,ario de acceso a+ Pro<y, en caso
de e<is*irN, http.proxyPassword MPassAord de+ ,s,ario de acceso a+ Pro<yN
Cn e5e-)+o de scri)* con e5ec,ci%n co-)+e*a de +a a)+icaci%n de )r,e/as
se ),ede encon*rar en e+ fichero Ui-)+an*ado/a*V, inc+,ido en +a car)e*a
Usa-)+esV de +a ins*a+aci%n de ;)0)c6-)+an*ado




28/08/2014
Versin: 2.27

95

=,n*o con +a +i/rerHa se dis*ri/,ye e+ archi0o caTpvpcImplantado.3)s
con +os cer*ificados de $erisi7n necesarios )ara +a co-,nicaci%n SS( en
e+ en*orno de REA( y !ESARRE((E Es*e fichero de/e es*ar en e+
direc*orio de e5ec,ci%n de +a a)+icaci%n, )ara e+ correc*o f,nciona-ien*o
de +a +i/rerHa
Gi 5uese necesaria la actuali7acin de estos certi5icados6 se podrC
descargar la Hltima versin disponi&le de la li&rer0a6 solicitar este
arc?ivo a tpvpc\redsBs.es o reali7arlo de 5orma manual ')eBtool
necesario para generar el 5ormato <TG*. (ara la descarga
manual6 se pueden descargar desde un navegador de la =4/
?ttpsA>>tpvpc.sermepa.es>T(.X(C>entrada
Si +a +i/rerHa re>,iere +a 7eneraci%n de ,n fichero de (o7, Ss*e se
ac*i0ar? de -anera re-o*a en caso de incidencia Se 7enerar? en e+
direc*orio de e5ec,ci%n de +a a)+icaci%n con e+ no-/re
logDllImplantado.t;t

Integracion TPVPC Implantado

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Integracion TPVPC Implantado

Cargado por

Copyright:

Formatos disponibles

Integracion TpvpcImplantado Integracion TpvpcImplantado Integracion TpvpcImplantado Integracion TpvpcImplantado

También podría gustarte