Agendamiento de cuotas

Es un servicio que permite a los usuarios realizar el agendamiento y gestión de pagos en forma de cuotas en el sistema bancario. Este API brinda a los desarrolladores y a los clientes del banco la capacidad de programar y administrar pagos periódicos de manera automatizada, facilitando el cumplimiento de obligaciones financieras y mejorando la experiencia del usuario.

Beneficios

• Fácil implementación con los esquemas de Open Banking (API).

• Automatización. Un API de agendamiento de cuotas permite automatizar el proceso de agendar y gestionar cuotas de pago, lo cual ahorra tiempo y reduce errores humanos.

• Manejo de esquemas de seguridad.

• Función automatizada que permite que los datos se compartan rápidamente.

• Mejor experiencia de usuario. Al ofrecer un sistema de agendamiento de cuotas, brindas a tus usuarios la comodidad de dividir pagos en plazos más manejables, lo que puede aumentar la satisfacción del cliente y fomentar la lealtad.

• Control financiero. Con un API de agendamiento de cuotas, puedes tener una visión clara de los pagos pendientes y programados, lo que te permite tener un mejor control de tus ingresos y flujos de efectivo.

• Integración con otros sistemas. Si tienes otros sistemas o plataformas, como sistemas de pago o plataformas de comercio electrónico, un API de agendamiento de cuotas puede integrarse fácilmente con ellos, lo que facilita la gestión global de tus procesos de negocio.

Condiciones

• Debe realizarse el pago inicial desde el Botón de Pagos con Tarjetas.

Información General

Código de Identificación de cliente (ClientID): Para poder usar cualquiera de los APIs es importante tener un código de identificación de cliente (ClientID).

• Para el ambiente de certificación el código de cliente (ClientID) le será enviado por comunicación directa por Mercantil Banco vía email con el resto de las condiciones para realizar las pruebas de certificación, una vez haya creado su Cuenta de Usuario, su Aplicación y suscrito el Plan.
• La identificación del cliente o ClientID es parte de una cabecera/header del protocolo HTTP. En la información del ambiente de certificación se le enviará identificado como: X-IBM-Client-Id
• Para obtener mayor información sobre el Protocolo HTTP sugerimos consultar la siguiente dirección: Protocolo HTTP

• Algoritmo de Cifrado: El Algoritmo de Cifrado para los APIs tiene las siguientes características:

  • El modelo de cifrado es AES/ECB/PKSC S5Padding
  • El valor en la propiedad del mensaje JSON debe estar en Base64/UTF8
  • La clave secreta o secretkey es única por código de comercio. Esta información le será suministrada por el banco tanto en los ambientes de certificación como de producción
  • La clave secreta entregada por el banco debe convertirla a SHA-256 y se debe tomar los primeros 16 bytes para cifrar
  • Revisar los ejemplos para cifrado en la siguiente dirección: Github Mercantil
  • Para obtener mayor información sobre Algoritmo de Cifrado sugerimos consultar la siguiente dirección: Cifrado AES

Descripción de Atributos o Campos

Crear Agendamiento: Cargue los datos recibidos previamente desde el Botón de Pagos con Tarjetas. (Recuerde que para crear un agendamiento es necesario haber realizado un primer pago con el Botón de Pagos con Tarjetas, el cual será considerado como la cuota inicial). Para mas información acerca del Botón de Pagos con Tarjetas visite:Botón de Pagos con Tarjetas

Para descargar la descripción de los campos pulse el siguiente texto: Atributos o Campos

Ejemplos Crear Agendamiento (payment/create-contract)

Tipos de Errores

Para ver el listado de errores pulse el siguiente texto: Lista de errores

Consultar Agendamiento: Consulta los Agendamientos creados por número de contrato.

Para descargar la descripción de los campos pulse el siguiente texto: Atributos o Campos

Ejemplos Consultar Agendamiento (payment/consult-contract)

Tipos de Errores

Para ver el listado de errores pulse el siguiente texto: Lista de errores

Anular Agendamiento: Anula los Agendamientos creados utilizando como datos de entrada el número de contrato y el motivo de la anulación.

Para descargar la descripción de los campos pulse el siguiente texto: Atributos o Campos

Ejemplos Anular Agendamiento (payment/cancel-contract)

Tipos de Errores

Para ver el listado de errores pulse el siguiente texto: Lista de errores

Los requisitos aplican para todos los APIs

Requisitos

• Ser cliente de Mercantil C.A. Banco Universal.

• Estar afiliado a Mercantil en Línea Empresas.

• Contar con una aplicación o sitio web de tu negocio.