Es un servicio de recaudación electrónica que permite realizar la cobranza de servicios y/o productos por Internet de manera rápida y segura, empleando las Tarjetas de Crédito Diners Club, Visa o MasterCard de cualquier banco emisor Nacional o Internacional, o Tarjeta de Débito Mercantil, con la inclusión de un punto de venta en la tienda virtual de la página web o en el APP.

Beneficios

• Oportunidad de desarrollo de aplicaciones que interactúen con nuestras APIs, mediante un proceso de integración e implementación ágil.

• Garantiza una entrega de información fluida y una experiencia de usuario integrada.

• Genera nuevas oportunidades de negocios.

• Mejora la experiencia de tus clientes.

• Aumenta la rentabilidad de tu emprendimiento o empresa.

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

• Plataforma estable y segura.

• Reducción de tiempos y costos.

• Oportunidad de venta las 24 horas, los 365 días.

Información General

El API de Pago con Tarjeta de Débito contempla dos APIs: 1) Autenticación del cliente; 2) Transacción financiera o pago. Para ejecutar pruebas debe seguir los siguientes pasos:

1. Ejecute el API Autenticación para Pagos con Tarjeta de Débito (getauth). Este API le informa el modelo de autenticación que Mercantil Banco tiene disponible para sus clientes. Actualmente el modelo de autenticación es Otp (One Time Password) / Clave Temporal. El API valida la petición y si todo está correcto, envía al cliente la Clave Temporal (otp) vía SMS y/o email.

2. Ejecute el API Pago con Tarjeta de Débito (pay), con los datos financieros que se requieren del cliente pagador como son:

• Número de Tarjeta de Débito
• CVV
• Fecha de Vencimiento
• Cédula de Identidad

• Clave Temporal (otp)

• 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

• Para descargar la descripción de los campos pulse el siguiente texto: Atributos o Campos Pago con Tarjeta de Débito Atributos o Campos Pago con Tarjeta de Crédito

Tipos de errores

Para ver el listado de errores adicional puede descargar en el siguiente texto: Lista de errores

Ejemplos Getauth

• Paso 1: Solicitar modelo de autenticación a ser utilizado con el API

Visite nuestro repositorio de ejemplos haciendo clic en el siguiente texto: Github Mercantil

Ejemplos Pago (Pay)

• Paso 2: Solicitar pago con tarjeta de débito API.

• Detalle solicitud pago con tarjeta de débito API.

• Ejemplos de mensaje json de pago TDD en móvil/web

Los requisitos aplican para todos los API’s

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.