Integración Khipu

Introducción

Khipu es un medio de pago que opera en Chile, Argentina, Perú y próximamente en México y España. Permite a comercios cobrar electrónicamente y a clientes pagar con sus cuentas bancarias (Corrientes, Vistas, Chequeras electrónicas, etc.).

El uso estándar de Khipu requiere que el cliente autorize el pago en la página web de Khipu o que instale una aplicación móvil, el terminal de pagos Khipu.

Khipu SDK Android/IOS permite a comercios que cuenten con una App (Android y/o iOS), embeber el proceso de autorización del pago directamente en su App, bajando, con esto, la fricción en el proceso de compra y, por lo tanto, aumentando la conversión del proceso completo.

Khipu SDK Web permite a comercios embeber el proceso de autorización de pago en su propia web sin redireccionar al pagador al sitio web de Khipu, obteniendo los mismos beneficios de en el caso App, es decir, bajar la fricción en el proceso de compra y aumentando la conversión.

Esquema general

schema.png

Pre-requisitos normales

  1. Tener una cuenta de cobrador en khipu.com . Existen cuentas de cobro regulares y en "modo desarrollador". En ambas el ciclo de creación, autorización y conciliación del pago es idéntico. La diferencia es que en las cuentas regulares se utilizan Bancos y dinero real mientras en las en "modo desarrollador" ficticios. Recomendamos usar una cuenta en "modo desarrollador" en el proceso de desarrollo y pruebas de la integración y en producción cambiar las credenciales de acceso a la API por las de una cuenta regular.
  2. Un servidor capaz de conectarse por HTTPS a khipu.com y capaz de disponibilizar un endpoint web (también conocido como webhook ) para recibir las notificaciones de conciliación de los pagos recibidos.

Definición del cobro a realizar (en la app del cobrador)

El cobrador debe definir el tipo de cobro que se realizará mediante la aplicación. Esto puede incluir un carro de compras, una compra única, o cualquier otra modalidad que el cobrador establezca.

Creación de Intención de Pago

La intención de pago se puede crear de dos maneras:

  1. Solicitud de Pago : Utiliza la API de khipu para crear cobros y recibir pagos (v3.0) .
  2. Descriptor de Pago : Se genera mediante la Operation Descriptor Generator API (v1.0) .

Ambas son una API REST construidas según la especificación OpenAPI 3+

Autorización del pago

Una vez que se ha creado la solicitud de pago y se dispone del identificador único del pago, dicho identificador debe ser transferido a la App. El método específico por el cual el identificador llega a la App no se detalla en este documento, ya que depende de la implementación específica del sistema.

Para más detalles sobre la implementación, puedes consultar los siguientes enlaces:

Recepción de la notificación de conciliación (en el servidor del cobrador)

Una vez que el cliente pagador ya autorizó el pago. Khipu comenzará inmediatamente el proceso de conciliación y verificación de éste. Al finalizar ese proceso, Khipu invocará la URL de notificación asociada al pago (webhook configurado al momento de generar el cobro) para enviar todos los datos del pago. Este modelo difiere respecto a la versión 1.3 de la API de notificaciones, ya que se deja de enviar el parámetro notification_token que luego debía ser utilizado en una petición POST al endpoint de detalle del pago.

Puedes encontrar la explicación completa en la sección Webhook para notificaciones.