...
Âncora _Toc434487092 _Toc434487092
1.1 Acerca de este documento
| _Toc434487092 | |
| _Toc434487092 |
El presente documento explica la forma en la que un e-commerce se puede integrar con VTOL Payment Bridge, para autorizar pagos a través de InternetEste documento describe los aspectos técnicos de integración, para aquellos comercios que deseen procesar cobros on-line, con sus sistemas de E-Commerce, a través de la API de VTOL Payment Bridge.
La implementación del servicio de VTOL Payment Bridge requiere conocimientos de desarrollo de software, para poder generar código que interactúe con la API de VPB para invocar servicios y procesar respuestas.
Âncora _Toc434487093 _Toc434487093
1.2 ¿Qué es VTOL Payment Bridge?
| _Toc434487093 | |
| _Toc434487093 |
Es un componente Web que permite a un sitio de eCommerce capturar los datos de la tarjeta y del tarjeta habiente, para luego autorizar, a través de VTOL Server, los pagos de compras realizadas en Internet. Cuando el cliente del eCommerce De esta manera no es necesario que el comercio esté certificado bajo las normas PCI.
Cuando el cliente de la tienda online quiere pagar su compra con tarjeta, se hace una redirección segura hacia VTOL Payment Bridge, quién quien solicita los datos para efectuar el pago.
A continuación se muestra una imagen del formulario que solicita los datos para efectuar el pago con tarjeta.de la tarjeta:
Formulario de pago de VTOL Payment Bridge
Además, el formulario de VTOL Payment Bridge permitirá ingresar datos adicionales del titular de la tarjeta, como ser Fecha de nacimiento, Tipo y Número de Documento, y Dirección. Estos datos podrán ser enviados por el eCommerce a VPB en el mensaje de autorización de pago, o que VPB se los solicite al usuario en el formulario de ingreso de datos. Se mostrará una imagen como la siguiente:
Formulario de pago de VPB con datos adicionales del tarjeta habiente
...
- Velocidad de integración con VTOL Server.
- Evitar implementar un formulario de ingreso de datos de tarjetas tarjeta y sus correspondientes validaciones.
- Cumplir con las normas PCI ya que el e-commerce no tiene conocimiento de los datos sensibles de la tarjeta.
- Simplificar la conciliación con VTOL Server.
Âncora _Toc434487095 _Toc434487095
1.4 Arquitectura
| _Toc434487095 | |
| _Toc434487095 |
...
Como se observa en la figura, VPB recibe la petición de autorización del browser del cliente, con los datos de venta del e-commerce. Entre esos datos viaja el identificador de transacción generado por el e-commerce (transactionId).
VPB por su parte despliega una ventana segura para cargar capturar los datos de la tarjeta. Una vez completados los datos, autoriza la transacción contra VTOL Server y responde a una dirección de callback, incluyendo el transactionId enviado en el requerimiento de autorización.
El e-commerce es quien posteriormente debe realizar la consulta del estado de la transacción pasando como parámetro su identificador en una invocación GET a VPB.
Por último y una vez que finalizó la operación con el cliente, el e-commerce realiza una invocación POST a VPB indicando la confirmación o cancelación de la transacción. VPB al recibir el requerimiento de confirmación o cancelación, envía un Commit o Rollback a VTOL Server.
...
En esta sección se detalla la manera de integrar el e-commerce con VTOL Payment Bridge.
| Informações | ||
|---|---|---|
| ||
El formulario de pago para capturar los datos de la tarjeta se desplegará únicamente cuando se invoque a los servicios de Autorización de Pago (ya sea en una fase o en dos fases). Los demás servicios, como ser Consulta de estado, Cancelación, Devolución, no desplegarán ningún formulario. La API de VPB retornará una respuesta con un status code según cada invocación, las cuales están descritas en los siguientes apartados. |
Âncora _Toc381043093 _Toc381043093
Âncora _Toc434487110 _Toc434487110
2.1 Servicios brindados por VPB
| _Toc381043093 | |
| _Toc381043093 |
...
_Toc434487110 _Toc434487110
2.1 Servicios brindados por VPB
| _Toc434487110 | |
| _Toc434487110 |
Las operaciones disponibles son:
- Transacción en 1 fase
- Autorización de pago
- Transacción en 2 fases
- Autorización de pago
- Captura de pago (sólo para transacción en 2 pasos)
- Cancelar autorización de pago (sólo para transacción en 2 pasos)
- Consultar estado de transacción
- Devolución
- Devolución total
- Devolución parcial
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 el importe de la venta todo de una vez.
2.1.1.1
...
Autorización de Pago
Servicio: /authorizeForm
Para realizar una solicitud autorización de Pago en una fase, se debe invocar un método POST al endpoint de VPB, enviando el atributo transactionType=sale.
Invocación:
Al invocar a este servicio, VPB desplegará una ventana segura con el formulario de pago para capturar los datos de la tarjeta.
En la invocación POST se envían los siguientes parámetros con los datos de la venta:
...
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 es posible continuar con el proceso de pago y reservar los fondos del tarjeta habiente.
Para realizar una autorización en dos fases, se debe invocar un método POST a la URL de VPB, enviando el atributo transactionType=authorization.
Invocación:
Al invocar a este servicio, VPB desplegará una ventana segura con el formulario de pago para capturar los datos de la tarjeta.
En la invocación POST se envían los siguientes parámetros con los datos de la autorización:
...
VTOL Payment Bridge ofrece la posibilidad de realizar devoluciones de un pago. La operación original debe ser menor a 30 días.
La Devolución de una Transacción de dos pasos, se hace por el monto efectivamente capturado (en el 2do paso).
...