...
Fecha | Revisión | Cambios |
|---|---|---|
02/11/2009 | 1.0 | Generación del documento |
04/11/2009 | 1.1 | Indicación de campos obligatorios |
26/04/2010 | 1.2 | Actualización de gráfico manejo de PINPAD |
22/03/2011 | 1.3 | Incorporación mensajes MembershipQuery y VoidMembershipQuery para consulta membresía Club Personal y Club La Nación |
03/06/2011 | 1.4 | Agregado de definición de mensaje de cierre de lote |
30/05/2012 | 1.5 | Agrego Tabla de Respuestas al POS y mejoro explicación de Tercer Mensaje y Chequeo de Pendientes. |
08/03/2013 | 1.6 | Agrego nuevos campos relacionados con operador y vendedor en operaciones de pre-autorización, venta, devolución y anulación. |
21/08/2013 | 1.7 | Agregado de apartado de error del core. |
09/09/2013 | 1.8 | Agrego campos EMV en operaciones de Venta, Devolución y anulación. Incorporo mensaje RejectedEMVAdvice y flujo de datos EMV. |
15/11/2013 | 1.9 | Agregado de 'Formato Interface POS' |
23/12/2013 | 2.0 | Agregado de detalle de los mensajes ServicePayment y VoidServicePayment |
13/02/2014 | 2.1 | Agregado del campo bandera '164 – posEncryptedFields', que indica cuando los datos sensibles viajan encriptados. |
29/05/2014 | 2.2 | Aclaración sobre el uso de pre-autorizaciones. |
22/08/2014 | 2.3 | Agregado de campo pinpadAutoCode en Tercer Mensaje y RejectedEMVAdvice. |
29/08/2014 | 2.4 | Actualización del Formato Interface POS, agregando el campo 'Tarjeta que Encripta' a los prefijos. |
11/09/2014 | 2.5 | Incorporación de Bines de Excepción y nuevo mensaje CardInfoService. |
09/12/2014 | 2.6 | Agregado de mensaje de Anulación de Pre Autorización. |
26/02/2015 | 2.7 | Agregado de nuevos campos ServiceCode y ProviderPosCode. |
27/02/2015 | 2.8 | Agregado de nuevos mensajes propios a la funcionalidad Cash Back. |
07/08/2015 | 2.9 | Agregado de aclaraciones en el uso de la mensajería |
09/09/2015 | 3.0 | Incorporación de campo PinpadApplicationVersion en los mensajes Sale, VoidSale, Refund y VoidRefund |
30/10/2015 | 3.1 | El campo ProviderPosCode para a ser el número 147. Incorporación de campo trxReferenceNumber en las respuestas de VTOL. Corrección de formato esperado en campo 7 - Expiration. El formato correcto es: YYMM. |
11/02/2016 | 3.2 | Incorporación del campo 201 additionalMessageData en el requerimiento y respuesta y la posibilidad de incluir el número de Ticket original en una anulación (Campo 17 originalTrxTicketNr) |
29/07/2016 | 3.3 | Incorporación del apartado 1.9. Mecanismo en Tiendas Virtuales y del 1.3.13. Chequeo de Listado de Pendientes |
19/04/2017 | 3.4 | Actualización de la tabla Prefijo en el apartado Formato Interface POS |
03/05/2017 | 3.5 | Incorporación del apartado 1.3.10 Echo |
05/05/2017 | 3.6 | Incorporación del apartado 1.3.9 SynQuery y de la sección 1.7 Formato Datos Sincronización |
06/06/2017 | 3.7 | Actualización de la tabla Prefijo en el apartado Formato Interface POS. Mayor detalle del campo MasterKey Position, incluyendo el valor 99 |
07/07/2017 | 3.8 | Agregado del campo promocional en Formato Interface POS para indicar que se aplica una promoción sobre un plan de pago |
| 04/09/2018 | 3.9 | Incorporación de la funcionalidad PEI en la mensajería |
14/12/2018 | 4.0 | Incorporación del apartado Antifraude e incorporación de la funcionalidad Antifraude en la mensajería |
| 08/02/2019 | 4.1 | Incorporación del apartado Tokenización e incorporación de la funcionalidad Tokenización en la mensajería |
| 03/04/2019 | 4.2 | Agregado del campo 0 (Compañía) en la mensajería de todos los tipos de transacciones. |
| 28/08/2019 | 4.3 | Incorporación de la funcionalidad Billeteras electrónicas en la mensajería. |
| 01/04/2020 | 4.4 | Incorporación de mensajería para operaciones eCommerce. |
| 22/06/2020 | 4.5 | Incorporación de mensajería para operaciones de Cuenta DNI. |
| 30/07/2020 | 4.6 | Incorporación de funcionalidad de Billeteras Mercado Pago con retiro de efectivo. |
| 28/08/2020 | 4.7 | Incorporación de consideraciones en el Formato de Interface POS en la tabla Plan de Pagos, para tiendas presenciales. |
| 22/09/2020 | 4.8 | Se actualiza el campo 54 (additionalAmount) como tipo de dato Importe, en la mensajería de Billeteras electrónicas. |
| 21/10/2020 | 4.9 | Incorporación de funcionalidad PEI No Presencial |
| 26/11/2020 | 4.10 | Agregado del campo Descripción en Formato de Interface POS para indicar la descripción sobre un plan de pago. |
| 11/12/2020 | 4.11 | Incorporación de funcionalidad de QR Adquiriente. |
| 16/12/2020 | 4.12 | Incorporación del campo afApplicationCondition para validar la aplicación de reglas antifraudes por el módulo AF de VTOL. |
| 05/03/2021 | 4.13 | Se actualiza el nombre y la descripción del campo 406 en la respuesta de la mensajería de QR Adquiriente. |
| 05/05/2021 | 4.14 | Incorporación de mensajería para Consultar tarjetas de Fidelidad |
| 11/05/2021 | 4.15 | Se quitan las referencias de la billetera Todo Pago, ya que dicha Billetera está incluida dentro de QR Adquiriente Prisma. |
Índice
Índice
Âncora _Toc485222713 _Toc485222713
1. Campos de los mensajes
| _Toc485222713 | |
| _Toc485222713 |
...
- Mercado Pago: La plataforma de pagos online más importante de América Latina
- Todo Pago: La plataforma de pagos de Prisma
Las operaciones soportadas en VTOL Server para Billeteras electrónicas son:
- SaleWallet = Permite realizar una compra presencial con billetera
- SaleWallet con cashback = Permite realizar una compra presencial y realizar retiro de efectivo. Sólo para billetera Mercado Pago.
- RefundWallet = Permite realizar una devolución (parcial o total) de una compra presencial con billetera realizada con anterioridad
- QuerySaleWallet = Permite realizar una consulta de una operación de compra con billetera para conocer si la misma fue autorizada y así obtener los datos de la misma por parte del Autorizador. Y además para Todo Pago se utilizará para informar las cuotas.
| Nota | ||
|---|---|---|
| ||
Las operatorias de billeteras electrónicas poseen tercer mensajeTercer Mensaje. |
Procedimiento para Mercado Pago
...
- Una vez recibida la respuesta de operación Aprobada por parte de Mercado Pago, se puede realizar lo siguiente:
- Para una venta con productos y cashout. Permite anular:
- Los productos y el cashout, todo junto. Esto se logra enviando un UnSyncCompletion=rollback
- Para una venta sólo con productos. Permita anular:
- Todos los productos. Esto se logra enviando un UnSyncCompletion=rollback.
- Para una venta con productos y cashout. Permite anular:
- No es posible realizar anulaciones intermedias.
Procedimiento para Todo Pago
El proceso de pagos con billetera virtual de Todo Pago difiere respecto de Mercado Pago, ya que el cliente en su app mobile simplemente selecciona la tarjeta con la cual realizará el pago, y luego el resto de la operatoria la deberá realizar el cajero, es decir, el ingreso de las cuotas, promociones, etc. El proceso se realizará de la siguiente manera:
- Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
- Recién en ese momento el comprador podrá efectuar la lectura del código QR impreso en la caja mediante su smartphone. Seleccionará la tarjeta con la cual realizará el pago. Y luego aceptará la tarjeta elegida en su app mobile.
- VTOL recibirá la información de la tarjeta del cliente, por medio de Todo Pago, y le responderá al POS que se deben ingresar las cuotas según los planes de pago disponibles (sólo para aquellos comercios que permitan pagos en cuotas).
- El POS ingresará las cuotas, y enviará la información a VTOL por medio de la transacción QuerySaleWallet.
- El POS recibirá la respuesta de la transacción a través de VTOL, quien informará si la operación resultó autorizada por Todo Pago.
- Puede darse el caso que VTOL responda "Consulte el pago por tiempo expirado". Este escenario puede surgir por algún problema de conexión y VTOL no pudo obtener el mensaje sobre el resultado de Todo Pago. Con este mensaje se le informa al POS que para conocer el resultado de la operación, deberá realizar una nueva consulta (transacción QuerySaleWallet). Las respuestas del QuerySaleWallet pueden ser las siguientes:
- VTOL responde "Aprobado". Indica que el pago fue autorizado por Todo Pago. El paso siguiente del POS es confirmar o cancelar la transacción, con un tercer mensaje.
- VTOL responde "Pago Rechazado". Indica que el pago no fue autorizado por Todo Pago. Por lo tanto la operación no puede continuar. El POS deberá iniciar una nueva transacción.
- Puede darse el caso que VTOL responda "Consulte el pago por tiempo expirado". Este escenario puede surgir por algún problema de conexión y VTOL no pudo obtener el mensaje sobre el resultado de Todo Pago. Con este mensaje se le informa al POS que para conocer el resultado de la operación, deberá realizar una nueva consulta (transacción QuerySaleWallet). Las respuestas del QuerySaleWallet pueden ser las siguientes:
- Por último, el POS deberá confirmar la operación, mediante el tercer mensaje (transacción UnsyncCompletion).
1.4.18.1 Requerimiento
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
...
Número
...
Nombre del campo
...
Tipo de dato
...
SaleWallet
...
Descripción
...
Tipo de Mensaje:
- Control = Mensaje de Control, para uso interno por parte de un módulo en su comunicación con el server.
- Data = Mensaje de la Aplicación cliente.
...
11
...
trxType
...
Alfanumérico
...
X
...
Tipo de Transacción:
- SaleWallet = Compra con billetera electrónica
- RefundWallet = Devolución de compra realizada con billetera electrónica
- QuerySaleWallet = Consulta de transacción de compra realizada con billetera electrónica
...
12
...
amount
...
Importe
...
X
...
Monto de la transacción. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales. Ej: 1000 equivale a 10.00
Nota: El importe debe ser el número correspondiente a la moneda informada
...
13
...
currencyPosCode
...
Alfanumérico
...
X
...
Tipos de moneda:
- $ = Pesos
- U$S = Dólares
Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-)
Nota: Para Todo Pago la moneda siempre es $ -pesos argentinos-
Importante: Tener en cuenta que operando con Mercado Pago siempre debe coincidir el país de la cuenta vendedor con el país de la cuenta comprador
...
Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD
...
25
...
dateTime
...
Numérico
...
X
...
Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
...
Contiene el Importe del "Cashout". 12 dígitos como máximo. Valor entero. Los últimos 2 dígitos corresponden a los decimales.
Para devoluciones, se debe enviar el monto total del cashout.
Para devolver sólo el cashout, se debe enviar el campo 12 (amount) con valor 0.
Sólo disponible para billetera de Mercado Pago.
...
O
Default = true
...
O
Default = true
...
O
Default = true
...
Indica si VTOL debe o no efectuar el chequeo de pendientes (se emplea para pagos parciales de tarjetas):
- True: activa chequeo de pendientes.
- False: desactiva chequeo de pendientes.
...
Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra con billetera
Formato:
codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12)
Longitud total de 32
Opcional en QuerySaleWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra
...
Tipo de billetera por la cual se cursará la transacción en el POS. Opciones:
1: Mercado Pago
2: Todo Pago
...
Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura del campo posTicket
...
-
...
Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet
Opcional en QuerySaleWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra
...
Título de la venta. Longitud máxima 100.
Si el POS no lo envía, VTOL tomará un valor por defecto. El siguiente label: "Pago con Mercado Pago en" + "CompanyName".
...
Descripción de la venta. Longitud máxima 100.
Si el POS no lo envía, VTOL tomará un valor por defecto. El siguiente label: "Pago realizado con QR. Por un monto de $amount. Y retiro de efectivo de $additionalAmount.".
Ejemplo
...
Request to VTOL (SaleWallet):
Request: {270:PG1lc3NhZ2U+CiAgICAgICA8aXRlbS1hZGQgc2VxPSIxIiBjb2RlPSIwMDAxIiBkaXNjb3VudGFibGU9InRydWUiIHVuaXRwcmljZT0iMjUuMCIgcXR5PSIxLjAiIGxldmVsMT0iTUVOIiBsZXZlbDI9IkNBU1VBTCIgc3VwcGxpZXI9IiIgYnJhbmQ9IkxFVklTIiB4cHJpY2U9IjI1LjAiIG1hZ25pdHVkZT0iMS4wIiBkZXNjcmlwdGlvbj0iSmVhbiBjYXN1YWwiIGN1cnJlbmN5PSIkIiAvPgogICAgICAgPGl0ZW0tYWRkIHNlcT0iMiIgY29kZT0iMDAwMiIgZGlzY291bnRhYmxlPSJ0cnVlIiB1bml0cHJpY2U9IjI4LjAiIHF0eT0iMi4wIiBsZXZlbDE9Ik1FTiIgbGV2ZWwyPSJDQVNVQUwiIHN1cHBsaWVyPSIiIGJyYW5kPSJMRVZJUyIgeHByaWNlPSI0OC4wIiBtYWduaXR1ZGU9IjEuMCIgZGVzY3JpcHRpb249IkplYW4gY2FzdWFsIiBjdXJyZW5jeT0iJCIgLz4KPC9tZXNzYWdlPg==;269:1;268:1120181116055713;13:$;12:1200;11:SaleWallet;4:DATA;3:VTOL;2:1;25:20181116055713;71:True;1:1;54:50000}
Request to VTOL (RefundWallet):
Request: {271:4379999999999999437;269:1;16:20181116;13:$;12:1200;11:RefundWallet;4:DATA;3:VTOL;2:1;25:20181116105619;71:True;1:1}
Request to VTOL (QuerySaleWallet):
Request: {271:2289999999999999228;269:1;16:20190214;268:11020190514050534;25:20190214050534;11:QuerySaleWallet}
...
El mensaje con la estructura del ticket estará en XML. El elemento raíz de ese mensaje XML deberá ser la etiqueta <message>, siendo la misma lo que se llamará encabezado.
La manera de ejecutar un comando es utilizando una etiqueta con la forma <elemento-comando>. El elemento "item" identifica a los artículos. De esta manera, si se desea, por ejemplo, agregar un nuevo artículo el comando a utilizar será <item-add>. En el cuerpo del mensaje podrá contener uno, ninguno o varios de estos comandos.
Cada uno de los comandos que se envían posee diversos atributos, los cuales identifican al elemento que se está enviando y definen diversas propiedades que poseen los mismos. Poseerá un número de secuencia, el cual identifica cada elemento unívocamente:
...
Propiedad
...
Tipo de dato
...
Descripción
...
Requerido
...
seq
...
Entero positivo
...
Número identificador único del elemento dentro de la transacción.
...
Sí
Cada comando posee una serie de atributos que definirán las distintas propiedades del elemento que se está agregando (además del número de secuencia antes mencionado).
Para el elemento ítem, los atributos serán los siguientes:
...
Elemento
...
Atributo
...
Tipo de dato
...
Descripción
...
Requerido
...
Valor ante ausencia
...
unitprice
...
Numérico positivo
...
Precio unitario del artículo en cuestión.
...
Si
...
...
xprice
...
Numérico positivo
...
Precio extendido del artículo en cuestión. Es igual a la cantidad por el precio unitario.
...
Si
...
...
qty
...
Entero positivo
...
Cantidad de artículos en la línea.
...
Si
...
...
magnitude
...
Numérico positivo
...
Si el artículo es mensurable por otro unidad que no sea la cantidad, deberá ser expresad en esta propiedad.
...
No
...
0
...
code
...
Alfanumérico
...
Código propio del artículo.
...
No
...
"-"
...
brand
...
Alfanumérico
...
Marca del artículo.
...
No
...
"-"
...
supplier
...
Alfanumérico
...
Proveedor al que pertenece el artículo.
...
No
...
"-"
...
discountable
...
Alfanumérico
...
Si el artículo es puede recibir descuentos o no.
...
No
...
"-"
...
level1
...
Alfanumérico
...
Nivel 1 de categorización del artículo. Anteriormente este nivel se conocía con el nombre de Departamento.
...
No
...
"-"
...
level2
...
Alfanumérico
...
Nivel 2 de categorización del artículo. Anteriormente este nivel se conocía como la Familia del artículo.
...
No
...
"-"
...
level3
...
Alfanumérico
...
Nivel 3 de categorización del artículo. Anteriormente este nivel se conocía como la Categoría del artículo.
...
No
...
"-"
...
level4
...
Alfanumérico
...
Nivel 4 de categorización del artículo. Anteriormente este nivel se conocía como la subcategoría del artículo.
...
No
...
"-"
...
Moneda utilizada en el precio del ítem
Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-).
...
Ejemplo
...
| language | xml |
|---|---|
| theme | Eclipse |
...
1.4.18.1 Requerimiento
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
Número | Nombre del campo | Tipo de dato | SaleWallet | RefundWallet | QuerySaleWallet | Descripción |
|---|---|---|---|---|---|---|
| 0 | company | Numérico | X | X | X | Identificador de la compañía donde se generó la transacción. |
| 1 | store | Alfanumérico | X | X | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | X | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
| 3 | server | Alfanumérico | X | X | X | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
| 4 | messageType | Alfanumérico | X | X | X | Tipo de Mensaje:
|
11 | trxType | Alfanumérico | X | X | X | Tipo de Transacción:
|
12 | amount | Importe | X | X | - | Monto de la transacción. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales. Ej: 1000 equivale a 10.00 Nota: El importe debe ser el número correspondiente a la moneda informada |
13 | currencyPosCode | Alfanumérico | X | X | - | Tipos de moneda:
Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-) Importante: Tener en cuenta que operando con Mercado Pago siempre debe coincidir el país de la cuenta vendedor con el país de la cuenta comprador |
| 14 | payments | Numérico | - | - | O | Cantidad de cuotas por las cuales se realizará el pago. 2 dígitos como máximo Si es sin cuotas, el valor por defecto es 1 |
| 15 | plan | Alfanumérico | - | - | O | Plan. 1 caracter de longitud |
| 16 | originalDate | Numérico | - | X | X | Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD |
| 24 | lastTrxId | Numérico | O | O | O | Utilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente. |
25 | dateTime | Numérico | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS |
| 53 | paymentCondition | Alfanumérico | - | - | O | Condición de pago. Sólo se encuentra presente si existe una condición de pago vinculada con la transacción |
| 54 | additionalAmount | Importe | O | O | - | Contiene el Importe del "Cashout". 12 dígitos como máximo. Valor entero. Los últimos 2 dígitos corresponden a los decimales. Para devoluciones, se debe enviar el monto total del cashout. Para devolver sólo el cashout, se debe enviar el campo 12 (amount) con valor 0. Sólo disponible para billetera de Mercado Pago. |
| 71 | checkPendingString | Alfanumérico | O Default = true | O Default = true | O Default = true | Indica si VTOL debe o no efectuar el chequeo de pendientes (se emplea para pagos parciales de tarjetas):
|
| 268 | walletPosTrxId | Alfanumérico | X | - | O | Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra con billetera Formato: Opcional en QuerySaleWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra |
| 269 | walletType | Numérico | X | X | X | Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago |
| 270 | posTicket | Base 64 | X | - | - | Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura del campo posTicket |
| 271 | walletPaymentId | Alfanumérico | - | X | O | Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet Opcional en QuerySaleWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra |
| 311 | purchaseTitle | Alfanumérico | O | - | - | Título de la venta. Longitud máxima 100. Si el POS no lo envía, VTOL tomará un valor por defecto. El siguiente label: "Pago con Mercado Pago en" + "CompanyName". |
| 312 | purchaseDesc | Alfanumérico | O | - | - | Descripción de la venta. Longitud máxima 100. Si el POS no lo envía, VTOL tomará un valor por defecto. El siguiente label: "Pago realizado con QR. Por un monto de $amount. Y retiro de efectivo de $additionalAmount.". |
Ejemplo
Request to VTOL (SaleWallet): Request: {270:PG1lc3NhZ2U+CiAgICAgICA8aXRlbS1hZGQgc2VxPSIxIiBjb2RlPSIwMDAxIiBkaXNjb3VudGFibGU9InRydWUiIHVuaXRwcmljZT0iMjUuMCIgcXR5PSIxLjAiIGxldmVsMT0iTUVOIiBsZXZlbDI9IkNBU1VBTCIgc3VwcGxpZXI9IiIgYnJhbmQ9IkxFVklTIiB4cHJpY2U9IjI1LjAiIG1hZ25pdHVkZT0iMS4wIiBkZXNjcmlwdGlvbj0iSmVhbiBjYXN1YWwiIGN1cnJlbmN5PSIkIiAvPgogICAgICAgPGl0ZW0tYWRkIHNlcT0iMiIgY29kZT0iMDAwMiIgZGlzY291bnRhYmxlPSJ0cnVlIiB1bml0cHJpY2U9IjI4LjAiIHF0eT0iMi4wIiBsZXZlbDE9Ik1FTiIgbGV2ZWwyPSJDQVNVQUwiIHN1cHBsaWVyPSIiIGJyYW5kPSJMRVZJUyIgeHByaWNlPSI0OC4wIiBtYWduaXR1ZGU9IjEuMCIgZGVzY3JpcHRpb249IkplYW4gY2FzdWFsIiBjdXJyZW5jeT0iJCIgLz4KPC9tZXNzYWdlPg==;269:1;268:1120181116055713;13:$;12:1200;11:SaleWallet;4:DATA;3:VTOL;2:1;25:20181116055713;71:True;1:1;54:50000} Request to VTOL (RefundWallet): Request: {271:4379999999999999437;269:1;16:20181116;13:$;12:1200;11:RefundWallet;4:DATA;3:VTOL;2:1;25:20181116105619;71:True;1:1} Request to VTOL (QuerySaleWallet): Request: {271:2289999999999999228;269:1;16:20190214;268:11020190514050534;25:20190214050534;11:QuerySaleWallet} |
Estructura del campo posTicketÂncora _campoPosTicket _campoPosTicket
El mensaje con la estructura del ticket estará en XML. El elemento raíz de ese mensaje XML deberá ser la etiqueta <message>, siendo la misma lo que se llamará encabezado.
La manera de ejecutar un comando es utilizando una etiqueta con la forma <elemento-comando>. El elemento "item" identifica a los artículos. De esta manera, si se desea, por ejemplo, agregar un nuevo artículo el comando a utilizar será <item-add>. En el cuerpo del mensaje podrá contener uno, ninguno o varios de estos comandos.
Cada uno de los comandos que se envían posee diversos atributos, los cuales identifican al elemento que se está enviando y definen diversas propiedades que poseen los mismos. Poseerá un número de secuencia, el cual identifica cada elemento unívocamente:
Propiedad | Tipo de dato | Descripción | Requerido |
|---|---|---|---|
seq | Entero positivo | Número identificador único del elemento dentro de la transacción. | Sí |
Cada comando posee una serie de atributos que definirán las distintas propiedades del elemento que se está agregando (además del número de secuencia antes mencionado).
Para el elemento ítem, los atributos serán los siguientes:
Elemento | Atributo | Tipo de dato | Descripción | Requerido | Valor ante ausencia |
|---|---|---|---|---|---|
| Ítem | unitprice | Numérico positivo | Precio unitario del artículo en cuestión. | Si |
|
xprice | Numérico positivo | Precio extendido del artículo en cuestión. Es igual a la cantidad por el precio unitario. | Si |
| |
qty | Entero positivo | Cantidad de artículos en la línea. | Si |
| |
magnitude | Numérico positivo | Si el artículo es mensurable por otro unidad que no sea la cantidad, deberá ser expresad en esta propiedad. | No | 0 | |
code | Alfanumérico | Código propio del artículo. | No | "-" | |
brand | Alfanumérico | Marca del artículo. | No | "-" | |
supplier | Alfanumérico | Proveedor al que pertenece el artículo. | No | "-" | |
discountable | Alfanumérico | Si el artículo es puede recibir descuentos o no. | No | "-" | |
level1 | Alfanumérico | Nivel 1 de categorización del artículo. Anteriormente este nivel se conocía con el nombre de Departamento. | No | "-" | |
level2 | Alfanumérico | Nivel 2 de categorización del artículo. Anteriormente este nivel se conocía como la Familia del artículo. | No | "-" | |
level3 | Alfanumérico | Nivel 3 de categorización del artículo. Anteriormente este nivel se conocía como la Categoría del artículo. | No | "-" | |
level4 | Alfanumérico | Nivel 4 de categorización del artículo. Anteriormente este nivel se conocía como la subcategoría del artículo. | No | "-" | |
| description | Alfanumérico | Descripción del ítem | Si | ||
| currency | Alfanumérico | Moneda utilizada en el precio del ítem Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-). | Si | ||
| measure | Alfanumérico | Unidad de medida del ítem. Valores posibles: unit - pack | No | "unit" |
Ejemplo
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
<message>
<item-add seq="1" code="0001" discountable="true" unitprice="25.0" qty="1.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="25.0" magnitude="1" description="Jean casual" currency="$" />
<item-add seq="2" code="0002" discountable="true" unitprice="28.0" qty="2.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="48.0" magnitude="1" description="Jean casual" currency="$" />
</message> |
...
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
[
{
"providerPosCode":"VIG",
"bankCode":"7",
"installments":[
{
"paymentOptionId":"1",
"quantity":"1",
"amountPerInstallment":150000,
"totalAmount":150000,
"surcharge":0,
"nominalAnnualRate":0
},
{
"paymentOptionId":"2",
"quantity":"6",
"amountPerInstallment":25000,
"totalAmount":150000,
"surcharge":1100,
"nominalAnnualRate":1500
}
]
},
{
"providerPosCode":"VI",
"installments":[
{
"paymentOptionId":"3",
"quantity":"12",
"amountPerInstallment":15000,
"totalAmount":180000,
"surcharge":1256,
"nominalAnnualRate":1487
}
]
},
{
"providerPosCode":"MC",
"installments":[
{
"paymentOptionId":"4",
"quantity":"1",
"amountPerInstallment":150000,
"totalAmount":150000,
"surcharge":0,
"nominalAnnualRate":0
},
{
"paymentOptionId":"5",
"quantity":"12",
"amountPerInstallment":15000,
"totalAmount":180000,
"surcharge":1256,
"nominalAnnualRate":1487
}
]
},
{
"providerPosCode":"MCP",
"bankCode":"34",
"installments":[
{
"paymentOptionId":"6",
"quantity":"12",
"amountPerInstallment":12500,
"totalAmount":150000,
"surcharge":130,
"nominalAnnualRate":120
}
]
}
] |
Estructura del campo walletBenefits (402)
El mensaje con la estructura de los beneficios estará en JSON. Estará conformado por los siguientes campos:
...
Identificador de la opción de pago creada por el POS. Máximo 10 caracteres. Debe ser único dentro del campo "walletBenefits".
Permite trazabilidad con la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente.
El ID del beneficio aplicado es retornado por VTOL en el mensaje de respuesta de la venta en el campo 405.
...
discountPercentage
...
maximumDiscountAmount
...
Ejemplo del campo walletBenefits (402)
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
[
{
"benefitCardId":"1",
"providerPosCode":"CC",
"discountPercentage":2000,
"maximumDiscountAmount":25000
},
{
"benefitCardId":"2",
"providerPosCode":"CP",
"discountPercentage":3000,
"maximumDiscountAmount":50000
}
] |
1.4.24.2 Respuesta
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
...
Número
...
Nombre del campo
...
Tipo de dato
...
SaleWallet
...
RefundWallet
...
QueryWallet
...
Descripción
...
Contiene el importe que pagó el cliente, el cual puede variar si pagó con intereses o se aplicó algún descuento. Valor entero. Los últimos 2 dígitos corresponden a los decimales.
...
Tipos de moneda:
- $ = Pesos
...
Código de autorización informado por el Autorizador
...
Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción
...
Puede contener uno de los siguientes valores:
- Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27
- Error = ver sección Códigos de error del CORE
- TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
...
Código de Respuesta emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas
...
Mensaje de la Respuesta relacionado con el código del campo 27
...
29
...
serialNumber
...
Numérico
...
Número identificatorio de la terminal en la que se procesó la transacción.
Retorna en operaciones aprobadas.
...
30
...
businessNumber
...
Numérico
...
Número de comercio en el que se procesó la transacción.
Retorna en operaciones aprobadas.
...
Tipo de pago. Valores posibles:
0: Tarjeta
1: Efectivo
...
Estado de la transacción de pago informado por el Autorizador. Estados posibles:
0: Aprobado
1: Devuelto
2: Pendiente
3: Autorizado
4: En Progreso
6: Rechazado
7: Cancelado
8: Contracargo
...
Identificador de la opción de pago seleccionada por el cliente en su billetera virtual. Según la tarjeta, el banco, y las cuotas elegidas por el cliente, se vinculará con el paymentOptionId enviado por la caja en el requerimiento.
...
Monto original de la transacción: de venta o de devolución.
...
Contiene el importe que se descontó sobre el importe original. Debido a la aplicación de una tarjeta de beneficio vinculada en la billetera virtual del cliente.
...
}
] |
Estructura del campo walletBenefits (402)
El mensaje con la estructura de los beneficios estará en JSON. Estará conformado por los siguientes campos:
| Parámetro | Tipo de dato | Requerido | Descripción | |
|---|---|---|---|---|
| benefitCardId | Alfanumérico | Si | Identificador de la opción de pago creada por el POS. Máximo 10 caracteres. Debe ser único dentro del campo "walletBenefits". Permite trazabilidad con la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente. El ID del beneficio aplicado es retornado por VTOL en el mensaje de respuesta de la venta en el campo 405. | |
| providerPosCode | Alfanumérico | Si | Código de la tarjeta de beneficio configurada en VTOL. Por ejemplo para Clarin 365 el código es "CC". | |
discountPercentage | Numérico | Si | Porcentaje de descuento a aplicar sobre la compra. Valor entero. Los 2 últimos dígitos corresponden a los decimales. | |
maximumDiscountAmount | Numérico | Si | Importe máximo de descuento a aplicar sobre la compra. Valor entero. Los 2 últimos dígitos corresponden a los decimales. | |
Ejemplo del campo walletBenefits (402)
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
[
{
"benefitCardId":"1",
"providerPosCode":"CC",
"discountPercentage":2000,
"maximumDiscountAmount":25000
},
{
"benefitCardId":"2",
"providerPosCode":"CP",
"discountPercentage":3000,
"maximumDiscountAmount":50000
}
] |
1.4.24.2 Respuesta
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
Número | Nombre del campo | Tipo de dato | SaleWallet | RefundWallet | QueryWallet | Descripción |
|---|---|---|---|---|---|---|
| 0 | company | Numérico | X | X | X | Identificador de la compañía donde se generó la transacción |
| 1 | store | Alfanumérico | X | X | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | X | X | Identificación del nodo, en el sitio originador, donde se generó la transacción. |
| 6 | cardNumber | Alfanumérico | X | - | O | Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR. |
| 12 | amount | Importe | X | - | X | Contiene el importe que pagó el cliente, el cual puede variar si pagó con intereses o se aplicó algún descuento. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
| 13 | currencyPosCode | Alfanumérico | X | - | X | Tipos de moneda:
|
| 14 | payments | Numérico | X | - | O | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. |
| 22 | authorizationCode | Alfanumérico | X | - | X | Código de autorización informado por el Autorizador |
| 24 | trxId | Numérico | X | X | X | Identificador de la transacción. |
| 25 | dateTime | Numérico | X | X | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción |
| 26 | responseCode | Alfanumérico | X | X | X | Puede contener uno de los siguientes valores:
|
| 27 | isoCode | Numérico | X | X | X | Código de Respuesta emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas |
| 28 | responseMessage | Alfanumérico | X | X | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
29 | serialNumber | Numérico | O | O | O | Número identificatorio de la terminal en la que se procesó la transacción. Retorna en operaciones aprobadas. |
30 | businessNumber | Numérico | O | O | O | Número de comercio en el que se procesó la transacción. Retorna en operaciones aprobadas. |
| 81 | responseAuth | Alfanumérico | O | O | O | Mensaje de repuesta para imprimir en el ticket del POS. Retorna en operaciones aprobadas. Contiene información generada por el Autorizador. |
| 140 | paymentType | Numérico | - | - | X | Tipo de pago. Valores posibles: 0: Tarjeta |
| 142 | providerName | Alfanumérico | - | - | O | Proveedor de la tarjeta seleccionada al momento de efectuar el pago QR. |
| 147 | providerPosCode | Alfanumérico | O | - | O | Código del Provider. Retornará cuando la transacción fue aprobada por el Autorizador. |
| 166 | trxReferenceNumber | Numérico | X | X | - | Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato |
| 271 | walletPaymentId | Alfanumérico | X | - | X | Identificador del número de pago informado por el Autorizador |
| 272 | amountRefunded | Importe | - | - | X | Monto devuelto en la transacción |
| 273 | paymentStatus | Alfanumérico | - | - | X | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado |
| 306 | cardIssuingBank | Alfanumérico | O | - | O | Banco emisor de la tarjeta. Retornará cuando la transacción fue aprobada por el Autorizador. |
| 404 | paymentOptionId | Alfanumérico | X | - | O | Identificador de la opción de pago seleccionada por el cliente en su billetera virtual. Según la tarjeta, el banco, y las cuotas elegidas por el cliente, se vinculará con el paymentOptionId enviado por la caja en el requerimiento. |
| 405 | benefitCardId | Alfanumérico | X | - | O | Identificador de la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente. |
| 406 | originalAmount | Importe | X | - | O | Monto original de la transacción: de venta o de devolución. |
| 407 | amountDiscounted | Importe | X | - | O | Contiene el importe que se descontó sobre el importe original. Debido a la aplicación de una tarjeta de beneficio vinculada en la billetera virtual del cliente. Sólo retorna cuando se aplicó un descuento. |
1.4.25 Consultar tarjetas de Fidelidad
Operatoria para realizar desde el Punto de Venta consultas de las tarjetas de fidelidad.
1.4.25.1 Requerimiento
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
Número | Nombre del campo | Tipo de dato | CardQuery | Descripción |
|---|---|---|---|---|
| 0 | company | Numérico | X | Identificador de la compañía donde se generó la transacción. |
| 1 | store | Alfanumérico | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | Identificación del nodo, en el sitio originador, donde se generó la transacción |
| 3 | server | Alfanumérico | X | Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL') |
| 4 | messageType | Alfanumérico | X | Tipo de Mensaje:
|
11 | trxType | Alfanumérico | X | Tipo de Transacción:
|
25 | dateTime | Numérico | X | Fecha y hora de realización de la transacción en formato: YYYYMMDDHHMMSS |
| 269 | walletType | Numérico | X | Tipo de billetera por la cual se realizará la consulta. Opciones: 2: Adquiriente Prisma |
| 408 | loyaltyCard | Numérico | X | Tipo de tarjeta de fidelidad que se quiere consultar. Opciones: 1: Clarín 365 |
| 157 | customerDoc | Numérico | X | Número de documento del cliente que realiza la consulta. |
Ejemplo
Request to VTOL: Request: {157:11111111;408:1;269:2;11:CardQuery;4:DATA;3:VTOL;2:1;25:20210503192959;71:True;1:1;0:1} |
1.4.25.2 Respuesta
| Informações | ||
|---|---|---|
| ||
X = Obligatorio |
Número | Nombre del campo | Tipo de dato | CardQuery | Descripción |
|---|---|---|---|---|
| 0 | company | Numérico | X | Identificador de la compañía donde se generó la transacción |
| 1 | store | Alfanumérico | X | Identificador del sitio originador de la transacción |
| 2 | node | Numérico | X | Identificación del nodo, en el sitio originador, donde se generó la transacción. |
| 6 | cardNumber | Alfanumérico | X | Número de Tarjeta del cliente. Si es una tarjeta de fidelidad, retornará en plano. |
| 25 | dateTime | Numérico | X | Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción |
| 26 | responseCode | Alfanumérico | X | Puede contener uno de los siguientes valores:
|
| 27 | isoCode | Numérico | X | Código de Respuesta emitido por el centro autorizador. 3 dígitos como máximo. Ver sección: Códigos de Respuesta de VTOL Server para Consulta de Fidelidad |
| 28 | responseMessage | Alfanumérico | X | Mensaje de la Respuesta relacionado con el código del campo 27 |
| 292 | customerFirstName | Alfanumérico | X | Nombre del tarjetahabiente. |
| 293 | customerLastName | Alfanumérico | X | Apellido del tarjetahabiente. |
| 409 | loyaltyCardCategory | Alfanumérico | X | Categoría de la tarjeta de fidelidad. Puede retornar los siguientes valores:
|
Ejemplo
Response from VTOL: Response: {25:20210503193023;2:1;1:1;0:1;6:44123456789010;292:Juan;293:Perez;409:CLASSIC;26:ISO8583;27:00;28:APROBADA} |
Âncora _Toc485222740 _Toc485222740
1.5 Códigos de Respuesta al POS
| _Toc485222740 | |
| _Toc485222740 |
...
| Código | Descripción | |
|---|---|---|
| 00 | APROBADA | |
| 500 | No se encuentra la transaccion original | |
| 501 | El campo WalletPosTrxId es requerido | |
| 502 | El campo WalletType es requerido | |
| 503 | No esta configurado una Compañia MP | |
| 504 | No esta configurado una Caja MP | |
| 505 | El tipo de billetera es invalido | |
| 506 | El campo WalletPaymentId es requerido | |
| 507 | El campo OriginalDate es requerido | |
| 508 | No es posible devolver una devolucion | |
| 509 | Estado trx original no acepta devolucion | |
| 510 | Importe devolucion supero monto limite | |
| 511 | No se pudo realizar la orden de pago | |
| 512 | La transaccion no posee estado | |
| 513 | El campo posTicket es requerido | |
| 514 | Tiempo expirado. Elija Consultar o Cancelar pago | |
| 515 | Tiempo expirado confirmacion devolucion | |
| 516 | Pago aun no realizado, desea seguir esperando? | |
| 517 | Estado trx original no acepta devolucion | |
| 518 | No se encuentra la devolucion | |
| 519 | Acceso a MP no esta autorizado | |
| 520 | Accion a MP no esta autorizada | |
| 521 | El campo WalletPosTrxId es invalido | |
| 523 | Estado trx original no acepta devolucion | |
| 524 | Importe invalido para devolucion | |
| 525 | Estado trx original no acepta devolucion | |
| 526 | Compañia MP no permite operar | |
| 527 | Numero devoluciones parciales superados | |
| 528 | El pago es antiguo para ser devuelto | |
| 529 | No es posible devolver una devolucion | |
| 530 | Compañia MP sin dinero para devolver | |
| 531 | Compañia MP sin dinero disponible | |
| 532 | Estado trx original no acepta devolucion | |
| 533 | Devolucion parcial no soportada | |
| 534 | Url de notificacion invalido | |
| 535 | El monto de la transaccion es invalido | |
| 536 | Error general por parte de MP | |
| 537 | No se encuentra la transaccion original | |
| 538 | El campo WalletPosTrxId es requerido | |
| 539 | Devuelto | |
| 540 | Pendiente | |
| 541 | Autorizado | |
| 542 | En Progreso | |
| 543 | En mediacion | |
| 544 | Rechazado | |
| 545 | Cancelado | |
| 546 | Contracargo | |
| 547 | No se encontró la trx original | |
| 548 | Error en comunicación | |
| 549 | No existe comunicación con Mercado Pago | |
| 550 | Error al consultar venta original online | |
| 552 | Orden no generada por Prisma | |
| 553 | Pago Rechazado por parte de Prisma | |
| 554 | Esta operación requiere autorización | |
| 555 | Esta operación requiere autorización | |
| 556 | Pago rechazado, reintente con otro medio de pago | |
| 557 | Pago rechazado, reintente con otro medio de pago | |
| 558 | Pago rechazado, reintente con otro medio de pago | |
| 559 | Pago rechazado, reintente con otro medio de pago | Pago rechazado, reintente con otro medio de pago |
| 560 | Pago rechazado, reintente con otro medio de pago | |
| 561560 | Pago rechazado, reintente con otro medio de pago | |
| 561 | No fue posible procesar su pago, intente más tarde | |
| 562 | No fue posible procesar su pago, intente más tarde | |
| 563 | No fue posible procesar su pago, intente más tarde | |
| 564 | No fue posible procesar su pago, intente más tarde | |
| 565 | No fue posible procesar su pago, intente más tarde | |
| 566 | La cantidad de cuotas seleccionada es inválida | |
| 567 | La cantidad de cuotas seleccionada es inválida | |
| 568 | Tarjeta de crédito vencida | |
| 569 | Tarjeta de crédito no habilitada | |
| 570 | Fondos insuficientes, reintente otro medio de pago | |
| 571 | Fondos insuficientes, reintente otro medio de pago | |
| 572 | Datos incorrectos, revíselos y reintente | |
| 573 | Datos incorrectos, revíselos y reintente | |
| 574 | No fue posible procesar su pago, intente más tarde | |
| 562575 | No fue posible procesar su pago, intente más tarde563 | |
| 576 | Tarjeta no vigente, reintente otro medio de pago | |
| 577 | Esta operación requiere autorización | |
| 578 | No fue posible procesar su pago, intente más tarde | |
| 564579 | No fue posible procesar su pago, intente más tarde | |
| 565 | No fue posible procesar su pago, intente más tarde | |
| 566 | La cantidad de cuotas seleccionada es inválida | |
| 567 | La cantidad de cuotas seleccionada es inválida | |
| 568 | Tarjeta de crédito vencida | |
| 569 | Tarjeta de crédito no habilitada | |
| 570 | Fondos insuficientes, reintente otro medio de pago | |
| 571 | Fondos insuficientes, reintente otro medio de pago | |
| 572 | Datos incorrectos, revíselos y reintente | |
| 573 | Datos incorrectos, revíselos y reintente | |
| 574 | No fue posible procesar su pago, intente más tarde | |
| 575 | No fue posible procesar su pago, intente más tarde | |
| 576 | Tarjeta no vigente, reintente otro medio de pago | |
| 577 | Esta operación requiere autorización | |
| 578 | No fue posible procesar su pago, intente más tarde | |
| 579 | No fue posible procesar su pago, intente más tarde | |
| 580 | La cantidad de cuotas seleccionada es inválida | |
| 581 | Datos incorrectos, revíselos y reintente | |
| 582 | Datos incorrectos, revíselos y reintente | |
| 583 | Las cuotas informadas son incorrectas | |
| 584 | No existe la compra que se desea anular | |
| 585 | El originante no es válido | |
| 586 | El comercio informado es inválido | |
| 587 | El establecimiento informado es inválido | |
| 588 | El establecimiento no pertenece al comercio | |
| 589 | El punto de venta informado es inválido | |
| 590 | El punto de venta no pertenece al establecimiento | |
| 591 | El tipo de documento es inválido | |
| 592 | Se debe informar el ID de la operación | |
| 593 | Se debe informar un timeStamp | |
| 594 | Se debe informar el traceNumber | |
| 595 | Intención de pago vencida | |
| 598 | Las cuotas del pago ya fueron informadas | |
| 650 | Importe de devolución de cashout invalido | |
| 651 | Importe de cashout invalido | |
| 652 | Medio de pago inválido | |
| 733 | La transacción no corresponde a una operación de Billeteras Electrónicas | |
| 734 | No es posible cancelar la transacción informada |
...
| tarde | |
| 580 | La cantidad de cuotas seleccionada es inválida |
| 581 | Datos incorrectos, revíselos y reintente |
| 582 | Datos incorrectos, revíselos y reintente |
| 583 | Las cuotas informadas son incorrectas |
| 584 | No existe la compra que se desea anular |
| 585 | El originante no es válido |
| 586 | El comercio informado es inválido |
| 587 | El establecimiento informado es inválido |
| 588 | El establecimiento no pertenece al comercio |
| 589 | El punto de venta informado es inválido |
| 590 | El punto de venta no pertenece al establecimiento |
| 591 | El tipo de documento es inválido |
| 592 | Se debe informar el ID de la operación |
| 593 | Se debe informar un timeStamp |
| 594 | Se debe informar el traceNumber |
| 595 | Intención de pago vencida |
| 598 | Las cuotas del pago ya fueron informadas |
| 650 | Importe de devolución de cashout invalido |
| 651 | Importe de cashout invalido |
| 652 | Medio de pago inválido |
| 733 | La transacción no corresponde a una operación de Billeteras Electrónicas |
| 734 | No es posible cancelar la transacción informada |
| Âncora | ||||
|---|---|---|---|---|
|
A continuación se detallan las respuestas posibles de VTOL Server, cuando se realizan operaciones no presenciales:
Código | Descripción | Observaciones |
|---|---|---|
| 760 | Datos del tarjetahabiente inválidos. | VTOL valida los datos requeridos del tarjetahabiente. Si VPB no los manda, retorna este mensaje. |
| 99 | Datos de provider inválidos. | VTOL valida los datos de Provider, Bank y Brand, a partir del prefijo configurado en VTOL. Esos datos se contrastan con los datos de la tarjeta enviados por el POS: Si el POS manda los datos de Provider, Bank o Brand, y si VTOL valida que son incorrectos según los datos cargados en Vtol, entonces retorna este mensaje. |
| 762 | Error de configuración de comercio en VTOL. | VTOL valida que se encuentren configurados los datos del Comercio: Datos tributarios y Datos por canal. Si no están configurados en VTOL Server, retorna este mensaje. |
| 763 | La preautorización expiró | VTOL valida que la pre-autorización no se encuentre vencida. Si la pre-autorización está vencida, retorna este mensaje. |
| 764 | Monto inválido | En la Captura, cuando el POS manda un monto que se encuentra fuera de los porcentajes de variación, VTOL Server retorna este mensaje. |
| Âncora | ||||
|---|---|---|---|---|
|
A continuación se detallan las respuestas posibles de VTOL Server, cuando se realizan operaciones no presencialesconsultas de tarjetas de fidelidad:
Código | Descripción | Observaciones |
|---|
VTOL valida los datos de Provider, Bank y Brand, a partir del prefijo configurado en VTOL. Esos datos se contrastan con los datos de la tarjeta enviados por el POS:
Si el POS no los envía, no se validan en VTOL Server.
Si en el prefijo el valor de Banco es DEFAULT en VTOL, en caso de que el POS mande el Bank, VTOL no realiza ninguna validación.
Si en el Provider el valor de Marca es DEFAULT en Vtol, en caso de que el POS mande el Brand, VTOL no realiza ninguna validación.
Si el POS manda los datos de Provider, Bank o Brand, y si VTOL valida que son incorrectos según los datos cargados en Vtol, entonces retorna este mensaje.
| 770 | Cliente no encontrado en servicio de fidelidad | El servicio de fidelidad respondió que el cliente no fue encontrado en su base de datos. |
| 771 | El cliente no está activo en servicio de fidelidad | El servicio de fidelidad respondió que el cliente no tiene ninguna tarjeta activa. |
| 772 | Error en el servicio de fidelidad | Cuando el servicio de fidelidad no está disponible o se vence el timeout. |
| 773 | Error de configuración en VTOL. | VTOL valida que se |
encuentre configurada la API Key del Comercio para consultar con Bimo, en las propiedades de configuración. Si no están configurados en VTOL Server, o si Bimo responde un error 400, VTOL retorna este mensaje al POS. |
VTOL valida que la pre-autorización no se encuentre vencida.
Primero se busca el valor de vencimiento configurado en VTOL Server y si no lo tiene configurado, toma el valor por defecto de rs_system_property.
Si la pre-autorización está vencida, retorna este mensaje.
Primero se busca el valor de variación de montos configurado en VTOL y si no tiene configurado, toma el valor por defecto de rs_system_property
| 774 | Es requerido el documento del cliente | El POS no envió el número de DNI del cliente. |
| 775 | Es requerido el tipo de tarjeta de fidelidad | El POS no envió el tipo de tarjeta de fidelidad del cliente. |
| 776 | El documento no es valido | El número de DNI enviado no tiene el formato correcto. |
| 777 | Tipo de tarjeta de fidelidad no válido. | El tipo de tarjeta de fidelidad enviado no está soportado. |
| 778 | Consulta no disponible para esta billetera | El tipo de consulta no es soportado por el tipo de billetera enviado por el POS en el campo WalletType. |
Âncora _Código_de_errores _Código_de_errores
Âncora _Toc485222741 _Toc485222741
1.6 Código de errores del CORE
| _Código_de_errores | |
| _Código_de_errores |
| _Toc485222741 | |
| _Toc485222741 |
...