Manual DLL VPOS EMV Solutions Systems 2526

MANUAL DLL VPOS
(EMV) VER. 1.1

Solutions Systems 2526, C.A. R.I.F. Nº. : J-31599417-8
Solutions Systems 2526, C.A.
Av. Francisco de Miranda. Torre Profesional la California, Piso 5. Oficina 5-6. La california Norte.
Municipio Sucre. Edo Miranda. Caraca, Venezuela, +582129352526
Declaración de Edición de Software
El Manual de integración del VPOS (EMV) para Windows 7 (x86), Windows Vista (x86), Windows XP
(x86), Windows 2000, Windows ME y Windows 98 SE, versión de Software 1.1.0.1015, lanzado en 2
Abril del 2011. Hecho en Venezuela.
Declaración de Derechos de Autor (Copyright)
Copyright © 2010 Solutions Systems 2526, C.A. Todos los derechos reservados en el mundo. Se
prohíbe la reproducción, traducción, transformación o adaptación de cualquier tipo sin el previo
permiso escrito de Solutions Systems 2526, C.A.
Declaración de Licencia
El software descrito en este documento es suministrado bajo un acuerdo de licencia. El software sólo
puede ser usado en conformidad con los términos del acuerdo de licencia aceptados en el momento
de su uso en producción.
Declaración de Garantía
Solutions Systems 2526, C.A., se reserva el derecho de revisar esta publicación y realizar cambios al
contenido de la misma sin la obligación de notificar a alguna persona u organización de tal revisión o
los cambios.
Solutions Systems 2526, C.A. Ofrece esta publicación “tal como está”, sin garantía de ningún tipo, ya
sea expresa o implícita, incluyendo pero no limitada a las garantías tácitas de comerciabilidad o
idoneidad para un propósito particular.
Este manual va dirigido
Al personal desarrollador de las diferentes casas de software que tengan la firme intención de
integrar en su software de caja el VPOS (EMV)
Av. Francisco de Miranda. Torre Profesional La California. Piso 5. Oficina 5-6. California Norte. Edo. Miranda.
Telf. (0212) 8315708 / 9352526
Todos los derechos reservados sobre este documento y su contenido.

REVISIONES
Versión Manual Versión DLL Fecha Elaborado por: Revisado por: Observaciones
1.0 1.1.0.1015 06/04/20 Ing. Victor Elaboración del
11 Vera documento
Ing. Jonathan incorporando las
Clavijo principales 3
funciones y
elementos
necesarios para
realizar una
integración con el
VPOS desarrollado
por Solutions
Systems 2526, C.A.
1.1 1.1.0.1035 19/04/20 Ing. Victor En esta versión se
11 Vera reordenan las
funciones de la DLL
de acuerdo a su
jerarquía.
Descarte de la
función Buscabin,
Buscabinmb y
config.
Corrección de
redacción.
Corrección de la
función ultima.
Telf. (0212) 8315708 / 9352526

1. CONSIDERACIONES PREVIAS AL DESARROLLO CON VPOS EN FORMATO DLL
- Las funciones de la DLL deben ser declaradas en letra minúsculas.
- Tomando en cuenta los caracteres introducidos en las nuevas tarjetas con CHIP y el
lenguaje de programación implementado en el desarrollo fue utilizado el tipo de datos 4
PCHART por lo que debe ser utilizado en las declaraciones de las funciones y sus variable
según el presente manual manejen ese tipo de datos o el equivalente dependiendo del
lenguaje en el que se desarrolle la integración. De igual forma, serán representadas las
respuestas en el formato expresado en la tabla N°1.
Código de Separador Mensaje Separador Path o ruta del

Respuesta. relacionado al archivo
código. generado.
XX Coma (,) MENSAJE Coma (,) C:\SS2526\
Tabla N°1
EJEMPLOS:
00,APROBADO,C:\SS2526\SALIDA.TXT
12, TRANSACCION INVALIDA, C:\SS2526\NEGADA.TXT
00, CIERRE REALIZADO, C:\SS2526\CIERRES.TXT
Ver listado de Código de Respuesta en el Anexo 1.
- La DLL debe de estar ubicada en la ruta C:\SS2526\ para su correcto funcionamiento. En los
casos que esta posea la ruta de las versiones anteriores puede mantenerse.
Telf. (0212) 8315708 / 9352526

2. FUNCIONES DE LA DLL.
2.1. Función Venta: Utilizada para obtener la aprobación a una transacción financiera de
una tarjeta de crédito/Debito/American Express. Envía la transacción y espera por una respuesta
del servidor. En caso de aprobado generara un archivo llamado Salida.txt y en caso de negada
generara un archivo llamado negada.txt.
5
2.1.1. Sintaxis:
Ejemplo: venta (“P”, “P”, “P”, “P”, monto, “P”: String): PChar;
El único valor para esta versión permitido como variable y obligatoria es el monto el cual debe
estar multiplicado por 100 para obtener un valor sin decimales según se muestra en el ejemplo:
Monto de la compra: 36,50 BsF.

Multiplico por 100: 3650
El valor a enviar a la función venta es de 3650 para un compra de 36,50. Este valor posee una
longitud máxima de 12 caracteres.
Los demás campos deben ser declarados con la letra “P” en mayúscula.
2.1.2. Respuesta Función Venta:

Ejemplo: “00, Aprobado, c:\ss2526\salida.txt”
Campo Descripción Tipo

Resultado 00 si es aprobado, otro valor según Anexo 1 String
Mensaje Texto del mensaje a mostrar en pantalla String
Archivo Ruta y nombre del archivo generado String
Telf. (0212) 8315708 / 9352526

2.2. Función Venta Crédito: Utilizada para obtener la aprobación a una transacción
financiera de una tarjeta de crédito (Visa y Mastercard). Envía la transacción y espera por una
respuesta del servidor. En caso de aprobado genera un archivo llamado Salida.txt y en caso de
negada generara un archivo llamado negada.txt.
6
2.2.1. Sintaxis:
Ejemplo: ventac (“P”, “P”, “P”, “P”, monto, “P”: String): PChar;

El valor a enviar a la función venta es de 3650 para un compra de 36,50 BsF. Este valor posee una
2.2.2. Respuesta Función ventac:

Telf. (0212) 8315708 / 9352526

2.3. Función Venta Debito: Utilizada para obtener la aprobación a una transacción
financiera de una tarjeta de débito (Maestro y Electron). Envía la transacción y espera por una
respuesta del servidor. En caso de aprobado genera un archivo llamado Salida.txt y en caso de
negada generara un archivo llamado negada.txt.
7
2.3.1. Sintaxis:
Ejemplo: ventad (“P”, “P”, “P”, “P”, monto, “P”: String): PChar;

2.3.2. Respuesta Función ventad:


Telf. (0212) 8315708 / 9352526

2.4. Función Venta Amex: Utilizada para obtener la aprobación a una transacción financiera
de una tarjeta de American Express. Envía la transacción y espera por una respuesta del
servidor. En caso de aprobado genera un archivo llamado Salida.txt y en caso de negada
generara un archivo llamado negada.txt.
8
2.4.1. Sintaxis:
Ejemplo: ventaa (“P”, “P”, “P”, “P”, monto, “P”: String): PChar;

longitud máxima de 10 campos.
2.4.2. Respuesta Función ventaa:


Telf. (0212) 8315708 / 9352526

2.5. Función Anulación: Utilizada para anular las transacciones de compra que fueron
aprobadas y que se encuentran registradas en lote del VPOS. Esta función anulara solo las
transacciones que no han sido cerradas, una vez las transacciones sean cerradas esta función no
aplica. Envía la transacción y espera por una respuesta del servidor. En caso de aprobado genera
un archivo llamado Salida.txt y en caso de negada genera un archivo llamado negada.txt. 9
2.5.1. Sintaxis:
Ejemplo: anulacion (“P”, “P”, “P”: String): PChar;
Todos los valores deben ser declarados con la letra “P” en mayúscula
2.5.2. Respuesta Función anulación:


Telf. (0212) 8315708 / 9352526

2.6. Función Resumen Crédito: Retorna el texto a emitir del resumen correspondiente al
total de transacciones financieras de Crédito y Extrafinanciamiento almacenadas en el VPOS.
En caso de aprobado genera un archivo llamado resumenc.txt.
2.6.1. Sintaxis:
10
Ejemplo: emiterescr ( ): PChar;
2.6.2. Respuesta Función emiterescr:

Ejemplo: “00, Aprobado, c:\ss2526\resumenc.txt”

Resultado 00 para “Resumen Finalizado” String
Telf. (0212) 8315708 / 9352526

2.7. Función Resumen Debito: Retorna el texto a emitir del resumen correspondiente al
total de transacciones financieras de débito almacenadas en el VPOS. En caso de aprobado
genera un archivo llamado resumend.txt.
2.7.1. Sintaxis:
11
Ejemplo: emiteresdb ( ): PChar;
2.7.2. Respuesta Función emiteresdb:

Ejemplo: “00, Aprobado, c:\ss2526\resumend.txt”

Telf. (0212) 8315708 / 9352526

2.8. Función Resumen Amex: Retorna el texto a emitir del resumen correspondiente al total
de transacciones financieras de Amex almacenadas en el VPOS. En caso de aprobado generar
un archivo llamado resumena.txt.
2.8.1. Sintaxis:
Ejemplo: emiteresam ( ): PChar; 12
2.8.2. Respuesta Función emiteresam:

Ejemplo: “00, Aprobado, c:\ss2526\resumena.txt”

Telf. (0212) 8315708 / 9352526

2.9. Función Cierre: Realiza el depósito de los lotes registrados en la caja, esta transacción
permite informar acerca del total de transacciones financieras realizadas en el VPOS. En caso
de aprobado genera un archivo llamado cierres.txt.
2.9.1. Sintaxis:
Ejemplo: cierre ( ): PChar;
13
2.9.2. Respuesta Función cierre:

Ejemplo: “00, Aprobado, c:\ss2526\cierres.txt”

Resultado 00 para “CIERRE FINALIZADO” String
Telf. (0212) 8315708 / 9352526

2.10. Función Cierre Crédito: Realiza el depósito de los lotes de crédito registrados en la
caja, esta transacción permite informar acerca del total de transacciones financieras realizadas
en el VPOS. En caso de aprobado genera un archivo llamado cierrec.txt.
2.10.1. Sintaxis:
Ejemplo: cierrec ( ): PChar;
14
2.10.2. Respuesta Función cierrec:

Ejemplo: “00, Aprobado, c:\ss2526\cierrec.txt”

Telf. (0212) 8315708 / 9352526

2.11. Función Cierre Debito: Realiza el depósito de los lotes de débito registrados en la caja,
esta transacción permite informar acerca del total de transacciones financieras realizadas en el
VPOS. En caso de aprobado generar un archivo llamado cierred.txt.
2.11.1. Sintaxis:
15
Ejemplo: cierred ( ): PChar;
2.11.2. Respuesta Función cierred:

Ejemplo: “00, Aprobado, c:\ss2526\cierred.txt”

Telf. (0212) 8315708 / 9352526

2.12. Función Cierre Amex: Realiza el depósito de los lotes de AMEX registrados en la caja,
esta transacción permite informar acerca del total de transacciones financieras Amex realizadas
en el POS. En caso de aprobado generar un archivo llamado cierrea.txt.
2.12.1. Sintaxis:
Ejemplo: cierrea ( ): PChar;
16
2.12.2. Respuesta Función cierrea:

Ejemplo: “00, Aprobado, c:\ss2526\cierrea.txt”

Telf. (0212) 8315708 / 9352526

2.13. Función Cierre Extrafinanciamiento: Realiza el depósito de los lotes de

EXTRAFINANCIAMIENTO registrados en la caja, esta transacción permite informar acerca
del total de transacciones financieras realizadas en el VPOS. En caso de aprobado genera un
archivo llamado cierree.txt.
2.13.1. Sintaxis:
17
Ejemplo: cierreE ( ): PChar;
2.13.2. Respuesta Función cierreE:

Ejemplo: “00, Aprobado, c:\ss2526\cierree.txt”

Telf. (0212) 8315708 / 9352526

2.14. Función Emite Copia: retorna como copia el último recibo emitido por el VPOS para el
caso de una transacción de venta o anulación. En caso de aprobado genera un archivo llamado
copia.txt.
2.14.1. Sintaxis:
Ejemplo: emitecopia ( ): PChar;
18
2.14.2. Respuesta Función emitecopia:

Ejemplo: “00, Aprobado, c:\ss2526\copia.txt”

Resultado 00 para “COPIA DISPONIBLE” String
Telf. (0212) 8315708 / 9352526

2.15. Función Última: retorna los valores de la última transacción aprobada.
2.15.1. Sintaxis:
Ejemplo: ultima ( ): PChar;
19
2.15.2. Respuesta Función ultima:
Ejemplo: “00, D, MAESTRO, 603644****2548, 12345, 12312345, 00123, 0, 0, 0, BANCO
SS2526, BANCO PRUEBA, 120”

Tipo tarjeta Tipo de tarjeta (D para Debito, C para Crédito, A para American Express String
Nombre Nombre de tarjeta utilizada (MAESTRO, ELECTRON, VISA, MASTERCAR) String
Numero Número de tarjeta utilizada String
Aprobado Numero de aprobación de transacción String
Lote/Ref Número de lote (3 primeros) y referencia String
Trace Numero de referencia interna de transacción String
Descuento Monto de descuento String
Cupones Monto de cupones utilizados de programa JUNTOSBDV String
Puntos Monto en puntos de programa JUNTOSBDV String
Banco Nombre del banco que aprobó la transacción String
Banco Producto Nombre del banco propietaria de la tarjeta aprobada String
Monto Valor de la transacción aprobada String
Telf. (0212) 8315708 / 9352526

2.16. Función Consulta Puntos: permite consultar el saldo y los puntos disponibles de una
tarjeta habiente. Para esta versión esta función solo es permitida en modo Banda no está
disponible aun para EMV. En caso de aprobado genera un archivo llamado Salida.txt y en caso
de negada generara un archivo llamado negada.txt.
2.16.1. Sintaxis:
20
Ejemplo: consultap (“P”, “P”, “P”, “P”, cod: String): PChar;
2.16.2. Respuesta Función consultap:


Telf. (0212) 8315708 / 9352526

3.0. PROPUESTA DE PROCESO DE INTEGRACION
3.1. Diagrama propuesto de desarrollo de proyecto e involucrados.
SOLICITUD DE PROCESO
DE INTEGRACION POR 21
PARTE DEL BANCO
TIEMPOS INVOLUCRADOS
REUNION PRE PROYECTO

EN LA QUE SE ENTREGA INTEGRADOR
1 SEMANA DOCUMENTACION PIN
PAD DE DESARROLLO Y
SE ACLARAN DUDAS
ANALISIS DE
DOCUMENTACION Y INTEGRADO
1 SEMANA
DISEÑO DE INTEGRACION R
PROGRAMACION E
INTEGRACION DEL VPOS
1 SEMANA EN SOFTWARE DE CAJA INTEGRADO
R
CERTIFICACION Y INTEGRADOR /
PRUEBAS PILOTO SOLUTIONS SYSTEMS
1 SEMANA 2526, CA.
MASIFICACION DE LA INTEGRADOR /
1 SEMANA SOLUCION EN TODAS LAS SOLUTIONS SYSTEMS
CAJAS DEL COMERCIO 2526, CA.
TIEMPO TOTAL ESTIMADO

PARA EL DESARROLLO DEL
PROYECTO 5 SEMANAS
Telf. (0212) 8315708 / 9352526

3.2. Tareas de facturación y venta.

Funciones de la DLL
Declaradas
22
Totalizar el monto a
procesar por VPOS
Llamar a la función venta deseada y enviar

el monto como único campo variable REINTENTO
APROBADA NEGADA
Recibida la respuesta aprobada Recibida la respuesta negada

mostrar el mensaje en pantalla e mostrar el mensaje en pantalla e
imprimir el comprobante imprimir el comprobante
correspondiente a la ruta correspondiente a la ruta
En caso de ser necesario pueden En caso de ser requerido se puede

tomarse los datos de la última realizar la impresión de la última
transacción llamando a la función transacción aprobada con la
ultima, buscabin y bucabimb función
Cierre de la factura y del

proceso de Venta
Telf. (0212) 8315708 / 9352526

3.3. Tareas de resumen y cierres.
Funciones de la DLL
Declaradas
23
Resumen Crédito Resumen Debito Resumen Amex

(emiterescr) (emiteresdb) (emiteresam)
Recibida la respuesta aprobada mostrar el mensaje

en pantalla e imprimir el comprobante
correspondiente a la ruta
Cierre Crédito Cierre Debito Cierre Amex Cierre Total

(cierrec) (cierred) (cierrea) (cierre)
Recibida la respuesta aprobada mostrar el mensaje

en pantalla e imprimir el comprobante
correspondiente a la ruta
Telf. (0212) 8315708 / 9352526

4.0. Ejemplos de declaraciones y llamados a la DLL
24
Dependiendo del lenguaje de programación es necesaria la declaración de cada una de las
funciones de la DLL, a continuación se puede ver ejemplos de la declaración de la función Venta.
4.1. Visual Basic 6.
4.1.1. Declaración de la DLL en Visual Basic 6.0:
Private Declare Function venta Lib "C:\ss2526\vpos.dll" (ByVal track1 As String, ByVal track2 As
String, ByVal cedula As String, ByVal vcc As String, ByVal monto As String, ByVal tipo As String) As
String
Private Declare Function ventaa Lib "C:\ss2526\vpos.dll" (ByVal track1 As String, ByVal track2 As
String
Private Declare Function ventac Lib "C:\ss2526\vpos.dll" (ByVal track1 As String, ByVal track2 As
String
Private Declare Function ventad Lib "C:\ss2526\vpos.dll" (ByVal track1 As String, ByVal track2 As
String
Private Declare Function anulacion Lib "C:\ss2526\vpos.dll" (ByVal track1 As String, ByVal track2 As
String, ByVal refrencia As String) As String
Private Declare Function emiteresdb Lib "C:\ss2526\vpos.dll" () As String
Private Declare Function emiterescr Lib "C:\ss2526\vpos.dll" () As String
Private Declare Function emiteresam Lib "C:\SSvpos.dll" () As String
Private Declare Function cierrec Lib "C:\ss2526\vpos.dll" () As String
Private Declare Function cierred Lib "C:\ss2526\vpos.dll" () As String
Telf. (0212) 8315708 / 9352526

Private Declare Function cierrea Lib "C:\ss2526\vpos.dll" () As String
Private Declare Function cierreE Lib "C:\ss2526\vpos.dll" () As String
Private Declare Function cierre Lib "C:\ss2526\vpos.dll" () As String
Private Declare Function emitecopia Lib "C:\ss2526\vpos.dll" () As String
Private Declare Function ultima Lib "C:\ss2526\vpos.dll" () As String

25
4.1.2. Ejemplo de llamado de las funciones de la DLL en Visual Basic:
Dim retorno as string

retorno = venta("P", "P", "P", "P", txt_monto.Text * 100, "P")
msgbox retorno
retorno = emiterescr
msgbox retorno
retorno = ultima
msgbox retorno
retorno = ultima
msgbox retorno
4.2 . FoxPro 9.
4.2.1. Declaración de la DLL en FoxPro:
DECLARE string venta IN C:\ss2526\vpos.dll string track1, string track2,string cedula, string
vcc, string monto, string tipo
DECLARE string ventac IN C:\ss2526\vpos.dll string track1, string track2,string cedula, string
DECLARE string ventad IN C:\ss2526\vpos.dll string track1, string track2,string cedula, string
DECLARE String anulacion IN C:\ss2526\vpos.dll String track1, String track2, String refrencia
DECLARE String cierre IN C:\ss2526\vpos.dll
DECLARE String cierrec IN C:\ss2526\vpos.dll

Telf. (0212) 8315708 / 9352526

DECLARE String cierred IN C:\ss2526\vpos.dll
DECLARE String cierrea IN C:\ss2526\vpos.dll
DECLARE String ultima IN C:\ss2526\vpos.dll
DECLARE String emiteresdb IN C:\ss2526\vpos.dll

26
DECLARE String emiterescr IN C:\ss2526\vpos.dll
DECLARE String emiteresam IN C:\ss2526\vpos.dll
4.2.2. Ejemplo de llamado de las funciones de la DLL en FoxPro:
local respuesta as String

respuesta = venta("P", "P", "P", "P", "100", "P")
MESSAGEBOX(respuesta)
respuesta = anulacion("P","P","P")
respuesta = cierre()
respuesta = emiterescr()
4.3. Visual Basic Net 2008
4.3.1. Declaración de la DLL en Visual Basic Net 2008
Declare Function venta Lib "C:\SS2526\vpos.dll" (ByVal track1 As String, ByVal track2 As String, ByVal
cedula As String, ByVal vcc As String, ByVal monto As String, ByVal tipo As String) As IntPtr
Declare Function ventac Lib "C:\SS2526\vpos.dll" (ByVal track1 As String, ByVal track2 As String, ByVal
cedula As String, ByVal vcc As String, ByVal monto As String, ByVal tipo As String) As IntPtr
Declare Function emiterescr Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function emiteresdb Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function emiteresam Lib "C:\SS2526\vpos.dll" () As IntPtr
Telf. (0212) 8315708 / 9352526

Declare Function config Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function cierre Lib "c:\SS2526\vpos.dll" () As IntPtr
Declare Function anulacion Lib "c:\SS2526\vpos.dll" (ByVal track1 As String, ByVal track2 As String, ByVal
referencia As String) As IntPtr
Declare Function emitecopia Lib "c:\SS2526\vpos.dll" () As IntPtr

27
Declare Function ultima Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function leebanda Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function leetracks Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function abrevpn Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function cierravpn Lib "C:\SS2526\vpos.dll" () As IntPtr
Declare Function buscabin Lib "C:\SS2526\vpos.dll" (ByVal track1 As String, ByVal track2 As String) As
IntPtr
4.3.2. Ejemplo de llamado de las funciones de la DLL en Visual Basic Net 2008
Dim retorno As String

retorno = venta("P", "P", "P", "P", 100, "P")
MsgBox(retorno)
4.4. Delphi 2009
4.4.1. Declaración de la DLL en Delphi 2009
var
Form1: TForm1;
function venta(track1, track2, cedula,vcc,monto,tipo:String): Pchar;stdcall external
'c:\ss2526\vpos.dll';
Telf. (0212) 8315708 / 9352526

function anulacion(track1,track2,refrencia:String): Pchar;stdcall external 'c:\ss2526\vpos.dll';
function cierre(): Pchar;stdcall external 'c:\ss2526\vpos.dll';

function emiterescr(): Pchar;stdcall external 'c:\ss2526\vpos.dll';
function emiteresdb(): Pchar;stdcall external 'c:\ss2526\vpos.dll';
function emiteresam(): Pchar;stdcall external 'c:\ss2526\vpos.dll';
implementation
28
4.2.1. Ejemplo de llamado de las funciones de la DLL en Delphi 2009
procedure TForm1.Button1Click(Sender: TObject);

var
monto, respuesta:String;
begin
if edit1.Text<>'' then
begin
monto:= InttoStr(StrToInt(edit1.Text) * 100);
respuesta:=venta('P','P','P','P',monto,'P');
showmessage(respuesta);
end
else
begin
showmessage('Digite Monto por Favor');
end;
end;
Telf. (0212) 8315708 / 9352526

ANEXO 1
Mensajes de respuesta más comunes

Los mensajes de respuesta se componen de un código numérico y un mensaje descriptivo, generados
por el banco o el VPOS y presentados por la pantalla de la caja para indicarle al cajero si se puede o no
29
aceptar el pago. Se detallan a continuación los mensajes más comunes:
Código Mensaje Descripción / Acción

00 APROBADA El pago fue aprobado por el banco.
01,02 LLAMAR AL BANCO EMISOR No se acepta el pago. El cliente debe llamar al banco
para resolver la situación. Utilice otra forma de pago.
03 COMERCIO INVALIDO Hay un problema de configuración de terminal
bancario. Comuníquese con y notifique la falla.
05 NO ACEPTE LA TARJETA No se acepta el pago por condiciones especiales de la
cuenta del cliente. Utilice otra forma de pago.
08 EMISOR NO RESPONDE El banco emisor de la tarjeta no está respondiendo.
Puede estar caído. Use una tarjeta de otro banco.
14 NUMERO DE TARJETA INVALIDO El número de tarjeta o la cuenta indicada (tarj. de
débito) es inválida para retiro de fondos. Intente
nuevamente y verifique la cuenta utilizada.
41 LA TARJETA ESTA EXTRAVIADA La tarjeta en uso fue reportada como perdida. El
cliente debe comunicarse con el banco. Use otra
forma de pago.
43 LA TARJETA ES ROBADA La tarjeta en uso fue reportada como robada. El
cliente debe comunicarse con el banco. Use otra
forma de pago.
45 LA CEDULA ES INCORRECTA La cédula ingresada es incorrecta. Intente
nuevamente y verifique el número de cédula.
51 NO TIENE CREDITO DISPONIBLE La tarjeta no tiene suficientes fondos para pagar el
monto solicitado. Intente el pago por un monto
menor o use otra forma de pago.
54 LA TARJETA ESTA EXPIRADA La tarjeta está vencida. El cliente debe renovarla en el
banco. Use otra forma de pago.
55 EL PIN ES INCORRECTO La clave ingresada por el cliente es incorrecto. Intente
nuevamente y verifique la clave ingresada.
57 TRANSACCIÓN NO PERMITIDA La tarjeta no está programada para pagar en este
Telf. (0212) 8315708 / 9352526

establecimiento. Use otra forma de pago y

comuníquese con el banco.
62 LA TARJETA ESTA RESTRINGIDA El banco ha bloqueado el uso de la tarjeta por falta de
pago del cliente. Use otra forma de pago y verifique la
deuda acumulada de su tarjeta.
75 ENTRADA MAX DE PIN EXCEDIDA (Tarj. de débito) El cliente ha ingresado una clave
inapropiada demasiadas veces y la tarjeta ha sido
bloqueada. Use otra forma de pago y comuníquese 30
con el banco para desbloquear la tarjeta.
91 EL EMISOR NO RESPONDE El banco emisor de la tarjeta no está respondiendo.
Puede estar caído. Use una tarjeta de otro banco.
92 NO PUDO RUTEAR LA TRANSACC. El banco emisor está inactivo. Use alguna forma de
pago de otro banco.
XX NO ADMITIDA PARA DEBITO La tarjeta tiene un problema en la banda, o no fue
leída correctamente. Vuelva a deslizar la tarjeta de
extremo a extremo con un movimiento continuo.
01 HOST NO RESPONDE Hay problemas de comunicación con el banco.
Garantice que la conexión al banco está activa. Si hay
un servidor de VPOS, garantice que el servidor está
encendido, conectado a la red y operando.
XX DEPOSITE LOTE El lote de aprobaciones desde el último cierre es muy
grande. Por medidas de seguridad ejecute el cierre de
VPOS. Después del cierre podrá seguir operando
normalmente.
Telf. (0212) 8315708 / 9352526

ANEXO 2
Mensajes de respuesta más comunes para American Express
Código Mensaje
00 APROBADO 31
02 LLAMAR AUT. AMEX
03 COMERCIO INVALIDO
04 RETENER Y LLAMAR
05 NEGADA
08 EMISOR NO RESPONDE
12 TRANSACCION INVALIDA
13 MONTO INVALIDO
14 TARJETA INVALIDA
19 TRATE DE NUEVO
87 ERROR EN LLAVE
91 EMISOR NO ACTIVO
92 EMISOR INVALIDO
96 EMISOR INACTIVO
Default LLAMAR AUT. AMEX
Telf. (0212) 8315708 / 9352526

Glosario de Términos
Término Concepto/Descripción
ADQUIRIENTE Entidad que mantiene relación con los comercios y está autorizada
para recibir (adquirir) la data de transacción comunicada desde sus
puntos de venta y gestionar la autorización con el emisor de la tarjeta,
o con la marca de la misma (VISA, MC). 32
Afiliación Es el código de relación comercial entre el Banco y el Comercio, este

define a que Banco y cuenta del comercio se va a depositar el dinero.
AMEX American Express
BIN Número de Identificación de Banco (Bank Identification Number) Son

los primeros seis dígitos de una tarjeta de crédito Estos dígitos
identifican la red a la que pertenece la tarjeta así como el banco que la
público o realizó su emisión.
Caja Es el dispositivo que procesa las transacciones bancarias (en caso de
que use VPOS) y las operaciones de cobro del comercio.
CODIGO ALFA Código de validación de 4 dígitos usado en las tarjetas American

Express, impreso en el frente y encima del embosado del número de
tarjeta.
Comercio Entidad comercial que agrupa una o más tiendas. Cada comercio tiene
una serie de afiliaciones y tiene un administrador que define las reglas
de VPOS para las cajas, las tiendas o todo el comercio.
CVC2 Código de validación de 3 dígitos en las tarjetas MC, impreso en la
parte posterior de la tarjeta.
CVV2 Código de validación de 3 dígitos en las tarjetas Visa, impreso en la

parte posterior de la tarjeta.
Emisor Empresa que emite tarjetas electromagnéticas de créditos o debitó de

representación exclusiva.
Telf. (0212) 8315708 / 9352526

Término Concepto/Descripción
PIN Número de identificación Personal (Personal Identification Number)
Los números de identificación personal se utilizan normalmente para
el uso de cajeros automáticos o para servicios de sistemas en línea
donde se pueda comprobar su uso como una contraseña de seguridad
PINpad Es un dispositivo que maneja el montaje o captura de paquetes de
datos bancarios. En nuestro caso esta conectado al puerto de una caja 33
registradora y se usa para la captura de los datos de la banda
magnética y del PIN.
Terminal Es el identificador lógico para cada punto por donde van a pasar
transacciones bancarias (este es un numérico), este número de
terminal es único para cada caja dentro de un comercio.
Tienda Para Multi VPOS una tienda es – o puede ser -, un local físicamente
separado que opera bajo el mismo comercio y que puede estar en
cualquier localidad geográfica.
Turno Periodo del día en que se puede aplicar una regla. Se pueden crear
hasta cuatro (4) turnos en el día.
Regla Conjunto de instrucciones que definen cómo se van a repartir las
transacciones de una caja. Cada comercio tiene definido un usuario
que puede definir las reglas con las que operan las cajas de su
comercio, así como turno y día de la semana en la que se activa la
regla.
Telf. (0212) 8315708 / 9352526

Información de Servicio
Sitio Corporativo
34
Web: http://www.ss2526.com
Call Center
Teléfono +58 212 9352526 / 212 8315708
Email: [email protected]
Telf. (0212) 8315708 / 9352526

Manual DLL VPOS EMV Solutions Systems 2526

Cargado por

Copyright:

Formatos disponibles

Manual DLL VPOS EMV Solutions Systems 2526

Cargado por

Información del documento

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

Manual DLL VPOS EMV Solutions Systems 2526

Cargado por

Copyright:

Formatos disponibles

MANUAL DLL VPOS

(EMV) VER. 1.1

Solutions Systems 2526, C.A.

Declaración de Edición de Software

Declaración de Derechos de Autor (Copyright)

Este manual va dirigido

Todos los derechos reservados sobre este documento y su contenido.

Todos los derechos reservados sobre este documento y su contenido.

1. CONSIDERACIONES PREVIAS AL DESARROLLO CON VPOS EN FORMATO DLL

- Las funciones de la DLL deben ser declaradas en letra minúsculas.

Código de Separador Mensaje Separador Path o ruta del

Ver listado de Código de Respuesta en el Anexo 1.

Todos los derechos reservados sobre este documento y su contenido.

Monto de la compra: 36,50 BsF.

2.1.2. Respuesta Función Venta:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

Monto de la compra: 36,50 BsF.

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

Monto de la compra: 36,50 BsF.

2.3.2. Respuesta Función ventad:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

Monto de la compra: 36,50 BsF.

2.4.2. Respuesta Función ventaa:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.5.2. Respuesta Función anulación:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.6.2. Respuesta Función emiterescr:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.7.2. Respuesta Función emiteresdb:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.8.2. Respuesta Función emiteresam:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.9.2. Respuesta Función cierre:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.10.2. Respuesta Función cierrec:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.11.2. Respuesta Función cierred:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.12.2. Respuesta Función cierrea:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.13. Función Cierre Extrafinanciamiento: Realiza el depósito de los lotes de

2.13.2. Respuesta Función cierreE:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.14.2. Respuesta Función emitecopia:

Campo Descripción Tipo

Todos los derechos reservados sobre este documento y su contenido.

2.15. Función Última: retorna los valores de la última transacción aprobada.