Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Índice

Cambios por Image Added




VTOL Integration Services - Integración





Painel
borderColor#E4E3E3
bgColor#ffffff
titleColor#ffffff
borderWidth1px
titleBGColor#704581
titleREVISIONES


Expandir
titleExpandir revisiones


FechaRevisiónCambios

 

1.0Creación del documento

 

1.1Agregado de apartado de Seguridad para la versión 1.0.2 de la API





Painel
borderColor#E4E3E3
titleColor#ffffff
borderWidth1
titleBGColor#704581
titleCONTENIDO


Expandir
titleExpandir contenido

Índice




Introducción

VTOL Integration Services Service (VIS) es un servicio (API REST) que expone VTOL para ser utilizado en diferentes circunstancias. Por ejemplo, para administrar los link de pago, bajar la configuración o consultar el estado de conciliación de las transacciones procesadas por VTOL.

...

Dica

La API está publicada en la siguiente URL:

https://stsvtolmulti:8554/swagger-ui.html#/

https://demodev.napse.global:13854/swagger-ui.html#/


Un ejemplo de la vista del API

Conciliaciones (API "Transactions")

A través de éste servicio un integrador podrá listar las transacciones realizadas en VTOL y obtener para cada una de ellas el estado de conciliación actual.

Dicho estado surge de un proceso de conciliación interno que VTOL hace con los bancos y/o tarjetas.

...

Integraciones

A continuación se detallan los servicios para integrarse.


Configuración (API "configuration")

VTOL posee el catálogo de información de medios de pagos disponibles. Esta configuración está disponible para aquél integrador que requiere consultar los medios de pagos que maneja VTOL, como por ejemplo, para hacerse de las tarjetas y sus bines (forma de identificar una marca). en ocasiones esto es requerido para calcular promociones bancarias o por medio de pagos.

...

  • Marcas de tarjetas
  • Tarjetas
  • Prefijos de tarjetas
  • Opciones de pago
  • Bancos
  • Monedas

Link de pago (API "paymentLink")

El link de pago es una facilidad que permite realizar ventas no presenciales en establecimientos comerciales mediante el envío de un enlace de pago (por correo electrónico, por ejemplo) para que el cliente abone con tarjeta de crédito. VTOL permitirá generar un hipervínculo con una solicitud de pago para que el comerciante comparta o envíe dicho link a sus clientes así los mismos logren abonar los servicios o un pago específico por una compra mediante la plataforma online de pago de VTOL.

En el siguiente link se detallan los servicios para integrar un comercio con la API de Link de pago donde s epodráse podrá:

  1. crear links de pago para realizar cobros a través de links
  2. consultar el estado de las solicitudes de pago generadas para conocer si fueron pagadas por el cliente
  3. devolver un pago realizado a través de un link de pagos
  4. listar los link de pagos generados
  5. o eliminar los links de pago para que no se puedan utilizar.


Seguridad

Autenticación (HTTP Basic Authentication)

Informações

La aplicación de seguridad HTTP Basic es a partir de la versión 1.0.2


Para la integración a través de la API REST, a partir de la versión 1.0.2, se requiere autenticación HTTP Basic. El comercio necesitará las siguientes credenciales:

  • Usuario
  • Contraseña. 

Se deben enviar estos datos en el "Header" de cada invocación a los servicios de VIS.

  • Las credenciales se utilizan en el backend del comercio y debe ser secreta. Las mismas serán provistas por el equipo de Soporte de NAPSE.


Servicios de VIS que requieren Basic Authentication

Los siguientes servicios utilizan autenticación HTTP Basic

  • Configuración
  • Link de pago