Centro de Integraciones

Integre funcionalidades de sus sistemas con valor agregado en la parametria de CuentaVirtual..

Introduction

El módulo de parametria de Syscore CuentaVirtual le permite a las Empresas/Comercios integrar funcionalidades extras de conexión y valor agregado rapidamente.

Nuestros sistemas parametricos permites standarizar las integraciones e información que circula entre los sistemas.

Autenticación

Todas las llamadas pre-establecidas que realice CuentaVirtual enviara un código de seguridad mediante la variable GET "codseg" al endpoint parametrizado con la siguiente lógica:

$ApiToken: Indica el apitoken generado por CuentaVirtual para la Empresa/Comercio.
$Variables: Corresponde a un string de todas las variables enviadas por GET/POST.
$CodSeg = MD5(concat($ApiToken, $Variables));

Ejemplo:
$ApiToken: 8ec1ba6671ce6190ddf7f17355916c8d
$Variables: user=456897456&cbte=factura
$CodSeg: MD5(concat("8ec1ba6671ce6190ddf7f17355916c8d", "user=456897456&cbte=factura"));
$CodSeg: "c78d19671d73604bed73bd8d79c231c2"
Endpoint Resultante: https://api.empresa.com/obtenerdeuda?user=456897456&cbte=factura&codseg=c78d19671d73604bed73bd8d79c231c2


Servidores

Todas las llamadas pre-establecidas que realice CuentaVirtual serán originadas desde las siguientes redes:
- Ver Redes CuentaVirtual

APIS PreConfiguradas

A continuación se detallan las llamadas preconfiguradas que pueden ser paramtrizadas en CuentaVirtual con el fin de automatizar funcionalidades con servidios de la Empresa/Comercio.

Las APIS que seràn disponibilizadas por la Empresa/Comercio deben ser APIS de tipo HTTP REST que reciban datos por GET / POST. La respuesta de dichas APIS deben ser en formato JSON.

Atención

Para la configuración y configuración de dichas integraciones es necesario que se ponga en contacto con nuestro departamento de Soporte.

Obtener Deuda

Es posible configurar un tipo de documento/comprobante dentro de CuentaVirtual para que al momento donde el cliente seleccione el pago del mismo, el sistema consuma una API de la Empresa/Comercio y pueda obtener informaciòn de pago de dicho cliente. Para eso el sistema permite configurar:

  • Obtener Importe Exacto -> Permite consumir una API y obtener la variable "importe" y mostrarle al cliente el importe exacto a abonar.
  • Validar Importe Mìnimo -> Permite consumir una API y obtener la variable "importe_minimo" y validar que el importe que el cliente ingresa sea superior al mìnimo.
  • Validar Importe Màximo -> Permite consumir una API y obtener la variable "importe_maximo" y validar que el importe que el cliente ingresa sea inferior al màximo.
  • Validar Rango Importes -> Permite consumir una API y obtener las variables "importe_maximo" y "importe_minimo" para validar que el importe ingresado por el cliente se encuentre dentro de dicho rango.

Variables Adicionales:

  • state -> Permite indicar si la respuesta de la API fue exitosa. Solamente sera considerada la respuesta state=1 para procesar correctamente la misma.
  • fechavto -> Permite indicar el vencimiento de la transación dentro del proceso de pago.
  • info -> En caso que exista la variable, el sistema mostrará un cuadro con información adicional al momento del pago.

Obtener Imputación

Es posible configurar a nivel de configuraciòn del gateway en el campo "imputartipocbteapi" Api Imputar Tipo Comprobante, un llamado Api hacia un endpoint donde se enviaran los datos de la acreditaciòn y el cliente para que la API pueda responder el tipo de comprobante o documento a imputar dicha acreditaciòn. Para eso el sistema permite recibir las siguientes variables:

  • typecbte -> Indica el valor del tipo de documento / comprobante que se le asignarà a la transacciòn generada.

Variables Adicionales:

  • state -> Permite indicar si la respuesta de la API fue exitosa. Solamente sera considerada la respuesta state=1 para procesar correctamente la misma.

Notas:

  • El llamado a la API de imputación se realizarà siempre y cuando el sistema no encuentre una transacciòn compatible para la conciliación automática.