...

A continuación se muestra una imagen del formulario que solicita los datos para efectuar el pago con tarjeta.

Image RemovedImage Added

Formulario de pago de VTOL Payment Bridge

...

1. Utilización de protocolo seguro https.
2. Encriptar los datos que se envían a VPB en la invocación de autorización.
3. Consultar a VPB el estado y datos de la transacción autorizada.
4. Indicar a VPB si debe confirmar o cancelar la transacción.
5. Brindar a VPB información sobre confirmación o cancelación de una transacción cuando este lo requiera, mediante una invocación GET.

...

La versión actual de VTOL Payment Bridge no soporta alta disponibilidad. Es decir, que la aplicación actualmente está construida para trabajar como un nodo único.

Âncora
_

...

Toc434487108 _

...

Toc434487108

2.

...

Integración

En esta sección se detalla la manera de integrar el e-commerce con VTOL Payment Bridge.

Âncora
_Toc381043093 _Toc381043093

Âncora
_

...

Toc434487110 _

...

Toc434487110

2.1

...

Servicios brindados por VPB

VTOL Payment Bridge es una aplicación pensada para ser integrada en el contenedor Web de Apache Tomcat versión 9.

• Instalar y configurar el servidor Tomcat 9 como servicio. Link: tomcat.apache.org/download-90.cgi
• Descargar JDK 1.8+

...

A continuación se detallan los requerimientos mínimos que son requeridos para poder instalar y ejecutar la aplicación.

...

Componente

...

Requerimiento Mínimo

...

Memoria RAM

...

Mínimo de 1 GB disponible para la aplicación

...

Disco Rígido

...

Mínimo de 1 GB disponible para la aplicación

...

Componente

...

Requerimiento Mínimo

...

Sistema Operativo

...

• Windows 8 64bits o superior, compatible con la versión de Java
• Linux Debian u otra distribución compatible con Tomcat

...

Máquina Virtual

...

JVM SUN 1.8.X de 64bits

...

Contenedor Web

...

Tomcat versión 9

...

Base de datos

...

MSSQL 2008 o superior

...

• Correr desde la consola el instalador con el comando:

                cmd: java -jar vtol-payment-bridge-installer-3.8.0.3-SNAPSHOT.jar

• Aceptar la licencia
• Ingresar la  ruta de la JDK
• Ingresar la ruta donde está instalado Tomcat 9
• Seleccionar si desea realizar la instalación completa.

Image Removed

Solo para Instalación completa

• Ingresar la ruta del certificado de seguridad

• Ingresar el password del certificado de seguridad

Image Removed

• Ingresar las credenciales de conexión a la base de datos SQL SERVER.

Image Removed

Para instalación completa y parcial

• Se desplegará la siguiente imagen:

Image Removed

• La finalización de la instalación se informa mediante un mensaje de "Terminado". Oprimir "Aceptar".
• Presionar el botón "Salir" para salir del instalador.

• Dentro del directorio NNNN se creó la carpeta con la nueva versión instalada de VTOL Payment Bridge.
• A continuación, lo que se debe realizar es ejecutar los scripts en la base de datos. Ver el apartado 2.5 Creación de base de datos

...

Se debe crear la base de datos para la aplicación y contar con usuario que tenga permisos de OWNER sobre la misma. Luego con dicho usuario se deben ejecutar los scripts para crear y popular la base de datos.

Los archivos scripts se encuentran disponibles en la ruta \vtolpaymentBridge\scripts. 

...

En esta sección se detalla la manera de integrar el e-commerce con VTOL Payment Bridge.

...

VTOL Payment Bridge brinda los siguientes servicios:

...

brinda los siguientes servicios:

2.1.1 Transacción en 1 fase (Venta)

VTOL Payment Bridge ofrece la posibilidad de realizar una transacción en una sola fase, llamada Venta (cargo). Directamente se realiza la transacción financiera. En esta modalidad VPB autoriza, verifica y captura todo de una vez.

...

2.

...

1.1.1 Solicitud de Pago

Servicio: /authorizeForm

Para realizar una solicitud de Pago, se debe invocar un método POST al endpoint de VPB, enviando el atributo transactionType=sale.Los campos se envían en formato json "Nombre del campo":"valor"=sale.

Invocación:

En la invocación POST se envían los siguientes parámetros con los datos de la venta:

* Campos Condicionales:

Si additionalPayerData=False, entonces el eCommerce debe enviar obligatoriamente los siguientes campos:

...

La respuesta se realiza en el la dirección de callback, especificada  especificada por el eCommerce. Los campos se envían en formato json "Nombre del campo":"valor".

Se responden los siguientes campos:

...

{
	   "transactionIdtransactionType": "1567105313489Sale",
	
   "ecommerce": {
      "company": "55C1",
	      "store": "1",
	"transactionType":"sale
   },
   "transactionId": "1580408171332",
   "responseCode": "00",
   "status": "Pending"
}

Âncora
checkTransactionStatus checkTransactionStatus

...

2.

...

1.1.2 Consultar Estado de Transacción

Servicio: /checkTransactionStatus

...

En la invocación GET se envían los siguientes parámetros de la operación:

...

{
	   "transactionId": "15671053134891580409092436",
	
   "ecommerce": {
      "company": "1C1",
	      "store": "1"
   }
}

Respuesta:

La respuesta retorna los siguientes campos:

...

{  
   "amount":"110100.9900",
   "providerCode":"Visa",
   "ticket":"274",
   "authorizationCode":"123456",
   "store":"1",
   "transactionDate":"20192020-0801-2930 1615:0231:13.74357.417",
   "authorizationStatus":"Pending",
   "responseCode":"00000",
   "node":"00000000050000000001",
   "displayMessage":"esta es una prueba de impresion",
   "currency":"$",
   "company":1"C1",
   "id":1350114,
   "responseMessage":"APROBADA",
   "vtolTrxId":"2908191602160000027730012015321300000110",
   "status":"Commit"
}

...

2.

...

1.1.3 Cierre de Transacción

Servicio: /closeTransaction

...

En la invocación POST se envían los siguientes parámetros de la operación:

...

{
	   "companytransactionId": "11580408171332",
	   "storeecommerce":"1",
	"transactionType":"sale",
	"transactionId":"1567105313489",
	 {
      "company": "C1",
      "store": "1"
   },
   "action": "commit"
}

Respuesta:

La respuesta sólo retorna un código HTTP 200.

...

2.

...

1.2 Transacción en 2 fases (Autorización y Captura)

VTOL Payment Bridge ofrece la posibilidad de realizar transacciones en dos pasos, primero se realiza una autorización, y luego se genera la captura. Son operaciones llamadas de dos fases.

La autorización es una reserva de fondos en la tarjeta del comprador. Esto significa que al realizar la misma, todavía no se generó un cobro al cliente en su tarjeta. Nunca aparece en el resumen de cuenta del tarjeta habiente. Solo cuando se realice una captura el cliente verá el pago.

...

2.

...

1.2.1 Autorización de Pago

Servicio: /authorizeForm

El pedido de autorización es un servicio que valida la información de la tarjeta que se envía, para verificar si se puede continuar con el proceso de pago y reservar los fondos del tarjeta habiente.

Para realizar una autorización, se debe invocar un método POST a la URL de VPB, enviando el atributo transactionType=authorization.Los campos se envían en formato json "Nombre del campo":"valor"

Invocación:

En la invocación POST se envían los siguientes parámetros con los datos de la autorización:

* Campos Condicionales:

Si additionalPayerData=False, entonces el eCommerce debe enviar obligatoriamente los siguientes campos:

...

Retorna los siguientes campos:

Los campos se envían en formato json "Nombre del campo":"valor"

...

{
    "transactionIdtransactionType": "1567105313489Authorization",
   "ecommerce": {
      "company": "55C1",
      "store": "13"
   },
   "transactionId":"1 "1581605477722",
   "responseCode": "00",
	   "transactionTypestatus": "authorizationPending"
}

...

2.

...

1.2.2 Consultar Estado de Transacción

Servicio: /checkTransactionStatus

...

La invocación a este servicio es el mismo que en las operaciones de una fase: Consultar Estado de Transacción

...

2.

...

1.2.3 Captura de Pago

Servicio: /closeTransaction

...

Para hacer la captura por el monto total, se realizará una invocación POST a la URL de VPB, sin informar el monto, y enviando el atributo action=commit. Los campos se envían en formato json "Nombre del campo":"valor" 

Invocación:

En la invocación POST se envían los siguientes parámetros con los datos de la captura:

...

{
    "companytransactionId": "11581605477722",
   "ecommerce": {
      "storecompany": "1C1",
      "transactionIdstore": "156710531348913"
   },
	   "action": "commit"
}

Respuesta:

La respuesta sólo retorna un código HTTP 200.

...

Para hacer la captura por un monto distinto (mayor o menor) al reservado, se realizará una invocación POST a la URL de VPB, informando el monto con el importe definitivo, y enviando el atributo action=commit.Los campos se envían en formato json "Nombre del campo":"valor"el atributo action=commit.

Invocación:

En la invocación POST se envían los siguientes parámetros con los datos de la captura:

Ejemplo:

{
    "companytransactionId": "11581605477722",
   "ecommerce": "store{
      "company": "1C1",
      "transactionIdstore": "156710531348913"
   },
	   "amount":500.22,
	   "action": "commit"
}

Respuesta:

La respuesta sólo retorna un código HTTP 200.

...

2.1.2.4 Cancelar una Autorización de Pago

Servicio: /closeTransaction

Para realizar la cancelación de una autorización, se debe invocar un método POST a la URL de VPB, enviando el atributo action=rollback.

Los campos se envían en formato json "Nombre del campo":"valor"

Invocación:

En la invocación POST se envían los siguientes parámetros con los datos de la cancelación:

Los campos se envían en formato json "Nombre del campo":"valor"

Ejemplo:

{
   "transactionId": "1581605477722",
   "ecommerce": {
      "company": "1C1",
      "store": "113",
    "transactionId":"1567105313489"},
	   "action": "rollback"
}

Respuesta:

La respuesta sólo retorna un código HTTP 200.

...

2.

...

1.

...

3 Devoluciones

VTOL Payment Bridge ofrece la posibilidad de realizar devoluciones de un pago. La operación original debe ser menor a 30 días.

...

A través de este método se realizan devoluciones totales o parciales. Para ello la transacción debe estar en estado Acreditada.

...

2.

...

1.

...

3.1 Realizar devolución total del pago

Servicio: /refunds

Se debe invocar un método POST a la URL de VPB, sin informar el monto, y enviando el atributo transactionType=refund.

...

...

2.

...

1.

...

3.2 Realizar devolución parcial del pago

Servicio: /refunds

Se debe invocar un método POST a la URL de VPB, enviando el atributo transactionType=refund.

...

Se responden los siguientes campos:

...

Ejemplo:

{
   "transactionType": "Refund",
   "ecommerce": {
      "company": "C1",
      "store": "13"
   },
   "transactionId": "1581607736373"
}

2.1.3.3 Cierre de transacción

Servicio: /closeTransaction

...

En la invocación POST se envían los siguientes parámetros de la operación:

...

Âncora
_Toc381043096 _Toc381043096

Âncora
_Toc434487111 _Toc434487111

...

2.

...

2 Servicios brindados por el E-Commerce

El e-commerce debe brindar la posibilidad de realizar la consulta de estado de la transacción para que VPB pueda consultar si debe confirmar o cancelar la operación contra VTOL Server, en caso de producirse alguna desincronización de estados.

Âncora
_Toc381043097 _Toc381043097

...

2.

...

2.1 Consultar estado de transacción

VPB debe poder realizar una invocación GET a un servicio que disponibiliza el e-commerce. VPB debe conocer la URL del servicio para poder realizar la consulta. Dicha URL será informada por el e-commerce en el mensaje de Solicitud de Pago.

...

200:{
	"company":"1",
	"store":"1",	
	"transactionId":"1567105313489",
	"status":"Commit"
}

Âncora
_Códigos_de_respuesta _Códigos_de_respuesta

Âncora
_Toc434487112 _Toc434487112

2.3

...

Códigos de Respuesta

VPB responde a cada transacción que recibe para autorizar con un código de respuesta y una descripción del mismo, indicando cual fue el resultado de la operación. 

...

A continuación se detallan las respuestas posibles.

2.3

...

.1 Códigos recibidos de VTOL Server

...