Integración del método de pago
5 min
a continuación se describe el flujo de comunicación que se debe seguir para la integración de una plataforma de e commerce con addi en primer lugar, se describe la manera en que se efectúa la autenticación al api de integración con tiendas en línea (de ahora en adelante ecommerce), y en segundo lugar, se describen los recursos http que permiten ofrecer addi como medio de pago en un ecommerce en caso de fallas en la comunicación o fallos temporales en los recursos http de addi que retornen http status 5xx, se pueden realizar reintentos para obtener la respuesta original los recursos http de nuestro api son idempotentes y garantizan que un crédito va a ser originado una sola vez addi cuenta con ambientes de staging y productivo para crear tokens e interactuar con el api, para su configuración, necesitas las credenciales del ambiente de staging y del ambiente productivo a continuación te compartimos las credenciales del ambiente de producción, estas son únicas e intransferibles por favor, no las uses hasta que tu integración sea certificada por nuestro equipo de soporte 1\ endpoint para verificación de montos y descuentos se debe consumir nuestro endpoint de configuración de aliado para determinar si el método de pago debe mostrase y si debe mostrar algún descuento para ese comercio https //channels public api addi com/allies/ally slug/config?requestedamount=xxxx indicando el monto del carrito que se va a enviar y el ally slug que corresponda al comercio este se proporcionará una vez se inicie el proceso de integración la respuesta tendrá el siguiente formato { "minamount" 50000, "maxamount" 5000000, "policy" { "discount" 0, "producttype" "addi pago" } } en caso que el monto esté por fuera del rango de mínimo y máximo indicado, por favor ocultar el método de pago si le aplica un descuento, por favor mostrar el porcentaje en el checkout indicando el ahorro para el cliente 2\ endpoint de autenticación el proceso de autenticación sucede en auth0 https //auth0 com/ quién actúa como plataforma idaas (identity as a service), siendo la responsable de generar json web tokens que son usados en los llamados a los recursos http expuestos por el api documentación https //api docs addi staging com/auth/#/authentication 3\ endpoint de creación de aplicación proceso de creación de una transacción de pago con addi (aplicación) documentación https //api docs addi staging com/integration/#/online application/createonlineloanapplication este endpoint devolverá un 301 con el header location que debe ser usado para redirigir al usuario a la plataforma addi 4\ endpoint para reporte de resultado (callback) proceso de respuesta a una aplicación de crédito en línea que debe ser recibido por el comercio en el schema de onlineloanapplicationcallbackrequest se pueden identificar los distintos estados de respuesta que proporciona addi enum \[ approved, rejected, declined, abandoned] documentación https //api docs addi staging com/integration/#/online%20application%20callback/post