Esta API le permite a tu Empresa colocar un botón dentro de tu Web o App para que los clientes Mercantil soliciten la clave de Pago de Móvil, sin tener que salir de la aplicación y el Pagador recibe la clave en su (celular) o móvil registrado en Mercantil, para confirmar el pago.

Beneficios

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

• Facilitar al Pagador la obtención de la clave de pago, ya que lo hace directamente desde su Web o App.

• Brinda mayor seguridad. El Pagador va a pedir la clave en el momento de realizar el pago.

• Es compatible con cualquier teléfono celular que permita recibir SMS, sin importar la operadora telefónica a la que se encuentre afiliado el servicio dentro del territorio nacional.

• Validación rápida del pago efectuado a los clientes por Pago Móvil C2P.

Características

• Clave de un solo uso.

• Duración de 6 horas.

Información General

• Código de Identificación de cliente (ClientID): Para poder usar cualquiera de los API 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 API 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

Tipos de errores

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

Ejemplos Solicitud Clave Pago C2P (mobile-payment/scp)

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.