...
- Mercado Pago
- Yacaré
- Plus Pagos
- Rappi PaylessRappiPayless
Las operaciones soportadas en VTOL Server para Billeteras electrónicas son:
...
- El cliente realiza un pedido en la app de Rappi. Un mensajero de Rappi recolecta los productos en el comercio y confirma en la app.
- Se genera un código QR en la app de Rappi. El repartidor se acerca a la caja para realizar el pago. El código QR será el medio de pago.
- El cajero tiene la opción de escanear un código QR, un código de barras o ingresar manualmente un código.
- El POS genera una transacción de venta SaleWallet con Billetera Rappi y la envía a VTOL, enviando todos los datos además del código de pago (es el QR generado en la app).
- VTOL recibe el mensaje, y lo procesa.
- VTOL envía una solicitud de autorización de pago a la API de Rappi.
- Rappi procesa el mensaje, y responde si el pago fue aprobado.
- VTOL recibe la respuesta del pago.
- Si VTOL no recibe la respuesta en el tiempo configurado para recibirla, reintentará enviar la solicitud de autorización de pago. Si aún no recibe la respuesta de Rappi, responderá a la caja "La comunicación con Rappi no está disponible. El personal de Rappi necesita este código para pagar con tarjeta de débito".
- VTOL informa al POS la respuesta del Autorizador.
- Por último, el POS deberá confirmar la operación, mediante el tercer mensaje (transacción UnsyncCompletion).
- Finaliza el flujo de la operación.
Procedimiento para Pago Offline con Rappi Payless:
1. El POS envía un SaleWallet a VTOL con la billetera Rappi (walletType: 8).
2. VTOL envía la autorización a Rappi, pero no hay conexión.
3. VTOL responde al POS código 620, “Reintente pago por modo offline con código PIN”. Y la operación queda rechazada en VTOL.
4. El POS calcula el código PIN utilizando un barcode vigente. Y se lo informa al rappi tendero para que lo ingrese en su app y así se autoriza el pago.
5. El POS envía una nueva SaleWallet a VTOL, informando el campo 22 (authorizationCode) con el valor del PIN. Esto es para dejar asentada en VTOL que la transacción se realizó en modo offline.
6. VTOL responde “Aprobado” al POS. La autorización se realiza de forma offline, es decir no se envía ningún mensaje a Rappi.
7. El POS envía tercer mensaje a VTOL, "commit" para confirmar la transacción.
8. El POS imprime el ticket y entrega los productos al rappi tendero.
1.4.18.1 Requerimiento
| 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 | O | - | O | Tarjeta enmascarada seleccionada al momento de efectuar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago. Para Rappi este campo no retorna. |
| 12 | amount | Importe | X | - | X | Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales. |
| 13 | currencyPosCode | Alfanumérico | O | - | X | Tipos de moneda:
|
| 14 | payments | Numérico | - | - | O | Cantidad de cuotas seleccionadas al momento de realizar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago |
| 22 | authorizationCode | Alfanumérico | O | - | O | Código de autorización informado por el Autorizador. Para Mercado Pago sólo retorna cuando el cliente paga con tarjeta de crédito o débito. Para Yacaré este campo no retorna.Para Rappi este campo no retorna. |
| 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. 3 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 |
| 54 | additionalAmount | Importe | O | O | O | Contiene el Importe del "Cashout". Para aquellas operaciones realizadas con retiro de efectivo. Valor entero. Los últimos 2 dígitos corresponden a los decimales. Sólo disponible para billetera Mercado Pago. |
| 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. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago |
| 147 | providerPosCode | Lista | O | - | - | Lista de proveedores/tarjetas que coinciden con la tarjeta ingresada en la app de la billetera electrónica. Ejemplo: {VI, EL}. Esta lista deberá ser utilizada para seleccionar la tarjeta manualmente por el POS. |
| 157 | customerDoc | Numérico | O | O | O | Numero de documento del titular de la tarjeta. |
| 303 | customerName | Alfanumérico | O | O | O | Nombre del titular de la tarjeta. |
| 166 | trxReferenceNumber | Numérico | X | 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. Para Rappi, en este campo retorna el barcode utilizado para el pago. |
| 272 | amountRefunded | Importe | - | - | X | Monto devuelto en la transacción |
| 273 | paymentStatus | Alfanumérico | O | - | O | Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado |
| 274 | paymentStatusDetail | Alfanumérico | O | - | O | Detalle del estado de la transacción de pago informado por el Autorizador. |
| 275 | cardType | Numérico | - | - | O | Tipo de tarjeta seleccionada al momento de efectuar el pago QR. Es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago. Para Yacaré este campo no retorna. Para Rappi este campo no retorna. Valores posibles: |
...
| 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 | Transaccion devuelta |
| 540 | Pendiente |
| 541 | Autorizado |
| 542 | En Progreso |
| 543 | En mediacion |
| 544 | Transaccion ya devuelta |
| 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 |
| 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 |
| 560 | 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 |
| 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 | Devolucion parcial no soportada |
| 585 | Transacción con CashBack no permitido |
| 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 |
| 596 | Entrega Excede Supera Limite |
| 598 | Las cuotas del pago ya fueron informadas |
| 602 | Devolución rechazada |
| 603 | Devolución no aprobada |
| 604 | Devolución pendiente de aprobación |
| 650 | Importe de devolución de cashout invalido |
| 651 | Importe de cashout invalido |
| 652 | Medio de pago inválido |
| 654 | Devolución registrada confirme administrativamente |
| 733 | La transacción no corresponde a una operación de Billeteras Electrónicas |
| 734 | No es posible cancelar la transacción informada |
1.5.4.1 Códigos de respuesta de VTOL Server para Billetera Rappi Payless
| Código | Descripción |
|---|---|
| 00 | APROBADA |
| 57 | TRANSACCION NO PERMITIDA |
| Âncora | ||||
|---|---|---|---|---|
|
...