VeriFone Access Client Protocol
-
Upload
antonio-juarez -
Category
Documents
-
view
255 -
download
10
Transcript of 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.
-
7/23/2019 VeriFone Access Client Protocol
2/67
Product
Page 2
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
-
7/23/2019 VeriFone Access Client Protocol
3/67
Product
Page 3
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
-
7/23/2019 VeriFone Access Client Protocol
4/67
Product
Page 4
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
-
7/23/2019 VeriFone Access Client Protocol
5/67
Product
Page 5
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
27/01/2010 Javier Trujillo
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.
21/02/2011 Javier Trujillo
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.
22/08/2011 Javier Trujillo
2.4 Integracin del mensaje de CancelacinDiferencias entre Devolucin y CancelacinEjemplos de integracin e invocacin
12/09/2011 Javier Trujillo
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
-
7/23/2019 VeriFone Access Client Protocol
6/67
Product
Page 6
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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/23/2019 VeriFone Access Client Protocol
7/67
Product
Page 7
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
8/67
Product
Page 8
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
9/67
Product
Page 9
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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".
-
7/23/2019 VeriFone Access Client Protocol
10/67
Product
Page 10
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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&
-
7/23/2019 VeriFone Access Client Protocol
11/67
Product
Page 11
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
-
7/23/2019 VeriFone Access Client Protocol
12/67
Product
Page 12
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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&
-
7/23/2019 VeriFone Access Client Protocol
13/67
Product
Page 13
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
14/67
Product
Page 14
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
15/67
Product
Page 15
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
16/67
Product
Page 16
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
17/67
Product
Page 17
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
18/67
Product
Page 18
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
19/67
Product
Page 19
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
20/67
Product
Page 20
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
21/67
Product
Page 21
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable ObligatorioValor por omisin
(configurable)Se puede cambiar
desde la interfazObservaciones
LANG No sp No
TRANSACCION SI - No Valor fijo, cargo (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
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
-
7/23/2019 VeriFone Access Client Protocol
22/67
Product
Page 22
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
23/67
Product
Page 23
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
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
-
7/23/2019 VeriFone Access Client Protocol
24/67
Product
Page 24
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
reimpresin.&ESTATUS_TRANSACCION=CA&ESTATUS_TRANSACCION_L=Cargo
aceptado.&FECHA_ESTATUS_TERM=24/02/2011 10:48:08&FECHA_FINAL_CIERRE=21/10/2010
12:02:43&FECHA_INICIAL_CIERRE=20/10/2010 01:00:00&FECHA_TRANSACCION=24/02/2011
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.
BLOQUEADO=0&CODIGO_AUT=804464&CODIGO_AUT_EMV=&DIFERIMIENTO=0&EMISOR=BBVA
BANCOMER&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y
reimpresin.&ESTATUS_TRANSACCION=CA&ESTATUS_TRANSACCION_L=Cargo
aceptado.&FECHA_ESTATUS_TERM=23/02/2011 15:53:14&FECHA_FINAL_CIERRE=23/02/2011
12:23:05&FECHA_INICIAL_CIERRE=23/02/2011 12:23:05&FECHA_TRANSACCION=23/02/2011
15:53:14&ID_TRANSACCION=12714-0-00002&MENSAJES=&MONEDA=484&MONTO=100.00&
NATURALEZA_CONTABLE=D&NUMERO_AFILIACION=1234567&NUMERO_TARJETA=415231******3071
&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.
BLOQUEADO=0&CODIGO_AUT=230657&CODIGO_AUT_EMV=&DIFERIMIENTO=0&EMISOR=BBVA
BANCOMER&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y
reimpresin.&ESTATUS_TRANSACCION=CA&ESTATUS_TRANSACCION_L=Cargo
aceptado.&FECHA_ESTATUS_TERM=23/02/2011 16:48:43&FECHA_FINAL_CIERRE=23/02/2011
12:23:05&FECHA_INICIAL_CIERRE=23/02/2011 12:23:05&FECHA_TRANSACCION=23/02/2011
16:48:43&ID_TRANSACCION=12714-0-00003&MENSAJES=&MONEDA=484&MONTO=100.00&
NATURALEZA_CONTABLE=D&NUMERO_AFILIACION=1234567&NUMERO_TARJETA=415231******3071
&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
-
7/23/2019 VeriFone Access Client Protocol
25/67
Product
Page 25
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
BLOQUEADO=0&CODIGO_AUT=908905&DIFERIMIENTO=0&EMISOR=HSBC&ESTATUS_TERM=OP&ESTATU
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
BANCOMER&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:29:54&FECHA_FINAL_CIERRE=21/10/2010
12:02:43&FECHA_INICIAL_CIERRE=20/10/2010 01:00:00&FECHA_TRANSACCION=24/02/2011
09:29:54&ID_TRANSACCION=12345-0-00630&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=&SECUENCIA_TRANSACCION=630&TARJETA
HABIENTE=&TERMINAL=ABCDEFGHIJKLMNO12345&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_ST
ATUS=1&TURNO=1&TRANSACCION=cargo
-
7/23/2019 VeriFone Access Client Protocol
26/67
Product
Page 26
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable ObligatorioValor por omisin
(configurable)
Se puede cambiar
desde la interfazObservaciones
LANG No Sp No
TRANSACCION SI - No Valor fijo, devolucion (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
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.
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*
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)
-
7/23/2019 VeriFone Access Client Protocol
27/67
Product
Page 27
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
MONTO
MONEDA
TARJETAHABIENTE
NUMERO_TARJETA
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
-
7/23/2019 VeriFone Access Client Protocol
28/67
Product
Page 28
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
11:08:17&FECHA_FINAL_CIERRE=21/10/2010 12:02:43&FECHA_INICIAL_CIERRE=20/10/2010
01:00:00&FECHA_TRANSACCION=24/02/2011 11:08:17&ID_TRANSACCION=12345-0-
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
P&ESTATUS_TERM_LEIBLE=Lista para operaciones y reimpresin.&ESTATUS_TRANSACCION
=RA&ESTATUS_TRANSACCION_L=Cancelacin aprobada.&FECHA_ESTATUS_TERM=24/02/2011
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-
00636&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=636&TARJETAHABIENTE=&TERMINAL=ABCDEFGHIJKLMNO12345&TRANS_ORIGI
NAL=630&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&TRANSACCION=devol
ucion
-
7/23/2019 VeriFone Access Client Protocol
29/67
Product
Page 29
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
Devolucin del cargo 12345-0-00639, PROPINA
BLOQUEADO=0&CODIGO_AUT=911713&DIFERIMIENTO=0&EMISOR=HSBC&ESTATUS_TERM=OP&ESTATU
S_TERM_LEIBLE=Lista para operaciones y reimpresin.&ESTATUS_TRANSACCION=RA&
ESTATUS_TRANSACCION_L=Cancelacin aprobada.&FECHA_ESTATUS_TERM=24/02/2011
11:46:05&FECHA_FINAL_CIERRE=21/10/2010 12:02:43&FECHA_INICIAL_CIERRE=20/10/2010
01:00:00&FECHA_TRANSACCION=24/02/2011 11:46:05&ID_TRANSACCION=12345-0-
00640&MENSAJES=&MONEDA=484&MONTO=220.00&NATURALEZA_CONTABLE=C&NUMERO_AFILIACION
=1234567&NUMERO_TARJETA=491280******6176&PROMO_MESES=0&PROMO_TIPO=0&QPS=0&SECUE
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
-
7/23/2019 VeriFone Access Client Protocol
30/67
Product
Page 30
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
TRANS_ORIGINAL No - Si Es obligatorio completar esta informacin
IMPRIMIR_SALIDA No 1 No
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
-
7/23/2019 VeriFone Access Client Protocol
31/67
Product
Page 31
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
MONTO
MONEDA
TARJETAHABIENTE
NUMERO_TARJETA
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
DIFERIMIENTO
PROMO_MESES
PROMO_TIPO
TRANS_ORIGINAL El ID del cargo sobre el que se hizo la cancelacin.
-
7/23/2019 VeriFone Access Client Protocol
32/67
Product
Page 32
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
Ejemplos de respuesta de Cancelacin
Cancelacin 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
11:08:17&FECHA_FINAL_CIERRE=21/10/2010 12:02:43&FECHA_INICIAL_CIERRE=20/10/2010
01:00:00&FECHA_TRANSACCION=24/02/2011 11:08:17&ID_TRANSACCION=12345-0-
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=cance
lacion
Cancelacin del cargo 12345-0-00630, MOTO
BLOQUEADO=0&CODIGO_AUT=921760&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
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-
00636&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=636&TARJETAHABIENTE=&TERMINAL=ABCDEFGHIJKLMNO12345&TRANS_ORIGI
NAL=630&VENDEDOR_REQUERIDO=0&VS_BALANCE=0&VS_STATUS=1&TURNO=1&TRANSACCION=cancelacion
-
7/23/2019 VeriFone Access Client Protocol
33/67
Product
Page 33
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
-
7/23/2019 VeriFone Access Client Protocol
34/67
Product
Page 34
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable ObligatorioValor por omisin
(configurable)Se puede cambiar
desde la interfazObservaciones
LANG No Sp No
TRANSACCION SI - No Valor fijo, checkin (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
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*
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
-
7/23/2019 VeriFone Access Client Protocol
35/67
Product
Page 35
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
MONTO
MONEDA
TARJETAHABIENTE
NUMERO_TARJETA
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
-
7/23/2019 VeriFone Access Client Protocol
36/67
Product
Page 36
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
Ejemplos de respuesta de Check-In
Check-In, por $100.00
BLOQUEADO=0&CODIGO_AUT=461569&CODIGO_AUT_EMV=&DIFERIMIENTO=0&EMISOR=BBVA
BANCOMER&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y
reimpresin.&ESTATUS_TRANSACCION=AA&ESTATUS_TRANSACCION_L=Autorizacion
aceptada.&FECHA_ESTATUS_TERM=24/02/2011 12:00:02&FECHA_FINAL_CIERRE=21/10/2010
12:02:43&FECHA_INICIAL_CIERRE=20/10/2010 01:00:00&FECHA_TRANSACCION=24/02/2011
12:00:02&ID_TRANSACCION=12345-0-00641&MENSAJES=&MONEDA=484&MONTO=100.00&
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.
BLOQUEADO=0&CODIGO_AUT=043423&CODIGO_AUT_EMV=&DIFERIMIENTO=0&EMISOR=BBVA
BANCOMER&ESTATUS_TERM=OP&ESTATUS_TERM_LEIBLE=Lista para operaciones y
reimpresin.&ESTATUS_TRANSACCION=AA&ESTATUS_TRANSACCION_L=Autorizacion
aceptada.&FECHA_ESTATUS_TERM=24/02/2011 12:35:41&FECHA_FINAL_CIERRE=21/10/2010
12:02:43&FECHA_INICIAL_CIERRE=20/10/2010 01:00:00&FECHA_TRANSACCION=24/02/2011
12:35:41&ID_TRANSACCION=12345-0-00642&MENSAJES=&MONEDA=484&MONTO=100.00&
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&
-
7/23/2019 VeriFone Access Client Protocol
37/67
Product
Page 37
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable ObligatorioValor por omisin
(configurable)Se puede cambiar
desde la interfazObservaciones
LANG No Sp No
TRANSACCION SI - No Valor fijo, checkinAjuste (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
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
IMPRIMIR_SALIDA No 1 No
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
-
7/23/2019 VeriFone Access Client Protocol
38/67
Product
Page 38
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
MONTO
MONEDA
TARJETAHABIENTE
NUMERO_TARJETA
MENSAJES
ERROR Solo cuando existe un error en la transaccin.
CODIGO_AUT
QPS
VOUCHER_ORIGINAL Solo cuando IMPRIMIR_SALIDA=0
VOUCHER_COPIA Solo cuando IMPRIMIR_SALIDA=0
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&
-
7/23/2019 VeriFone Access Client Protocol
39/67
Product
Page 39
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable ObligatorioValor por omisin
(configurable)Se puede cambiar
desde la interfazObservaciones
LANG No sp No
TRANSACCION SI - No Valor fijo, checkout (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
TRANS_ORIGINAL No - Si Es obligatorio completar esta informacin
MONTO Si - Si
IMPRIMIR_SALIDA No 1 No
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
-
7/23/2019 VeriFone Access Client Protocol
40/67
Product
Page 40
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
MONTO
MONEDA
TARJETAHABIENTE
NUMERO_TARJETA
MENSAJES
ERROR Solo cuando existe un error en la transaccin.
CODIGO_AUT
QPS
VOUCHER_ORIGINAL Solo cuando IMPRIMIR_SALIDA=0
VOUCHER_COPIA Solo cuando IMPRIMIR_SALIDA=0
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&
-
7/23/2019 VeriFone Access Client Protocol
41/67
Product
Page 41
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable ObligatorioValor por omisin
(configurable)Se puede cambiar
desde la interfazObservaciones
LANG No sp No
TRANSACCION SI - No Valor fijo, checkoutPropina (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
TRANS_ORIGINAL No - Si Es obligatorio completar esta informacin
MONTO Si - SiEl monto final que se cargar a la tarjeta decrdito, con la propina incluida, en caso deque as se requiera.
IMPRIMIR_SALIDA No 1 No
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
-
7/23/2019 VeriFone Access Client Protocol
42/67
Product
Page 42
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
MONTO
MONEDA
TARJETAHABIENTE
NUMERO_TARJETA
MENSAJES
ERROR Solo cuando existe un error en la transaccin.
CODIGO_AUT
QPS
VOUCHER_ORIGINAL Solo cuando IMPRIMIR_SALIDA=0
VOUCHER_COPIA Solo cuando IMPRIMIR_SALIDA=0
NATURALEZA_CONTABLE
EMISOR
REFERENCIA
Ejemplos de respuesta de Cierre Post-Propina
-
7/23/2019 VeriFone Access Client Protocol
43/67
Product
Page 43
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable ObligatorioValor por omisin
(configurable)Se puede cambiar
desde la interfazObservaciones
LANG No sp No
TRANSACCION SI - No Valor fijo, pago (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.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*
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
OPERADOR SI - Si*
CLAVE_OPERADOR SI - Si (MD5 Hash)
* Solo es posible anexar o modificar estos valores si existe una interfaz disponible.
-
7/23/2019 VeriFone Access Client Protocol
44/67
Product
Page 44
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
Ejemplos de solicitud de Pago
Pago de $100.00
TRANSACCION=pago&MONTO=100.00&REFERENCIA=A0002389&VENDEDOR=jperez&OPERADOR=45345&CLAVE_OPER
ADOR=fbc71ce36cc20790f2eeed2197898e71
-
7/23/2019 VeriFone Access Client Protocol
45/67
Product
Page 45
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
Mensaje de respuesta de Pago
La respuesta del Pago incluye todas las variables de la transaccin de Cargo, excluyendo los referentes apromociones.
Variable Observaciones
MONTO
MONEDA
TARJETAHABIENTE
NUMERO_TARJETA
MENSAJES
ERROR Solo cuando existe un error en la transaccin.
CODIGO_AUT
QPS
VOUCHER_ORIGINAL Solo cuando IMPRIMIR_SALIDA=0
VOUCHER_COPIA Solo cuando IMPRIMIR_SALIDA=0
NATURALEZA_CONTABLE
EMISOR
REFERENCIA
-
7/23/2019 VeriFone Access Client Protocol
46/67
Product
Page 46
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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&
-
7/23/2019 VeriFone Access Client Protocol
47/67
Product
Page 47
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
Variable ObligatorioValor por omisin
(configurable)Se puede cambiar
desde la interfazObservaciones
LANG No sp No
TRANSACCION SI - No Valor fijo, imprimir (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
ID_TRANSACCION No - Si Es obligatorio completar esta informacin
IMPRIMIR_SALIDA No 1 No
-
7/23/2019 VeriFone Access Client Protocol
48/67
Product
Page 48
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
VOUCHER_ORIGINAL Solo cuando IMPRIMIR_SALIDA=0
VOUCHER_COPIA Solo cuando IMPRIMIR_SALIDA=0
NATURALEZA_CONTABLE
MENSAJE
ERROR Solo si ha ocurrido un error al solicitar los vouchers.
-
7/23/2019 VeriFone Access Client Protocol
49/67
Product
Page 49
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
-
7/23/2019 VeriFone Access Client Protocol
50/67
Product
Page 50
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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
Variable ObligatorioValor por omisin
(configurable)
Se puede cambiar
desde la interfazObservaciones
LANG No Sp No
TRANSACCION SI - No Valor fijo, cierre (sin comillas)
TERMINAL No - No Obligatorio en integraciones cliente-servidor.
IMPRIMIR_SALIDA No 1 No
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.
-
7/23/2019 VeriFone Access Client Protocol
51/67
Product
Page 51
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
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.
Variable Observaciones
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
reimpresin.&ESTATUS_TRANSACCION=CA&ESTATUS_TRANSACCION_L=Cargo
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&
-
7/23/2019 VeriFone Access Client Protocol
52/67
Product
Page 52
VeriFone AccessVATS 2.6 PAYware Integra
Protocolo de Integracin
Reporte
La transaccin de reporte agrupa todas las transacciones de cargo y devoluciones de un laps