VeriFone Access Client Protocol

7/23/2019 VeriFone Access Client Protocol

1/67

Product

Page 1

VeriFone AccessVATS 2.6 PAYware Integra

Protocolo de Integracin

VATS 2.6-PAYware IntegraProtocolo de Integracin

Copyright 2009. VeriFone, Inc. All rightsreserved.


2/67

Product

Page 2



VeriFone Access and PAYWARE INTEGRA is a trademark of VeriFone.All other product and company names mentioned are the trademarks of their respective owners.

This publication is for information purposes only and its content does not represent a contract in anyform. VeriFone reserves the right to alter product specifications without notice.

Indice

INTRODUCCIN ........................................................................................................................................................................... 6

PROTOCOLO DE INTEGRACIN .................................................................................................................................................... 7

PROTOCOLO DE COMUNICACIN ............................................................................................................................................................. 7

TERMINAL .................................................................................................................................................................................... 8

ESTATUS DE UNA TERMINAL .................................................................................................................................................................... 8

SOLICITUD DEL ESTATUS DE UNA TERMINAL .............................................................................................................................................. 10

Ejemplos de solicitud de estatus ............................................................................................................................................... 10

MENSAJE DE RESPUESTA DEL ESTATUS .................................................................................................................................................... 11

Ejemplos de respuesta de estatus............................................................................................................................................. 12

TRANSACCIONES SOPORTADAS ................................................................................................................................................. 13

FLUJO DE OPERACIN DE CARGOS A TARJETAS ......................................................................................................................... 15

CONTROL DE EXCEPCIONES ................................................................................................................................................................... 16

REVERSOS AUTOMTICOS .................................................................................................................................................................... 16

CARGO ....................................................................................................................................................................................... 18

Referencias de la transaccin ................................................................................................................................................... 18

Opciones de promocin ............................................................................................................................................................ 18

Soporte de transacciones con propina para restaurantes ........................................................................................................ 19

Otras opciones .......................................................................................................................................................................... 19

CARGOS MOTO ................................................................................................................................................................................ 19

CARGOS RECURRENTES ........................................................................................................................................................................ 19

ENVO DE LA INFORMACIN DE LA TARJETA DE CRDITO A PAYWARE INTEGRA. ............................................................................................... 20

MENSAJE DE SOLICITUD DE CARGO ........................................................................................................................................................ 21

Ejemplos de solicitud de Cargo ................................................................................................................................................. 22

MENSAJE DE RESPUESTA DE CARGO ....................................................................................................................................................... 23

Ejemplos de respuesta de Cargo ............................................................................................................................................... 24

DEVOLUCIN ............................................................................................................................................................................. 26

MENSAJE DE SOLICITUD DE DEVOLUCIN ................................................................................................................................................ 26

Ejemplos de solicitud de Devolucin ......................................................................................................................................... 27

MENSAJE DE RESPUESTA DE DEVOLUCIN ............................................................................................................................................... 27

Ejemplos de respuesta de Devolucin....................................................................................................................................... 28

CANCELACIN............................................................................................................................................................................ 30


3/67

Product

Page 3



MENSAJE DE SOLICITUD DE CANCELACIN ............................................................................................................................................... 30

Ejemplos de solicitud de Cancelacin ....................................................................................................................................... 30

MENSAJE DE RESPUESTA DE CANCELACIN .............................................................................................................................................. 31

Ejemplos de respuesta de Cancelacin ..................................................................................................................................... 32

DIFERENCIAS ENTRE DEVOLUCIN Y CANCELACIN .................................................................................................................. 33

CHECK-IN ................................................................................................................................................................................... 34

MENSAJE DE SOLICITUD DE CHECK-IN ..................................................................................................................................................... 34

Ejemplos de solicitud de Check-In ............................................................................................................................................. 35

MENSAJE DE RESPUESTA DE CHECK-IN .................................................................................................................................................... 35

Ejemplos de respuesta de Check-In........................................................................................................................................... 36

RE-AUTORIZACIN DE CHECK-IN................................................................................................................................................ 37

MENSAJE DE SOLICITUD DE RE-AUTORIZACIN DE CHECK-IN ....................................................................................................................... 37

Ejemplos de solicitud de Re-autorizacin de Check-In .............................................................................................................. 37

MENSAJE DE RESPUESTA DE RE-AUTORIZACIN DE CHECK-IN ...................................................................................................................... 38Ejemplos de respuesta de Re-autorizacin de Check-In ............................................................................................................ 38

CHECK-OUT ................................................................................................................................................................................ 39

MENSAJE DE SOLICITUD DE CHECK-OUT .................................................................................................................................................. 39

Ejemplos de solicitud de Check-Out .......................................................................................................................................... 39

MENSAJE DE RESPUESTA DE CHECK-OUT ................................................................................................................................................. 40

Ejemplos de respuesta de Check-Out ........................................................................................................................................ 40

CIERRE POST-PROPINA .............................................................................................................................................................. 41

MENSAJE DE SOLICITUD DE POST-PROPINA .............................................................................................................................................. 41

Ejemplos de solicitud de Cierre Post-Propina............................................................................................................................ 41MENSAJE DE RESPUESTA DE CIERRE POST-PROPINA .................................................................................................................................. 42

Ejemplos de respuesta de Cierre Post-Propina ......................................................................................................................... 42

PAGO ......................................................................................................................................................................................... 43

Ejemplos de solicitud de Pago .................................................................................................................................................. 44

MENSAJE DE RESPUESTA DE PAGO ......................................................................................................................................................... 45

Ejemplos de respuesta de Pago ................................................................................................................................................ 46

IMPRESIN ................................................................................................................................................................................ 47

IMPRESIN ................................................................................................................................................................................ 47

MENSAJE DE SOLICITUD DE IMPRESIN ................................................................................................................................................... 47Ejemplos de solicitud de Impresin ........................................................................................................................................... 48

MENSAJE DE RESPUESTA DE IMPRESIN .................................................................................................................................................. 48

Ejemplos de respuesta de Impresin ........................................................................................................................................ 49

CIERRE ....................................................................................................................................................................................... 50

MENSAJE DE SOLICITUD DE CIERRE ......................................................................................................................................................... 50


4/67

Product

Page 4



Ejemplos de solicitud de cierre ................................................................................................................................................. 50

MENSAJE DE RESPUESTA DE CIERRE ........................................................................................................................................................ 51

Ejemplos de respuesta de cierre ............................................................................................................................................... 51

REPORTE .................................................................................................................................................................................... 52

MENSAJE DE SOLICITUD DE REPORTE ...................................................................................................................................................... 52

Ejemplos de solicitud de reporte ............................................................................................................................................... 52

MENSAJE DE RESPUESTA DE REPORTE ..................................................................................................................................................... 53

Ejemplos de respuesta de reporte ............................................................................................................................................ 53

SERVICIOS VERTICALES .............................................................................................................................................................. 54

CATLOGOS ...................................................................................................................................................................................... 54

Mensaje de solicitud de catalogo de servicios adicionales ....................................................................................................... 54

Mensaje de respuesta de catalogo de servicios adicionales ..................................................................................................... 54

Ejemplos de solicitud de catalogo de servicios adicionales ...................................................................................................... 55

ANEXANDO UN SKUA UN CARGO .......................................................................................................................................................... 56

Mensaje de respuesta de cargo de servicios adicionales .......................................................................................................... 56

ANEXO A DESCRIPCIN DE VARIABLES .................................................................................................................................... 57

ANEXO B CATLOGO DE ERRORES .......................................................................................................................................... 63

ANEXO C RECHAZO DE TRANSACCIONES ................................................................................................................................. 66

Versions

Version Description Date Author1.0 Initial draft 29/5/2009 Javier Trujillo1.1, 1.2, and1.3

Adjustments due to PAYware Integra initialdevelopment

1/6/2009 8/6/2009

Javier Trujillo andMauricio Bonifacino

1.4 Initial release candidate in spanish 26/6/2009 Javier Trujillo1.5 Corrections of variables names 08/07/09 Javier Trujillo1.6 Update of protocol 04/09/09 Javier Trujillo1.7 Card information is mandatory in response 07/09/09 Javier Trujillo1.8 En una devolucin, la transaccin original no

cambia de estatus.La respuesta de una transaccin de estatus esanexa en todas las operaciones solicitadas.Actualizacin de definiciones en la transaccinde cargo.Cambios en el manejo de la informacin de latarjeta de crdito.El contenido de los vouchers es anexado a la

20/10/09 Javier Trujillo


5/67

Product

Page 5



respuesta cuando la tarea no es solicitada aPAYware Integra .

1.9 Anexo de Catalogo de Errores 11/11/2009 FranciscoHernndez

1.10 Anexo motivos de rechazo comunes 19/11/2009 Javier Trujillo1.11 Update of Protocol and Errors Catalogs 23/11/2009 Francisco

Hernndez1.12 Soporte de transacciones recurrentes.

Actualizacin de uso de MOTO y RecurrentesEnvo de informacin de tarjetas sin uso deencripcin.


1.13 Manual translated to English May 6th, 2010 Julian Murguia1.14 Issuer and Accounting Nature added in charge

response08/09/2010 Javier Trujillo

2.0 Se describe un protocol de integracin nicopara la solucin en modo local, o en modoservidor.Se aaden al protocolo nuevas transaccionessoportadas: checkIn, checkout, opciones demanejo de propina.Se aaden ms ejemplos de llamadas atransacciones comunes.


2.1 Revisin y validacin de variables en mensajes 25/02/2011 Leonel Arciniega2.2 Se agrega protocolo para transacciones de

Servicios Verticales15/06/2011 Francisco

Hernndez2.3 Se implementan reversos automticos de cargos

cuando el servidor no recibe un mensaje de ACKen un tiempo determinado.


2.4 Integracin del mensaje de CancelacinDiferencias entre Devolucin y CancelacinEjemplos de integracin e invocacin


2.5 Revisin y correcciones 08/12/2011 Csar Huerta2.6 Actualizacin 20/02/2013 Csar Huerta2.7 Transaccin payment 10/04/2013 Javier Trujillo


6/67

Product

Page 6



Introduccin

VATS 2.6 es una de las soluciones de VeriFone Access que provee servicios transaccionales a loscomercios. A diferencia de otras soluciones, VATS 2.6 provee una aplicacin cliente que facilita que estosservicios transaccionales sean integrados con las soluciones que posee el comercio. Este enfoque ayuda alcomercio a encapsular y simplificar por completo sus necesidades de procesamiento de serviciostransaccionales, incluyendo el soporte de transacciones EMV de manera transparente y el cumplimientode normas de seguridad PCI-DSS.

Cada punto de integracin tiene la posibilidad de mandar solicitudes de transacciones de pago a VATS2.6, el cual transmitir esta solicitud al servicio transaccional de VeriFone Access, y recibir la respuestadel mismo. Cada respuesta ser enviada de vuelta al punto de integracin cuando la transaccin seacompletada. Durante el proceso, VATS 2.6 controlar por completo el Pinpad, el cual provee parte de lainteraccin con el usuario durante el proceso transaccional. Actividades como leer la banda magntica dela tarjeta o su chip, estarn disponibles a travs del Pinpad.

VATS 2.6 es una solucin multiplataforma capaz de correr en cualquier sistema operativo y sobremltiples tipos de hardware, lo que provee una nica solucin a los comercios que encapsula toda lacomplejidad que significan los servicios de medios de pago.

Con VATS 2.6 el comercio obtiene adems todos los beneficios de ser parte de la infraestructura deservicios de VeriFone Access, incluyendo integraciones transparentes con mltiples bancos, soporte deVISA, MasterCard y American Express, certificacin de transacciones EMV, conformidad de estndares de

seguridad PCI-DSS, caractersticas propias del mercado como el manejo de promociones de con tarjeta decrdito, y otros servicios adicionales.


7/67

Product

Page 7




Protocolo de comunicacin

Independientemente del medio de integracin, la invocacin de transacciones de VATS 2.6 se realizamediante una cadena de texto en donde se concatena una serie de variables y valores en un formato depares de variable-valor separados por un signo de "=", como por ejemplo:

VARIABLE=valor&VARIABLE=valor&V=valor& etc.

En donde un carcter es usado como separador entre las diferentes variables usadas en la peticin. Estecarcter es & por omisin.

Cada invocacin debe llevar al menos la variable TRANSACCION, la cual indica el tipo de operacin que sedesea realizar. Por ejemplo para invocar un cargo a una tarjeta de crdito la lnea mnima sera:

TRANSACCION=cargo

Si se trata de una integracin cliente-servidor, es necesario tambin indicar el id de la terminal, queidentifica el punto de integracin que est haciendo la invocacin:

TRANSACCION=cargo&TERMINAL=ABCDEFGHIJKLMNO12345

En el momento en que la llamada es recibida por VATS 2.6, se usar una interfaz GUI o la Pinpad paracompletar el intercambio de informacin y operaciones necesarias para completar la transaccinsolicitada. Una vez concluida la operacin, retorna al punto de invocacin una cadena de texto en elmismo formato descrito anteriormente, con una serie de variables y valores que indican el resultado dedicha operacin.


8/67

Product

Page 8



Terminal

La terminal es una entidad lgica dentro de la infraestructura de servicios de VeriFone Access, la cualbrinda un punto de servicio con el comercio, desde donde puede solicitar los servicios transaccionaleshabilitados. Dicha terminal es sujeta de configuraciones, afiliaciones, y estatus de servicio.

Cada terminal es representada por una licencia alfanumrica de 20 caracteres, que identifica cada unade las operaciones que se solicitan a Verifone Access.

Estatus de una terminal

Todas las operaciones realizadas desde un punto de integracin son registradas con la licencia con la quese solicit. Cada licencia tiene un historial de operaciones en el servidor de Verifone Access, ydependiendo de los procesos que se ejecuten con la misma, guarda un estatus en un momentodeterminado.

La informacin de estatus de una terminal contiene los siguientes elementos:

Informacin del estatus de la terminal.

Fecha del estatus de la terminal. Clave del estatus de la terminal.

Descripcin del estatus de la terminal. Consecutivo actual de transacciones de la terminal. ltimo mensaje (opcional) ltimo cdigo de error (opcional)

Informacin del estatus de la ltima transaccin, y la fecha de dicha transaccin.

Fecha de la ltima transaccin Clave del estatus de la ltima transaccin. Descripcin del estatus de la ltima transaccin.Tambin se incluye en el estatus campos adicionales segn la ltima transaccin realizada. Porejemplo, si la ltima transaccin fue un cargo, el estatus puede incluir el monto, el nmero deautorizacin, etc.

El rango de fecha del ltimo corte realizado.

La fecha inicial del ltimo corte realizado. La fecha final del ltimo corte realizado.


9/67

Product

Page 9



Los estatus de una terminal son los siguientes:

AEn: Terminal active.

Sp: Terminal activa.La terminal acaba de ser registrada dentro de la infraestructura de VeriFone Access y esta lista pararecibir solicitudes de operaciones. Este estatus es similar a OP, salvo que aun no se ha realizado ningunaoperacin con esta licencia.

OPEn: Ready to operate and print.Sp: Lista para operaciones y reimpresiones.La terminal est lista para recibir cualquier peticin de transaccin por parte de VATS 2.6. La ltimaoperacin de Cargo o Devolucin fue concluida y aprobada y el voucher del mismo fue impreso o devuelto

en la respuesta.Una nueva solicitud de Cargo o Devolucin cambia dicho estatus mientras el proceso dure y vuelve adejarlo en este mismo estatus cuando la operacin haya concluido y la transaccin haya sido exitosa.Cuando una terminal esta en este estatus, es posible invocar la reimpresin del voucher de la ltimaoperacin realizada, si esta fue aprobada. La solicitud de transacciones de Corte, Reporte, Estatus oImpresin no afecta dicho estatus.

BEn: Terminal busy processing operations.Sp: No disponible, procesando operaciones.

La terminal est atendiendo una transaccin de Cargo o Devolucin. Mientras este proceso no concluya,no pueden ser atendidos nuevas solicitudes de Cargos o Devoluciones.Si la terminal queda en estatus B debido a la interrupcin en una operacin de cargo, el servidorcancelar esta operacin despus de unos minutos, y la terminal quedar lista para una nueva operacin.

PEn: Ready for printing.Sp: Lista para impresin.La termina concluy adecuadamente el proceso de Cargo o Devolucin, sin embargo no se ha concluido elproceso de impresin o solicitud de vouchers. En caso de que por algn error de impresin o

comunicacin la terminal quede en dicho estatus, es necesario invocar una transaccin de IMPRESINpara imprimir los vouchers del ltimo Cargo o Devolucin, y dejar a la terminal en estatus "OP".


10/67

Product

Page 10



OEn: Ready for operations.Sp: Lista para operaciones.La terminal se encuentra lista para recibir solicitudes de operaciones. La ltima operacin de Cargo o

Devolucin fue concluida y denegada. Cuando una terminal esta en este estatus, no es posible invocarimpresiones.

SEn: Terminal suspended.Sp: Terminal suspendida.La terminal ha sido suspendida para poder atender solicitudes de transacciones de Cargo y Devolucin.

DEn: Terminal cancelled.Sp: Terminal cancelada.La terminal fue cancelada dentro de la infraestructura de VeriFone Access para realizar cualquier tipo deoperacin.

Solicitud del estatus de una terminal

Variable ObligatorioValor por omisin

(configurable)Se puede cambiar

desde la interfazObservaciones

LANG No sp No

TRANSACCION SI - No Valor fijo, estatus (sin comillas)

TERMINAL No - No Obligatorio en integraciones cliente-servidor.

Ejemplos de solicitud de estatus

TRANSACCION=status

LANG=sp&TRANSACCION=estatus

TRANSACCION=estatus&TERMINAL=ABCDEFGHIJKLMNO12345&


11/67

Product

Page 11



Mensaje de respuesta del estatus

En la siguiente tabla se enlistan las variables que se incluyen en la respuesta a una solicitud de estatus.

Variable Observaciones

TERMINAL

ESTATUS_TERM

FECHA_ESTATUS_TERM

ESTATUS_TERM_LEIBLE

ID_TRANSACCION

FECHA_TRANSACCION

ESTATUS_TRANSACCION

ESTATUS_TRANSACCION_L

REFERENCIA

SECUENCIA_TRANSACCION

FECHA_INICIAL_CIERRE

FECHA_FINAL_CIERRE

MENSAJES

BLOQUEADO

VENDEDOR_REQUERIDO

VS_BALANCE

VS_STATUS

TURNO


12/67

Product

Page 12



Ejemplos de respuesta de estatus

BLOQUEADO=0&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y

reimpresin.&ESTATUS_TRANSACCION=CA&ESTATUS_TRANSACCION_L=Cargo

aceptado.&FECHA_ESTATUS_TERM=24/02/2011 09:30:27&FECHA_FINAL_CIERRE=21/10/2010

11:02:43&FECHA_INICIAL_CIERRE=20/10/2010 00:00:00&FECHA_TRANSACCION=24/02/2011

09:30:05&ID_TRANSACCION=12345-0-00630&MENSAJES=&SECUENCIA_TRANSACCION=630&

TERMINAL=ABCDEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TUR

NO=1&

BATCH_CLOSING_END_DATE=21/10/2010 11:02:43&BATCH_CLOSING_INI_DATE=20/10/2010

00:00:00&LOCKED=0&MESSAGES=&REFERENCE_SELLER_REQUIRED=0&TERMINAL=ABCDEFGHIJKLMN

O12345&TERM_STATUS=OP&TERM_STATUS_DATE=24/02/201109:30:27&TERM_STATUS_READABLE=Lista para operaciones y reimpresin.&TRANSACTION_DATE=24/02/2011 09:30:05&

TRANSACTION_ID=12345-0-00630&TRANSACTION_SEQUENCE=630& TRANSACTION_STATUS=CA&

TRANSACTION_STATUS_R=Cargo aceptado.&VS_BALANCE=0& VS_STATUS=1&TURNO=1&


13/67

Product

Page 13



Transacciones soportadas

Estatus

Esta instruccin regresa informacin respecto al estatus actual de la terminal y de la ltima operacintransaccional realizada. Sirve como herramienta para el control de errores en comunicacin o procesos, yvalidar la disponibilidad de la terminal.

Cargos

Este mensaje sirve para completar una transaccin de cargo a una tarjeta de crdito o debito.

Check-In

Sirve para pre-autorizar un cargo, garantizando los fondos de una tarjeta para un posterior cargo.

Re-autorizacin de Check-In

Actualiza la cantidad de fondos garantizados en una tarjeta de crdito para un posterior cargo.

Check-Out

Este mensaje sirve para ejecutar un cargo previamente autorizado mediante un mensaje de Check-In.

Cierre Post-Propina

Sirve para confirmar y actualizar el monto de una pre-autorizacin cargo a tarjeta de crdito que ha sidosealada como una venta con post propina.

Devoluciones

Una devolucin es el retorno de fondos a una tarjeta con cargo al comercio, cuando existe unatransaccin de cargo previamente aprovada. La transaccin original queda registrada como exitosa y segenera una nueva transaccin para este movimiento. Una operacin de devolucin se puede realizar porel total del cargo original o por un monto menor. Las devoluciones parciales podran no estar disponibles.

Cancelaciones

Una cancelacin anula una transaccin de cargo previamente aprovada. La transaccin original seactualiza a cancelada y se genera una nueva transaccin para este movimiento. Una operacin decancelacin siempre es por el total de la operacin, y solo es posible realizarla antes del cierre diario. Siel cargo original ha sido confirmado y cargado al tarjetahabiente y los fondos liberados al comercio, debe

realizarse una Devolucin.


14/67

Product

Page 14



Impresiones

Imprime o regresa el contenido del voucher de un Cargo o Devolucin.

Cortes de caja

Imprime o regresa el contenido de un reporte en donde se listan la informacin de todas las operacionesrealizadas en una terminal desde el ltimo corte previo realizado. Cada vez que se invoca un corte, lafecha inicial del prximo corte cambia a la fecha de ejecucin actual. El corte de caja es un reporteinformativo de las operaciones de un comercio o licencia, y no est relacionado con el cierre diario detransacciones del sistema.

Reportes

Imprime o regresa el contenido de un reporte en donde se lista la informacin de todos los movimientosrealizados en una terminal en un lapso de tiempo especificado por el comercio. Dicho reporte tiene elmismo formato que un corte de caja.


15/67

Product

Page 15



Flujo de operacin de Cargos a tarjetas

El nivel de integracin de VATS 2.6 depende de las necesidades que se quieran cubrir con la solucin, elnivel de control de las operaciones y la capacidad de recuperacin a eventos inesperados.

El flujo de operacin ms simple de un cargo es el siguiente:

Aplicacin VATS 2.6 Pinpad Servidor Verifone

Solicitud de un cargo atarjeta de crdito:

TRANSACCION=cargo

Recoleccin de informacinadicional de la operacin

Lectura de la tarjetade crdito (opcional)

Construccin y envo de lasolicitud de cargo a latarjeta.

Cargo a la tarjeta decrdito o dbito.

Resultado de la operacin

Impresin de vouchers(opcional)

Recepcin de una cadenade texto con informacinde la operacin, resultadode la operacin y estatusde la terminal.


16/67

Product

Page 16



Control de excepciones

El flujo normal de operaciones puede variar despus de la invocacin de la operacin por varias razonesque impidan que la misma sea exitosa:

Fallas en la comunicacin que impidan enviar la solicitud al servidor de Verifone. Fallas en la comunicacin con la pinpad. Pinpad apagado Cable desconectado Error inesperado de comunicacin con el puerto. Falta de papel Lectura de una tarjeta de crdito defectuosa o con errores en la informacin. Fallas en el suministro de energa elctrica

Algunos de los escenarios listados estn contemplados como un resultado posible de una solicitud decargo a tarjeta de crdito. Sin embargo, fallas debido a cortes del suministro de energa elctrica o decomunicacin pueden dejar el cargo a la tarjeta de crdito en un estatus incierto.

Si el cargo fue aprobado se retornara el estatus adecuado independientemente de que exista unproblema posterior, por ejemplo, al imprimir los vouchers. En este caso se deber de reimprimir losmismos.

Para cubrir estas eventualidades es til solicitar el estatus, la cual desplegar informacin del estatusde la terminal, y el estatus de la ltima transaccin procesada.

Reversos automticos

En caso de que el servidor de Verifone Access no reciba un mensaje de confirmacin de recepcin delsoftware cliente debido a un error como los listados anteriormente, la operacin ser reversada de formaautomtica dentro de los siguientes 3 minutos aproximadamente. Una vez restablecido el sistema, alconsultar esta operacin aparecer como denegada.


17/67

Product

Page 17



Aplicacin VATS 2.6 Pinpad Servidor Verifone

Solicitud de un cargo a

tarjeta de crdito:TRANSACCION=cargo

?

TRANSACCION=estatus

Consulta de estatus de laterminal

Notificacin deestatus de laterminal

Despliegue del estatus dela terminal

Recepcin de una cadenade texto con informacin

de la operacin, resultadode la operacin y estatusde la terminal.


18/67

Product

Page 18



Cargo

VATS 2.6 habilita a diferentes tipos de sistemas a solicitar un cargo a una tarjeta de crdito o dbito. Enel momento en que la solicitud es enviada a VATS 2.6, el flujo de la operacin pasa del lado del mismo.VATS 2.6 se encarga de completar toda la informacin que necesite para completar la transaccin,incluyendo la lectura de la tarjera de crdito. Toda la interaccin que VATS 2.6 necesite hacer con elconsumidor u operador la realiza a travs de una interfaz GUI o de la Pinpad.

En una solicitud de cargo se pueden contemplar las siguientes variables dentro de la solicitud:

Referencias de la transaccinReferencias opcionales que quedan registradas en la base de datos de VeriFone Access como parte de la

informacin de la transaccin.

REFERENCIA. Una referencia alfanumrica asociada a la transaccin.CLIENTE. El nombre o ID del cliente asociado a dicha transaccin.VENDEDOR. El nombre o ID del vendedor o usuario que ejecuta dicha transaccin.

Opciones de promocin

Si se indica una promocin para la transaccin, y dicha promocin es vlida, VATS 2.4 aplicar dichapromocin a la transaccin, sin pedir ningn tipo de confirmacin. Si se define una promocin para latransaccin en la solicitud, y dicha promocin no est habilitada para el comercio, se producir un error.

DIFERIMIENTO. Promocin del tipo "Compre ahora y pague despus", en donde se especifica unnmero de meses durante los cuales el monto no ser exigible.PROMO_MESES y PROMO_TIPO. El nmero de pagos y tipo de promocin asignada a la transaccin(ejemplo: 3 meses sin intereses, 7 meses con intereses, etc.).

Cuando una promocin no es anexada en la solicitud de cargo, y la terminal tiene habilitadapromociones, VATS 2.6 ofrecer elegir alguna de las promociones a travs del Pinpad o de la interfaz GUI.


19/67

Product

Page 19



Soporte de transacciones con propina para restaurantes

Existen dos maneras de manejar operaciones con propina para giros de restaurante:Pre-propina. La propina es establecida desde antes de realizar el cargo a la tarjeta y se anexa

como parte de la informacin de la transaccin. El monto del consumo, la propina y el total serdesglosado en el voucher de la operacin.Post-Propina. Se indica que se debe de contemplar una propina en el cargo, pero esta aun no hasido establecida. El monto del consumo aparece en el voucher de la operacin, junto con unalnea para escribir el monto de la propina y el total del cargo. Este cargo queda autorizado ms noejecutado, es necesario realizar un Cierre Post-Propina para actualizar el total del cargo yaplicarlo a la tarjeta de crdito.

Otras opciones

MONEDA. El tipo de moneda con la que se realiza la transaccin.DESHABILITAR_PROMO. Ignora cualquier promocin anexa en la solicitud o disponible para latienda. El proceso transaccional de VATS 2.6 ignorar cualquier promocin y no sern solicitadosestos datos.MOTO. Cuando no se tiene fsicamente la tarjeta de crdito, esta opcin permite digitar los datosde la misma en la interfaz GUI o desde la Pinpad.

Cargos MOTO

Este tipo de integracin aade a la integracin bsica la posibilidad de solicitar los datos de la tarjeta decrdito desde una interfaz GUI o desde el pinpad. Esto es particularmente til en soluciones de comercioque cuentan con una base de datos de clientes, o para transacciones cuya informacin es proporcionadadesde correo o telfono. Este tipo de transacciones deben de estar autorizadas por el banco adquirentedel comercio y est condicionado al giro del comercio y condiciones adicionales que el banco estipule.

Cargos recurrentes

La integracin de cargos recurrentes permite realizar cargos a tarjetas de crdito de forma programada ysin presencia de la tarjeta. Este tipo de transacciones deben de estar autorizadas por el bancoadquirente del comercio y est condicionado al giro del comercio y condiciones adicionales que el bancoestipule.


20/67

Product

Page 20



Envo de la informacin de la tarjeta de crdito a PAYware Integra.

La informacin de la tarjeta de crdito (nmero, fecha de expiracin y cdigo de seguridad) est

regulada por diferentes entidades y debe de ser tratada con especial cuidado. Verifone no se haceresponsable de cualquier incidente de seguridad.

En integracines web, para transferir la informacin de manera segura a travs de una red local abierta,deben de ser anexados a la solicitud de cargo encriptados con la llave digital pblica del servidor local dePAYware Integra.

Este tipo de integracin tambin permite prescindir de una Pinpad para completar la transaccin,siempre y cuando se enven toda la informacin necesaria para cerrar la operacin.

Si hace falta uno de los datos de la tarjeta de crdito, PAYware Integra intentar usar una Pinpad parapoder leerlo.

Si el cliente tiene habilitadas promociones, estas pueden ser indicadas en la solicitud de cargo, o en sudefecto se debe de indicar que quedan deshabilitadas, a fin de que PAYware Integra no necesite de unaPinpad para requerir las promociones y completar la operacin. Si quedan habilitadas, PAYware Integrausar una Pinpad para requerirle al operador la promocin que desea.


21/67

Product

Page 21



Mensaje de solicitud de Cargo

A continuacin se listan las variables usadas en una solicitud de cargo, en espaol. El orden de lasvariables no es relevante en la solicitud.




LANG No sp No

TRANSACCION SI - No Valor fijo, cargo (sin comillas)


MONTO Si - Si

IMPRIMIR_SALIDA No 1 No

CLIENTE No - Si* * En integraciones cliente-servidor lasreferencias deben ser enviadas en la solicitudpara anexarlas a la transaccin, ya que nopueden ser capturadas o modificadas desde lapinpad.

REFERENCIA No - Si*

VENDEDOR No - Si*

RECURRENTE No 0 No

Si RECURRENTE=1, se considera que no haypresencia de la tarjeta, y la informacin debeser proporcionada o capturada desde lainterfaz correspondiente.

MOTO No 0 No

TARJETAHABIENTE No - Si

NUMERO_TARJETA No - No (Informacin cifrada)

FECHA_EXP No - No (Informacin cifrada)

CODIGO_SEG_TARJETA No - No (Informacin cifrada)

MONEDA No 484 Si

PROMO_TIPO No - Si

PROMO_MESES No - Si

DIFERIMIENTO No - Si

DESHABILITAR_PROMO No 0 No

PROPINA_TIPO No - Si

PROPINA_MONTO No - Si


22/67

Product

Page 22



Ejemplos de solicitud de Cargo

Cargo a tarjeta, por $100.00

TRANSACCION=cargo&MONTO=100.00&REFERENCIA=A0002342

VATS 2.6 solicitar que se inserte o deslice la tarjeta de crdito. Si existen promociones disponibles sepodrn elegir durante el proceso.

Cargo a tarjeta, por $100.00, sin opcin a promociones, con todas las referencias.

TRANSACCION=cargo&MONTO=100.00&DESHABILITAR_PROMO=1&REFERENCIA=FACT.1504&CLIENT

E=305&VENDEDOR=jperez

VATS 2.6 solicitar que se inserte o deslice la tarjeta de crdito. No solicitar la seleccin de

promociones, aun cuando est disponible.

Cargo a tarjeta, por $100.00, con promocin de 6 meses sin intereses.

TRANSACCION=cargo&MONTO=100.00&PROMO_TIPO=1&PROMO_MESES=6&CLIENTE=Juan Martinez

O.&VENDEDOR=3009

VATS 2.6 solicitar que se inserte o deslice la tarjeta de crdito. No solicitar la seleccin depromociones.

Cargo a tarjeta, por $100.00, con propina de $10.00.

TRANSACCION=cargo&MONTO=100.00&PROPINA_TIPO=1&PROPINA_MONTO=10.00

VATS 2.6 solicitar que se inserte o deslice la tarjeta de crdito. Se realizar un cargo por $110.00. En el

voucher se presentan $100.00 como consumo, $10.00 como propina y $110.00 como total del cargo.

Cargo a tarjeta, por $100.00, con post-propina.

TRANSACCION=cargo&MONTO=100.00&PROPINA_TIPO=2

VATS 2.6 solicitar que se inserte o deslice la tarjeta de crdito. Se realizar un cargo por $100.00. En elvoucher se presentan $100.00 como consumo y aparecern unas lneas para escribir el monto de lapropina y el total del cargo.

Cargo a tarjeta, por $100.00, MOTO.

TRANSACCION=cargo&MONTO=100.00&MOTO=1

VATS 2.6 solicitar que se escriba el nmero de tarjeta, la fecha de expiracin y el cdigo de seguridadde la tarjeta. Si existen promociones disponibles se podrn elegir durante el proceso.


23/67

Product

Page 23



Mensaje de respuesta de Cargo

La respuesta del cargo incluye todos los valores de la transaccin de estatus. Adems de estos valores,contiene la siguiente informacin referente a la operacin realizada.


TRANSACCION La naturaleza de la ltima operacin (cargo, devolucin, checkIn, etc)

MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

PROMO_TIPO

PROMO_MESES

DIFERIMIENTO

DESHABILITAR_PROMO

MENSAJES

ERROR Solo cuando existe un error en la transaccin.

CODIGO_AUT

CODIGO_AUT_EMV Solo cuando la transaccin fue con CHIP

QPS

VOUCHER_ORIGINAL Solo cuando IMPRIMIR_SALIDA=0

VOUCHER_COPIA Solo cuando IMPRIMIR_SALIDA=0

NATURALEZA_CONTABLE

EMISOR

REFERENCIA

NUMERO_AFILIACION


24/67

Product

Page 24



Ejemplos de respuesta de Cargo

Cargo a tarjeta, por $100.00

BLOQUEADO=0&CODIGO_AUT=684775&CODIGO_AUT_EMV=&DIFERIMIENTO=0&EMISOR=BBVA

BANCOMER&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y




10:48:08&ID_TRANSACCION=12345-0-00631&MENSAJES=&MONEDA=484&MONTO=100.00&

NATURALEZA_CONTABLE=D&NUMERO_AFILIACION=1234567&NUMERO_TARJETA=415231******3071

&PROMO_MESES=0&PROMO_TIPO=0&QPS=1&REFERENCIA=A0002342&SECUENCIA_TRANSACCION=631

&TARJETAHABIENTE=&TERMINAL=ABCDEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE

=0&VS_STATUS=1&TURNO=1&TRANSACCION=cargo

Cargo a tarjeta, por $100.00, sin opcin a promociones, con todas las referencias.








&PROMO_MESES=0&PROMO_TIPO=0&QPS=0&REFERENCIA=FACT.1504&SECUENCIA_TRANSACCION=2&

TARJETAHABIENTE=&TERMINAL=3JNN6HIAK67MHT612714&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=0&TURNO=1&TRANSACCION=cargo

Cargo a tarjeta, por $100.00, con promocin de 6 meses sin intereses.








&PROMO_MESES=6&PROMO_TIPO=1&QPS=0&REFERENCIA=&SECUENCIA_TRANSACCION=3&TARJETAHA

BIENTE=&TERMINAL=3JNN6HIAK67MHT612714&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STAT

US=0&TURNO=1&TRANSACCION=cargo


25/67

Product

Page 25



Cargo a tarjeta, por $200.00, con propina de $20.00.

BLOQUEADO=0&CODIGO_AUT=059568&DIFERIMIENTO=0&EMISOR=HSBC&ESTATUS_TERM=OP&ESTATU

S_TERM_LEIBLE=Lista para operaciones y reimpresin.&ESTATUS_TRANSACCION=CA&

ESTATUS_TRANSACCION_L=Cargo aceptado.&FECHA_ESTATUS_TERM=24/02/2011

11:44:05&FECHA_FINAL_CIERRE=21/10/2010 12:02:43&FECHA_INICIAL_CIERRE=20/10/201001:00:00&FECHA_TRANSACCION=24/02/2011 11:44:05&ID_TRANSACCION=12345-0-

00639&MENSAJES=&MONEDA=484&MONTO=200.00&NATURALEZA_CONTABLE=C&NUMERO_AFILIACION

=1234567&NUMERO_TARJETA=491280******6176&PROMO_MESES=0&PROMO_TIPO=0&QPS=1&REFER

ENCIA=&SECUENCIA_TRANSACCION=639&TARJETAHABIENTE=LEONEL ARCINIEGA GOMEZ

&TERMINAL=ABCDEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TU

RNO=1&TRANSACCION=cargo

Cargo a tarjeta, por $100.00, con post-propina.


S_TERM_LEIBLE=Lista para operaciones y reimpresin.&ESTATUS_TRANSACCION=AA&

ESTATUS_TRANSACCION_L=Autorizacion aceptada.&FECHA_ESTATUS_TERM=23/02/2011

18:02:17&FECHA_FINAL_CIERRE=21/10/2010 12:02:43&FECHA_INICIAL_CIERRE=20/10/2010

01:00:00&FECHA_TRANSACCION=23/02/2011 18:02:17&ID_TRANSACCION=12345-0-

00629&MENSAJES=&MONEDA=484&MONTO=100.00&NATURALEZA_CONTABLE=C&NUMERO_TARJETA=49

1280******6176&PROMO_MESES=0&PROMO_TIPO=0&QPS=1&REFERENCIA=&SECUENCIA_TRANSACCI

ON=629&TARJETAHABIENTE=LEONEL ARCINIEGA GOMEZ&TERMINAL=ABCDEFGHIJKLMNO12345&

VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&TRANSACCION=cargo

Cargo a tarjeta, por $100.00, MOTO.BLOQUEADO=0&CODIGO_AUT=964932&CODIGO_AUT_EMV=&DIFERIMIENTO=0&EMISOR=BBVA







&PROMO_MESES=0&PROMO_TIPO=0&QPS=1&REFERENCIA=&SECUENCIA_TRANSACCION=630&TARJETA

HABIENTE=&TERMINAL=ABCDEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_ST

ATUS=1&TURNO=1&TRANSACCION=cargo


26/67

Product

Page 26



Devolucin

VATS 2.6 soporta transacciones de devolucin de un cargo previo, devolviendo los fondos a una tarjeta

con cargo al comercio. Para hacer esta operacin es necesario contar con la tarjeta o los datos de latarjeta a la que se le hizo el cargo, adems del id de la transaccin que se desea devolver.

Mensaje de solicitud de Devolucin

A continuacin se listan las variables usadas en una solicitud de devolucin.


(configurable)

Se puede cambiar


LANG No Sp No

TRANSACCION SI - No Valor fijo, devolucion (sin comillas)


TRANS_ORIGINAL No - Si Es obligatorio completar esta informacin

MONTO No - Si

Si se desea devolver solo una parte del totaldel cargo, se anexa el monto en esta variable.Si se omite el monto, la devolucin de hace

por el monto total del cargo previo.



REFERENCIA No - Si*

VENDEDOR No - Si*

MOTO No 0 No






27/67

Product

Page 27



Ejemplos de solicitud de Devolucin

Devolucin del cargo 12345-0-00631

TRANSACCION=devolucion&TRANS_ORIGINAL=631&REFERENCIA=A0002342

VATS 2.6 solicitar que se inserte o deslice la tarjeta de crdito.

Devolucin del cargo 12345-0-00630, MOTO

TRANSACCION=devolucion&TRANS_ORIGINAL=630&REFERENCIA=A0002342&MOTO=1VATS 2.6 solicitar que se escriba el nmero de tarjeta, la fecha de expiracin y el cdigo de seguridadde la tarjeta.

Devolucin del cargo 12345-0-00629, PROPINA

TRANSACCION=devolucion&TRANS_ORIGINAL=629

Mensaje de respuesta de Devolucin

La respuesta de la devolucin incluye todos los valores de la transaccin de estatus. Adems de estosvalores, contiene la siguiente informacin referente a la operacin realizada.


MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

MENSAJES


CODIGO_AUT


QPS



NATURALEZA_CONTABLE

EMISOR


28/67

Product

Page 28



REFERENCIA

NUMERO_AFILIACION

DIFERIMIENTO

PROMO_MESES

PROMO_TIPO

TRANS_ORIGINAL El ID del cargo sobre el que se hizo la devolucin.

Ejemplos de respuesta de Devolucin

Devolucin del cargo 12345-0-00631

BLOQUEADO=0&CODIGO_AUT=146012&DIFERIMIENTO=0&EMISOR=BBVABANCOMER&ESTATUS_TERM=O

P&ESTATUS_TERM_LEIBLE=Lista para operaciones y reimpresin.&ESTATUS_TRANSACCION

=RA&ESTATUS_TRANSACCION_L=Cancelacin aprobada.&FECHA_ESTATUS_TERM=24/02/2011



00632&MENSAJES=&MONEDA=484&MONTO=100.00&NATURALEZA_CONTABLE=D&NUMERO_AFILIACION

=1234567&NUMERO_TARJETA=415231******3071&PROMO_MESES=0&PROMO_TIPO=0&QPS=0&SECUE

NCIA_TRANSACCION=632&TARJETAHABIENTE=&TERMINAL=ABCDEFGHIJKLMNO12345&TRANS_ORIGI

NAL=631&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&TRANSACCION=devol

ucion

Devolucin del cargo 12345-0-00630, MOTOBLOQUEADO=0&CODIGO_AUT=921760&DIFERIMIENTO=0&EMISOR=BBVABANCOMER&ESTATUS_TERM=O



11:35:34&FECHA_FINAL_CIERRE=21/10/2010 12:02:43&FECHA_INICIAL_CIERRE=

20/10/201001:00:00&FECHA_TRANSACCION=24/02/2011 11:35:34&ID_TRANSACCION=12345-

0-




NAL=630&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&TRANSACCION=devol

ucion


29/67

Product

Page 29



Devolucin del cargo 12345-0-00639, PROPINA


S_TERM_LEIBLE=Lista para operaciones y reimpresin.&ESTATUS_TRANSACCION=RA&

ESTATUS_TRANSACCION_L=Cancelacin aprobada.&FECHA_ESTATUS_TERM=24/02/2011



00640&MENSAJES=&MONEDA=484&MONTO=220.00&NATURALEZA_CONTABLE=C&NUMERO_AFILIACION


NCIA_TRANSACCION=640&TARJETAHABIENTE=LEONEL ARCINIEGA GOMEZ&TERMINAL=

ABCDEFGHIJKLMNO12345&TRANS_ORIGINAL=639&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_ST

ATUS=1&TURNO=1&TRANSACCION=devolucion


30/67

Product

Page 30



Cancelacin

VATS 2.6 soporta transacciones cancelaciones de una operacin de cargo previamente autorizada, sin

necesidad de contar con la tarjeta o la informacin de la tarjeta con la que se realiz. Estascancelaciones solo es posible realizarlas en el mismo da del cargo, y previo al cierre diario del sistema, ysiempre se realizan por el total de la operacin de cargo. Las cancelaciones pueden no estar disponiblespara todos los comercios.

Mensaje de solicitud de Cancelacin

A continuacin se listan las variables usadas en una solicitud de cancelacin.

Variable Obligatorio Valor por omisin(configurable)

Se puede cambiardesde la interfaz

Observaciones

LANG No Sp No

TRANSACCION SI - No Valor fijo, cancelacion (sin comillas)




REFERENCIA No - Si*

* En integraciones cliente-servidor las

referencias deben ser enviadas en la solicitudpara anexarlas a la transaccin, ya que nopueden ser capturadas o modificadas desde lapinpad.VENDEDOR No - Si*

Ejemplos de solicitud de Cancelacin

Cancelacin del cargo 12345-0-00631

TRANSACCION=cancelacion&TRANS_ORIGINAL=631&REFERENCIA=A0002342


31/67

Product

Page 31



Mensaje de respuesta de Cancelacin

La respuesta de la cancelacin incluye todos los valores de la transaccin de estatus. Adems de estosvalores, contiene la siguiente informacin referente a la operacin realizada.


MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

MENSAJES


CODIGO_AUT


QPS



NATURALEZA_CONTABLE

EMISOR

REFERENCIA

NUMERO_AFILIACION

DIFERIMIENTO

PROMO_MESES

PROMO_TIPO

TRANS_ORIGINAL El ID del cargo sobre el que se hizo la cancelacin.


32/67

Product

Page 32



Ejemplos de respuesta de Cancelacin

Cancelacin del cargo 12345-0-00631









NAL=631&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&TRANSACCION=cance

lacion

Cancelacin del cargo 12345-0-00630, MOTO




11:35:34&FECHA_FINAL_CIERRE=21/10/2010 12:02:43&FECHA_INICIAL_CIERRE=

20/10/201001:00:00&FECHA_TRANSACCION=24/02/2011 11:35:34&ID_TRANSACCION=12345-

0-




NAL=630&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&TRANSACCION=cancelacion


33/67

Product

Page 33



Diferencias entre Devolucin y Cancelacin

Devoluciones Cancelaciones

Son operaciones independientes del cargo referido, y aparecern en los reportes de movimientos comouna operacin aprobada.

El cargo original permanece sin cambios en la basede datos, y aparecer como aprobado en losreportes de movimientos.

El cargo original ser cancelado y aparecer comodenegado en los reportes de movimientos

Es posible realizar una devolucin hasta por eltotal del cargo referido, o por un monto menor(Los cargos parciales podran no estar disponiblespara todos los comercios).

Las cancelaciones siempre se realizan por el totaldel cargo referido

Las devoluciones se pueden realizar el mismo dadel cargo, o en das posteriores

La cancelacin solo es posible realizarla el mismoda del cargo, y antes de la hora de cierre delsistema.

Tanto el movimiento de cargo como el dedevolucin aparecern en el estado de cuenta deltarjetahabiente y del comercio.

La cancelacin y el cargo referido no aparecernen el estado de cuenta del tarjetahabiente ni delcomercio.

Para realizar una devolcin a un cargo es necesariocontar con la tarjeta con la que se realizo el cargo,o en su defecto los datos de la misma.

Para cancelar un cargo solo es necesario el ID de laoperacin que se desea cancelar.


34/67

Product

Page 34



Check-In

Una transaccin de Check-In hace una pre-autorizacin de un cargo a una tarjeta de crdito. Los fondosquedan garantizados y disponibles para su posterior cargo. Para que los fondos garantizados seancargados a la tarjeta es necesaria que una transaccin de Check-In sea cerrada por una transaccin deCheck-Out. Sin un Check-out que ejecute la disposicin de dichos fondos, la transaccin de Check-In norealizar cargo alguno.

Mensaje de solicitud de Check-In

La solicitud de una transaccin de Check-In es similar a la solicitud de un cargo, salvo las siguientes

diferencias:1. No se manejan promociones2. No se soportan las transacciones recurrentes.3. No se manejan conceptos de propina.




LANG No Sp No

TRANSACCION SI - No Valor fijo, checkin (sin comillas)


MONTO Si - Si



REFERENCIA No - Si*

VENDEDOR No - Si*

MOTO No 0 No





MONEDA No 484 Si


35/67

Product

Page 35



Ejemplos de solicitud de Check-In

Check-In, por $100.00TRANSACCION=checkin&MONTO=100.00&REFERENCIA=A0002342

VATS 2.6 solicitar que se inserte o deslice la tarjeta de crdito.

Check- por $100.00, MOTO.

TRANSACCION=checkin&MONTO=100.00&MOTO=1&CLIENTE=Juan Martinez O.&VENDEDOR=3009

VATS 2.6 solicitar que se escriba el nmero de tarjeta, la fecha de expiracin y el cdigo de seguridadde la tarjeta.

Mensaje de respuesta de Check-In

La respuesta del Check-In incluye todas las variables de la transaccin de Cargo, adems de incluir lasvariables de la transaccin de Estatus.


MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

MENSAJES


CODIGO_AUT


QPS



NATURALEZA_CONTABLE

EMISOR

REFERENCIA


36/67

Product

Page 36



Ejemplos de respuesta de Check-In

Check-In, por $100.00



reimpresin.&ESTATUS_TRANSACCION=AA&ESTATUS_TRANSACCION_L=Autorizacion

aceptada.&FECHA_ESTATUS_TERM=24/02/2011 12:00:02&FECHA_FINAL_CIERRE=21/10/2010



NATURALEZA_CONTABLE=D&NUMERO_TARJETA=415231******3071&PROMO_MESES=0&PROMO_TIPO=

0&QPS=1&REFERENCIA=A0002342&SECUENCIA_TRANSACCION=641&TARJETAHABIENTE=

&TERMINAL=ABCDEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TU

RNO=1&

Check- por $100.00, MOTO.



reimpresin.&ESTATUS_TRANSACCION=AA&ESTATUS_TRANSACCION_L=Autorizacion

aceptada.&FECHA_ESTATUS_TERM=24/02/2011 12:35:41&FECHA_FINAL_CIERRE=21/10/2010



NATURALEZA_CONTABLE=D&NUMERO_TARJETA=415231******3071&PROMO_MESES=0&PROMO_TIPO=

0&QPS=1&REFERENCIA=&SECUENCIA_TRANSACCION=642&TARJETAHABIENTE=juan&TERMINAL=ABC

DEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&


37/67

Product

Page 37



Re-autorizacin de Check-In

Una transaccin de re-autorizacin de Check-In actualiza el monto de los fondos que quedan garantizadosy disponibles para su posterior cargo. Para que los fondos garantizados sean cargados a la tarjeta esnecesaria que una transaccin de Check-In o su posterior re-autorizacin sea cerrada por una transaccinde Check-Out. Sin un Check-out que ejecute la disposicin de dichos fondos, la transaccin de Check-Inno realizar cargo alguno.

Mensaje de solicitud de Re-autorizacin de Check-In

La solicitud de una transaccin de Re-autorizacin de Check-In no requiere de la informacin de la

tarjeta de crdito.




LANG No Sp No

TRANSACCION SI - No Valor fijo, checkinAjuste (sin comillas)


TRANS_ORIGINAL No - Si

Es obligatorio completar esta informacin. Encaso de que exista ms de un ajuste, en este

campo se debe de enviar el ID del primerCheck-In hecho a la tarjeta.

MONTO Si - Si


REFERENCIA No - Si* * En integraciones cliente-servidor lasreferencias deben ser enviadas en la solicitudpara anexarlas a la transaccin, ya que nopueden ser capturadas o modificadas desde lapinpad.

VENDEDOR No - Si*

Ejemplos de solicitud de Re-autorizacin de Check-In

Re-autorizacin de Check-In, por $500.00

TRANSACCION=checkinAjuste&TRANS_ORIGINAL=12345-0-00641&MONTO=500.00


38/67

Product

Page 38



Mensaje de respuesta de Re-autorizacin de Check-In

La respuesta del Check-In incluye todas las variables de la transaccin de Cargo, excluyendo losreferentes a propina y a promociones.


MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

MENSAJES


CODIGO_AUT

QPS



NATURALEZA_CONTABLE

EMISOR

REFERENCIA

Ejemplos de respuesta de Re-autorizacin de Check-In

BLOQUEADO=0&CODIGO_AUT=950991&DIFERIMIENTO=0&EMISOR=BANAMEX&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y reimpresi+n.&ESTATUS_TRANSACCION=CA&ESTATUS_TRANSACCION_L=Cargo aceptado.&FECHA_ESTATUS_TERM=20/02/2013 18:37:19&FECHA

_FINAL_CIERRE=27/12/2012 13:55:33&FECHA_INICIAL_CIERRE=27/12/2012 13:25:23&FECHA_TRANSACCION=20/02/2013 18:37:19&ID_TRANSACCION=14734-0-00213&MENSAJES=&MONEDA=484

&MONTO=10.00&NATURALEZA_CONTABLE=C&NUMERO_TARJETA=548234******9783&PROMO_MESES=0&PROMO_TIPO=0&QPS=0&REFERENCIA=&SECUENCIA_TRANSACCION=213&TARJETAHABIENTE=HUERTAROSAS/CESAR A&TERMINAL=MON3P8Q46P315LP14734&TRANSACCION=&TURNO=1&VENDEDOR_REQUE

RIDO=0&VS_BALANCE=19159.02&VS_ESTATUS=1&giftcardEnabled=1&giftcardStatus=A&issuerResponseCode=00&merchantId=1234123412&uploadLog=0&


39/67

Product

Page 39



Check-Out

La transaccin de Check-Out aplica un cargo a la tarjeta sobre los fondos previamente garantizados poruna transaccin de Check-In

Mensaje de solicitud de Check-Out

La solicitud de una transaccin de Check-Out no requiere de la informacin de la tarjeta de crdito.




LANG No sp No

TRANSACCION SI - No Valor fijo, checkout (sin comillas)



MONTO Si - Si


REFERENCIA No - Si* * En integraciones cliente-servidor lasreferencias deben ser enviadas en la solicitud

para anexarlas a la transaccin, ya que nopueden ser capturadas o modificadas desde lapinpad.

VENDEDOR No - Si*

Ejemplos de solicitud de Check-Out

Check-Out, por $300.00

TRANSACCION=checkout&MONTO=100.00&REFERENCIA= A0002342&VENDEDOR=jperez

Check-Out, por $500.00TRANSACCION=checkout&TRANS_ORIGINAL=12345-0-00213&MONTO=100.00


40/67

Product

Page 40



Mensaje de respuesta de Check-Out

La respuesta del Check-out incluye todas las variables de la transaccin de Cargo, excluyendo losreferentes a propina y a promociones.


MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

MENSAJES


CODIGO_AUT

QPS



NATURALEZA_CONTABLE

EMISOR

REFERENCIA

Ejemplos de respuesta de Check-Out

BLOQUEADO=0&CODIGO_AUT=103811&DIFERIMIENTO=0&EMISOR=BANAMEX&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y reimpresi+n.&ESTATUS_TRANSACCION=CA&ESTATUS_TRANSACCION_L=Cargo aceptado.&FECHA_ESTATUS_TERM=20/02/2013 19:09:45&FECHA

_FINAL_CIERRE=27/12/2012 13:55:33&FECHA_INICIAL_CIERRE=27/12/2012 13:25:23&FECHA

_TRANSACCION=20/02/2013 19:09:45&ID_TRANSACCION=14734-0-00214&MONEDA=484&MONTO=500.00&NATURALEZA_CONTABLE=C&NUMERO_TARJETA=&PROMO_MESES=0&PROMO_TIPO=0&QPS=0&REFERENCIA=A0002342&SECUENCIA_TRANSACCION=214&TARJETAHABIENTE=&TERMINAL=MON3P8Q46P315LP14734&TRANSACCION=&TURNO=1&VENDEDOR_REQUERIDO=0&VS_BALANCE=19159.02&VS_ESTATUS=1&giftcardEnabled=1&giftcardStatus=A&issuerResponseCode=00&merchantId=1234123412&uploadLog=0&


41/67

Product

Page 41



Cierre Post-Propina

La transaccin de Cierre Post-Propina permite actualizar el monto realizado a una tarjeta para sumarle la

propina especificada por el comensal en el voucher. Esto solo es posible realizarlo en un cargo quepreviamente ha sido solicitado con la opcin de post-propina.

Un cargo solicitado con Post-Propina no ser aplicado a la tarjeta de crdito si no es confirmado con unatransaccin de Cierre Post-Propina. El cierre puede ser por el mismo monto, o por un monto mayor queincluya la propina definida por el comensal.

Mensaje de solicitud de Post-Propina

La solicitud de una transaccin de Cierre Post-propina no requiere de la informacin de la tarjeta.




LANG No sp No

TRANSACCION SI - No Valor fijo, checkoutPropina (sin comillas)



MONTO Si - SiEl monto final que se cargar a la tarjeta decrdito, con la propina incluida, en caso deque as se requiera.


REFERENCIA No - Si* * En integraciones cliente-servidor lasreferencias deben ser enviadas en la solicitudpara anexarlas a la transaccin, ya que nopueden ser capturadas o modificadas desde lapinpad.

VENDEDOR No - Si*

Ejemplos de solicitud de Cierre Post-Propina

Cierre Post-Propina, cargo por consume de $100.00, propina de $10.00

TRANSACCION=checkoutPropina&TRANS_ORIGINAL=12345-0-00629&MONTO=150.00&REFERENCIA=A0002389&VENDEDOR=jperez


42/67

Product

Page 42



Mensaje de respuesta de Cierre Post-Propina

La respuesta del Cierre Post-Propina incluye todas las variables de la transaccin de Cargo, excluyendolos referentes a promociones.


MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

MENSAJES


CODIGO_AUT

QPS



NATURALEZA_CONTABLE

EMISOR

REFERENCIA

Ejemplos de respuesta de Cierre Post-Propina


43/67

Product

Page 43



Pago

La transaccin de pago permite abonar saldo a una tarjeta. Esta transaccin solo aplica con algunas

tarjetas especficas y la transaccin es soportada nicamente en algunos productos.

A continuacin se listan las variables usadas en una solicitud de pago, en espaol. El orden de lasvariables no es relevante en la solicitud.




LANG No sp No

TRANSACCION SI - No Valor fijo, pago (sin comillas)

TERMINAL No - No Obligatorio en integraciones cliente-servidor.MONTO Si - Si



REFERENCIA No - Si*

VENDEDOR No - Si*

MOTO No 0 No





MONEDA No 484 Si

OPERADOR SI - Si*

CLAVE_OPERADOR SI - Si (MD5 Hash)

* Solo es posible anexar o modificar estos valores si existe una interfaz disponible.


44/67

Product

Page 44



Ejemplos de solicitud de Pago

Pago de $100.00

TRANSACCION=pago&MONTO=100.00&REFERENCIA=A0002389&VENDEDOR=jperez&OPERADOR=45345&CLAVE_OPER

ADOR=fbc71ce36cc20790f2eeed2197898e71


45/67

Product

Page 45



Mensaje de respuesta de Pago

La respuesta del Pago incluye todas las variables de la transaccin de Cargo, excluyendo los referentes apromociones.


MONTO

MONEDA

TARJETAHABIENTE

NUMERO_TARJETA

MENSAJES


CODIGO_AUT

QPS



NATURALEZA_CONTABLE

EMISOR

REFERENCIA


46/67

Product

Page 46



Ejemplos de respuesta de Pago

VS_ESTATUS=1&FECHA_FINAL_CIERRE=02/05/2012

11:26:37&MONTO=100.00&ESTATUS_TRANSACCION_L=Cargoaceptado.&ESTATUS_TERM=OP&FECHA_TRANSACCION=10/04/201321:32:22&TURNO=1&PROMO_MESES=0&FECHA_INICIAL_CIERRE=10/04/201212:03:08&EMISOR=Extranjero&REFERENCIA=&MONEDA=484&TRANSACCION=&VENDEDOR_REQUERIDO=0&TARJETAHABIENTE=&MENSAJES=&giftcardStatus=A&giftcardEnabled=1&ID_TRANSACCION=00921-0-00670&BLOQUEADO=0&SECUENCIA_TRANSACCION=670&FECHA_ESTATUS_TERM=10/04/201321:32:22&CODIGO_AUT_EMV=&VS_BALANCE=280.04&QPS=0&ERROR=00&NUMERO_AFILIACION=1238867&PROMO_TIPO=0&issuerResponseCode=00&NUMERO_TARJETA=518468******0006&DIFERIMIENTO=0&NATURALEZA_CONTABLE=C&TERMINAL=T7BQ8B5UN7GUT8700921&CODIGO_AUT=125575&ESTATUS_TERM_LEIBLE=Lista para operaciones y reimpresin.&ESTATUS_TRANSACCION=CA&


47/67

Product

Page 47



Impresin

Por omisin VATS 2.6 intentar imprimir los vouchers en el Pinpad asociado a la terminal que realiza latransaccin, a menos que se indique lo contrario. Sin embargo hay algunas situaciones en las que estatarea no es completada:

1. El cargo o devolucin fue aprobado, pero hubo problemas de comunicacin que impidieronobtener la respuesta.

2. La solucin del comercio maneja su propia impresin de comprobantes por lo que se indica en lasolicitud de la transaccin que no se desea imprimir los mismos.

3. El cargo o devolucin fue aprobado, pero hubo problemas al imprimir el voucher, como porejemplo falta de papel.

Para cualquiera de estos casos, es necesaria una tarea de Impresin, para reimprimir los vouchers o paraobtener el contenido de los mismos. Solo es posible reimprimir los vouchers de transacciones que hayansido aprobadas.

Por omisin, la interfaz GUI de la integracin add-on mostrar como opcin la impresin de la ltimatransaccin, sin embargo es posible modificar el id de la transaccin para reimprimir otra transaccindistinta. En integraciones cliente-servidor es necesario indicar el ID de la transaccin desde la solicitud.

Mensaje de solicitud de impresin




LANG No sp No

TRANSACCION SI - No Valor fijo, imprimir (sin comillas)


ID_TRANSACCION No - Si Es obligatorio completar esta informacin



48/67

Product

Page 48



Ejemplos de solicitud de Impresin

Impresin, integracin ADD-ON

TRANSACCION=imprimir&ID_TRANSACCION=00234&LANG=sp

VATS 2.6 imprimir el voucher, y regresar el estatus de la terminal como resultado.

Impresin, integracin cliente-servidor, sin uso de impresora.

TRANSACCION=imprimir&ID_TRANSACCION=00234&TERMINAL=ABCDEFGHIJKLMNO12345&IMPRIMI

R_SALIDA=0

VATS 2.6 regresar el estatus de la terminal como resultado, con los vouchers anexos en la variableVOUCHER_ORIGINAL y VOUCHER_COPIA.

Mensaje de respuesta de impresin

Cuando se precisa en la solicitud que no se requiere de la impresin de los mismos (IMPRIMIR_SALIDA=0),la respuesta incluye el contenido de los vouchers formateados para ser impresos en un ticket de 32caracteres por lnea, en las siguientes variables:

La respuesta del cierre incluye todos los valores de la transaccin de estatus. Adems de estos valores,contiene la siguiente informacin referente a la operacin realizada.




NATURALEZA_CONTABLE

MENSAJE

ERROR Solo si ha ocurrido un error al solicitar los vouchers.


49/67

Product

Page 49



Ejemplos de respuesta de Impresin

Impresin, integracin ADD-ON

TRANSACCION=imprimir&ID_TRANSACCION=00644&LANG=sp

Impresin, integracin cliente-servidor, sin uso de impresora.

TRANSACCION=imprimir&ID_TRANSACCION=00639&IMPRIMIR_SALIDA=0


50/67

Product

Page 50



Cierre

La transaccin de cierre o corte de caja sirve para agrupar todas las transacciones de cargo y

devoluciones de un lapso de tiempo en un reporte. Dentro del estatus de la terminal se puede consultarla fecha inicial y la fecha final del lapso contemplado en el ltimo cierre. Este lapso es actualizado cadavez que se invoca un nuevo cierre, y la fecha final del ltimo cierre pasa a ser la fecha inicial, y la fechafinal queda como la fecha de la solicitud del nuevo cierre.

Esta operacin no marca o modifica los datos de las transacciones que incluye.

Mensaje de solicitud de cierre


(configurable)

Se puede cambiar


LANG No Sp No

TRANSACCION SI - No Valor fijo, cierre (sin comillas)



Ejemplos de solicitud de cierre

Cierre

TRANSACCION=cierre&

VATS 2.6 imprimir el reporte de cierre, y regresar el estatus de la terminal como resultado.


51/67

Product

Page 51



Mensaje de respuesta de cierre

Cuando se precisa en la solicitud que no se requiere de la impresin del mismo (IMPRIMIR_SALIDA=0), larespuesta incluye el contenido del reporte formateados para ser impreso en un ticket de 32 caracterespor lnea.

La respuesta del cierre incluye todos los valores de la transaccin de estatus. Adems de estos valores,contiene la siguiente informacin referente a la operacin realizada.


CONTENIDO_REPORTE Solo cuando IMPRIMIR_SALIDA=0

MENSAJE

ERROR Solo si ha ocurrido un error al solicitar los vouchers.

Ejemplos de respuesta de cierre

BLOQUEADO=0&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y


aceptado.&FECHA_ESTATUS_TERM=24/02/2011 12:58:32&FECHA_FINAL_CIERRE=21/10/201012:02:43&FECHA_INICIAL_CIERRE=20/10/2010 01:00:00&FECHA_TRANSACCION=24/02/2011

12:58:10&ID_TRANSACCION=12345-0-00644&MENSAJES=&SECUENCIA_TRANSACCION=644&

TERMINAL=ABCDEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TUR

NO=1&


52/67

Product

Page 52



Reporte

La transaccin de reporte agrupa todas las transacciones de cargo y devoluciones de un laps

VeriFone Access Client Protocol

Documents

Transcript of VeriFone Access Client Protocol