¿Cómo te integras a nuestras soluciones?
Este es el proceso que debes hacer para qué
la integración con Nequi quede al pelo:
1
Selecciona tu producto de interés de Negocios Nequi aquí
Continúa con tu registro o déjanos tus datos para contactarte.
2
3
Comienza la integración con la documentación del paso anterior
Una vez tengas lista la documentación envía en un solo correo a: certificacion@conecta.nequi.com lo siguiente:
• Casos de prueba de la API que escogiste en formato JSON, se debe completar la certificación de todos los servicios asociados al modelo de integración con el que se planea vincular. Abajo encontrarás los casos de prueba correspondiente a cada solución.
• Un video, gif o imágenes de cómo será la experiencia del usuario Nequi en tu negocio. Te recomendamostener en cuenta: lineamientos básicos de UX.
4
Espera hasta 4 días hábiles para recibir el correo de aprobación de tus certificaciones
Recibirás las llaves de producción al correo que registraste en Nequi Negocios.
5
Tras recibir las llaves de producción, actualiza los endpoints, enlaces de los servicios y credenciales para el ambiente de producción.
Aquí encuentras la información según la API que elegiste.
6
Durante 15 días en Slack cuentas con soporte técnico para tu integración con Nequi.
Pasados los 15 días puedes solicitar soporte técnico Aquí
Ten en cuenta que:
Recuerda que debe ser una empresa colombiana que este mínimamente operando 8 meses con cuenta activa de Bancolombia.
En el paso 3 nos debes enviar la información que confirme que tus desarrollos quedaron bien, según la API que escogiste:
APIs de Pagos
1
Request y response del servicio de envío de notificación de pago de la API pagos con push y pantallazo del comprobante de pago desde la App, en el ambiente de pruebas y con un número de celular que esté activo.
Además, el request y response del servicio de consulta de estado de pago, que demuestre que funcionó sin problema.
2
Request y response del servicio de envío de notificación de pago de la API pagos con push en el ambiente de pruebas y con un número de celular que esté activo, pero el pago debe haberse rechazado desde la app.
3
Request y response del servicio de envío de notificación de pago de la API pagos con push en el ambiente de pruebas y con un número de celular que esté activo, pero el pago debe vencerse o expirar al esperar 45 minutos.
4
Request y response del servicio de envío de notificación de pago de la API pagos con push en el ambiente de pruebas, con un número de celular que esté activo y con un número de celular que no tenga Nequi.
5
Request y response del servicio de reverso de un pago con la API push que haya funcionado sin problema.
El servicio de reverso es obligatorio. Debe usarse si: se desea cancelar el pago pendiente antes de que un usuario haga el pago, si hay fallas técnicas en tu sistema con la confirmación de pago o cuando el servicio de Nequi muestra timeout o error 500 y no se puede confirmar si el usuario Nequi realizó o rechazó el pago.
Por eso, es súper importante tener la capacidad de usar este servicio.
1
Request y response del servicio de generación de QR de la API de pagos con QR dinámico y pantallazo del comprobante de pago desde la App, en el ambiente de pruebas y con un número de celular que esté activo.
Además, el request y response del servicio de consulta de estado de pago, que demuestre que funcionó sin problema.
2
Request y response del servicio de generación de QR de la API de pagos con QR dinámico, en el ambiente de pruebas, pero el pago debe vencerse o expirar al esperar 45 minutos.
Además, el request y response del servicio de consulta de estado que demuestre que expiró.
3
Request y response del servicio de reverso de un pago con la API de pagos con QR dinámico que haya funcionado sin problema.
El servicio de reverso es obligatorio. Debe usarse si: se desea cancelar el pago pendiente antes de que un usuario haga el pago, si hay fallas técnicas en tu sistema con la confirmación de pago o cuando el servicio de Nequi muestra timeout o error 500 y no se puede confirmar si el usuario Nequi realizó o rechazó el pago.
Por eso, es súper importante tener la capacidad de usar este servicio.
1
Request y response del servicio de una nueva suscripción de la API de pagos de suscripción y pantallazo que compruebe la aceptación desde la App, en el ambiente de pruebas y con un número de celular que esté activo.
Además, el request y response del servicio de consulta de estado de suscripción, que demuestre que fue aceptada.
2
Request y response del servicio de una nueva suscripción de la API de pagos de suscripción y pantallazo que compruebe el rechazo desde la App en el ambiente de pruebas y con un número de celular que esté activo.
Además, el request y response del servicio de consulta de estado de suscripción, que demuestre que fue rechazada.
3
Request y response del servicio de una nueva suscripción de la API de pagos de suscripción en el ambiente de pruebas y con un número de celular que esté activo, pero la suscripción debe vencerse o expirar al esperar 15 minutos.
Además, el request y response del servicio de consulta de estado de suscripción, que demuestre que expiró o no existe.
4
Request y response del servicio de una nueva suscripción de la API de pagos de suscripción, con un número de celular que no exista en ambiente de pruebas.
5
Request y response del servicio de pago automático con la API de pagos de suscripción y pantallazo del comprobante del débito desde la app, en el ambiente de pruebas y con un número de celular que esté activo.
6
Request y response del servicio de pago automático con la API de pagos de suscripción, con un monto mayor al saldo que tiene un número de cel que esté activo y exista en el ambiente de pruebas.
7
Request y response del servicio de pago automático con la API de pagos de suscripción, con una suscripción que no fue aceptada por un número de celular que esté activo y exista en el ambiente de pruebas.
8
Request y response del servicio de pago automático con la API de pagos de suscripción, con una suscripción que fue rechazada por un número de celular que esté activo y exista en el ambiente de pruebas.
9
Request y response del servicio de devolución o reverso de un pago con la API de pagos de suscripción que haya funcionado sin problema.
El servicio de reverso es obligatorio. Debe usarse si: se desea cancelar el pago pendiente antes de que un usuario haga el pago, si hay fallas técnicas en el sistema con la confirmación de pago o, cuando el servicio de Nequi muestra timeout o error 500 y no se puede confirmar si el usuario Nequi realizó o rechazó el pago.
Por eso, es súper importante tener la capacidad de usar este servicio.
1
Request y response del servicio de generación de pago pendiente QR de la API de pagos con Súper QR y pantallazo del comprobante de pago desde la App, en el ambiente de pruebas y con un número de celular que esté activo.
Además, el request y response del servicio de consulta de estado de pago pendiente, que demuestre que funcionó sin problema.
2
Request y response fallido del servicio de generación de pago pendiente QR de la API de pagos con Súper QR debido a la existencia de un pago pendiente asociado a ese QR en el ambiente de pruebas.
3
Request y response fallido del servicio de generación de pago pendiente QR de la API de pagos con Súper QR porque el QR no existe en el ambiente de pruebas.
4
Request y response del servicio de generación de QR de la API de pagos con Súper QR en el ambiente de pruebas, pero el pago pendiente debe vencerse o expirar al esperar 45 minutos.
Además, el request y response del servicio de consulta de estado de pago pendiente, que demuestre que expiró.
5
Request y response del servicio de devolución o reverso de una generación de pago pendiente con la API de pagos con Súper QR en el ambiente de pruebas, que aún no haya sido aprobada o pagada por algún usuario.
Además, el request y response del servicio de consulta de estado de pago pendiente, que demuestre que fue cancelada por el comercio sin haber sido pagada.
6
Request y response del servicio de devolución o reverso de una generación de pago pendiente con la API de pagos con Súper QR en el ambiente de pruebas, que haya sido aprobada o pagada por algún usuario.
Además, el request y response del servicio de consulta de estado de pago pendiente, que demuestre que fue anulada por el comercio cuando ya se había realizado el pago.
El servicio de reverso es obligatorio. Debe usarse si: se desea cancelar el pago pendiente antes de que un usuario haga el pago, si hay fallas técnicas en tu sistema con la confirmación de pago o cuando el servicio de Nequi muestra timeout o error 500 y no se puede confirmar si el usuario Nequi realizó o rechazó el pago.
Por eso, es súper importante tener la capacidad de usar este servicio.
APIs Corresponsales Nequi
1
Request y Response del servicio de validación de cliente de la API de recarga (cash in) con un número de celular válido y existente en el ambiente de pruebas.
2
Request y Response del servicio de recarga de la API de recarga (cash in) y pantallazo del comprobante de recarga desde el App con un número de celular válido y existente en el ambiente de pruebas.
3
Request y Response del servicio de validación del cliente de la API de recarga (cash in) con un número de celular no existente en ambiente de pruebas.
4
Request y Response del servicio de recarga de la API de recarga (cash in) con un número de celular no existente en ambiente de pruebas.
5
Request y Response del servicio de reverso de la API de recarga (cash in) de una recarga que haya sido exitosa.
El servicio de reverso es obligatorio. Debe usarse ante fallas técnicas en tu sistema o cuando el servicio de recarga de Nequi arroje timeout o error 500, lo cual se debe hacer de manera inmediata y durante el mismo día del movimiento.
Por eso, es súper importante tener la capacidad de usar este servicio.
1
Request y Response del servicio de consulta de retiro/cashout de la API de retiro (cash out) con un número de celular válido y existente en el ambiente de pruebas.
2
Request y Response del servicio de retiro de la API de retiro (cash out) y screenshot con el comprobante de retiro desde el App con un número de celular válido y existente en el ambiente de pruebas.
3
Request y Response del servicio de consulta de retiro/cashout de la API de retiro (cash out) con un número de celular no existente en ambiente de pruebas.
4
Request y Response del servicio de retiro/cashout de la API de retiro (cash out) con un número de celular no existente en ambiente de pruebas.
5
Request y Response del servicio de retiro/cashout de la API de retiro (cash out) con un token inválido en ambiente de pruebas.
6
Request y Response del servicio de reverso de la API de retiro (cash out) de un retiro/cashout que haya sido exitoso.
El servicio de reverso es obligatorio. Debe usarse ante fallas técnicas en tu sistema o cuando el servicio de recarga de Nequi arroje timeout o error 500, lo cual se debe hacer de manera inmediata y durante el mismo día del movimiento.
Por eso, es súper importante tener la capacidad de usar este servicio.
Dispersiones y Reembolsos:
1
Request y Response del servicio de la API dispersiones y screenshot con el comprobante de recarga en el App con un número de celular válido y existente en el ambiente de pruebas.
2
Request y Response del servicio de la API dispersiones con un número no existente en el ambiente de pruebas.
3
Request y Response del servicio de la API dispersiones con un valor superior a los topes de la cuenta de un número de celular válido y existente en el ambiente de pruebas.
4
Request y Response del servicio de reverso de la API dispersiones que haya sido exitosa.
El servicio de reverso es obligatorio. Debe usarse si: se desea cancelar el pago pendiente antes de que un usuario haga el pago, si hay fallas técnicas en tu sistema con la confirmación de pago o cuando el servicio de Nequi muestra timeout o error 500 y no se puede confirmar si el usuario Nequi realizó o rechazó el pago.
Por eso, es súper importante tener la capacidad de usar este servicio.
1
Request y Response del servicio de generación de código de la API de códigos por plata y screenshot con el comprobante de redención del código en el App con un número de celular válido y existente en el ambiente de pruebas.
2
Request y Response del servicio de generación de código de la API de códigos por plata con un número no existente en el ambiente de pruebas de QA.
3
Request y Response del servicio de generación de código de la API de códigos por plata con un número no existente en el ambiente de pruebas.
El servicio de reverso es obligatorio. Debe usarse si desea anular la redención de un código realizada por el usuario por alguna regla de negocio.
Por eso, es súper importante tener la capacidad de usar este servicio.
Experiencias Embebidas
Ten en cuenta que:
Para ejecutar los siguientes casos de prueba y enviar las evidencias a Nequi para la certificación, no puedes hacerlo con los datos del comercio genérico que fueron proporcionados en el sitio de Nequi Conecta, sino con los de tu negocio.
1
Compartir la experiencia en video o pantallazos de un usuario que inició sesión en Nequi e ingresó al sitio web o App de manera exitosa.
2
Compartir la experiencia en video o pantallazos de un usuario que ingresó al sitio web o App sin un token de sesión.
1
Compartir la experiencia en video o pantallazos y el request y response del API Consulta de información de un usuario que inició sesión en Nequi e ingresó al sitio web o app de manera exitosa.
2
Compartir la experiencia en video o pantallazos y el request y response del API Consulta de información, para un token de sesión con un token inválido y con un token expirado.
Para la integración con esta API primero debemos definir los eventos a reportar durante toda la experiencia. Si aún no hemos realizado este paso, por favor comunicarse con negocios@nequi.com.
1
Compartir la experiencia en video o pantallazos y el request y response del API de eventos, para cada evento durante la experiencia en el sitio web o App.
1
Request y response del servicio de pago inmediato con la API y pantallazo del comprobante del débito en la experiencia y en los movimientos de Nequi, en el ambiente de pruebas y con un número de celular que esté activo.
2
Request y response del servicio de pago inmediato con la API y pantallazo, con el cobro por un monto mayor al saldo que tiene un número de celular que esté activo y exista en el ambiente de pruebas, para evidenciar el rechazo por fondos insuficientes.
3
Request y response del servicio de pago inmediato con la API y pantallazo, con el cobro a un número de celular con la sesión expirada.
4
Request y response del servicio de pago inmediato con la API y pantallazo, con el cobro a una cuenta Nequi bloqueada. Para este escenario deberás solicitar que la cuenta Nequi que está usando en el ambiente de pruebas sea bloqueada temporalmente, a través de nuestro canal de slack.
Para poder ejecutar los casos prueba de esta API deberá tener pagos exitosos.
1
Request y response del servicio de devolución o reverso de un pago con la API que haya funcionado sin problema.
2
Request y response del servicio de devolución o reverso de un pago que ya haya sido reversado
3
Pantallazo de un pago y reverso donde Nequi no responde ante la petición o retornó error 500 (simular timeout).
El servicio de reverso es obligatorio. Debe usarse si: se desea cancelar el pago pendiente antes de que un usuario haga el pago, si hay fallas técnicas en tu sistema con la confirmación de pago o cuando el servicio de Nequi muestra timeout o error 500 y no se puede confirmar si el usuario Nequi realizó o rechazó el pago.
Por eso, es súper importante tener la capacidad de usar este servicio
Para poder ejecutar los casos prueba de esta API, deberás tener una reserva de saldo exitosa.
1
Request y response del servicio de devolución o reverso de una reserva de saldo que haya funcionado sin problema.
2
Request y response del servicio de devolución o reverso de una reserva de saldo que ya haya sido reversada.
3
Pantallazo de un reserva y reverso donde Nequi no responde ante la petición o retornó error 500 (simular timeout).
Para poder ejecutar los casos prueba de esta API, deberás tener una reserva de saldo exitosa.
1
Request y response de la cancelación de una reserva de saldo exitosa y su pantallazo.
2
Request y response de la cancelación de una reserva previamente cancelada y el pantallazo.
1
Request y response del servicio de consulta de estado de reserva de saldo con una reserva previamente exitosa.
2
Request y response del servicio de consulta de estado de reserva de saldo con una reserva previamente cancelada.
3
Request y response del servicio de consulta de estado de reserva de saldo con una reserva vencida.
1
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo del movimiento de Nequi, en el ambiente de pruebas y con un número de cel que esté activo.
2
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo, con el cobro por un monto mayor al saldo enviado para una reserva que exista en el ambiente de pruebas, para evidenciar el reverso de la reserva y cobro por el valor final.
3
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo, con el cobro por un monto mayor al saldo de la reserva y al saldo que tiene un número de cel que esté activo y exista en el ambiente de pruebas, para evidenciar el error por fondos insuficientes y cobro por el valor reservado previamente, retornando el valor restante que debe ser cobrado por otro medio (efectivo).
4
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo, con el cobro a un número de cel con la sesión expirada.
5
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo, con el cobro a un Nequi bloqueado. Para este escenario deberás solicitar que la cuenta Nequi que estás usando en el ambiente de pruebas sea bloqueada temporalmente, a través de nuestro canal de slack.
6
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo, con el ID de una reserva ya confirmada.
7
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo, con el ID de una reserva no existente o fallida.
3
Request y response del servicio de confirmación de reserva de saldo con la API y pantallazo, con el ID de una confirmación de reserva previamente realizada. Código repetido.
Para poder ejecutar los casos prueba de esta API, deberás tener una confirmación de reserva de saldo exitosa.
1
Request y response del servicio de devolución o reverso de una confirmación de reserva de saldo que haya funcionado sin problema.
2
Request y response del servicio de devolución o reverso de una confirmación de reserva de saldo que ya haya sido reversada.
3
Pantallazo de un confirmación de reserva y reverso donde Nequi no responde ante la petición o retornó error 500 (simular timeout).
Consulta de saldo
Ten en cuenta que:
Se debe validar en el ambiente de pruebas, con número de celular, que este se encuentre activo demostrando que todo funcionó sin problemas. Tener en cuenta que dentro de los headers se deben enviar los parámetros MessageID, RequestDate, Region.
1
Request y response del servicio de solicitud de autorización del usuario que haya funcionado correctamente, adicional un pantallazo desde el App de pruebas de Nequi en donde se muestre que la autorización llegó al centro de notificaciones de Nequi y que la notificación puede ser aceptada.
2
Request y response del servicio de consulta estado de la solicitud de la autorización de una solicitud previa que no fue aceptada (Estado 0).
3
Request y response del servicio de consulta estado de la solicitud de la autorización de una solicitud previa que fue aceptada (Estado 1).
4
Pantallazo desde los ajustes del App de pruebas de Nequi donde se muestre una autorización del Disponible (AvailableBalance) aceptada.
5
Pantallazo desde los ajustes del App de pruebas de Nequi donde se muestre una eliminación de la autorización del disponible (AvailableBalance). “Ajustes > Productos > Autorizaciones > Consulta Saldo > Eliminar autorización”.
1
Request y response del servicio Consulta saldo de un usuario que haya funcionado correctamente, adicional un pantallazo desde la app de pruebas de Nequi donde se evidencie que el valor del disponible es el mismo de la respuesta del servicio en el campo: balance.
2
Request y response del servicio Consulta saldo de un usuario que no tenga una autorización previamente aceptada.
Endpoints productivos:
Ten en cuenta que:
Como te indicamos en el paso 6 inicial, debes cambiar los Endpoints para producción.
Elige la API que ya certificaste:
Token de seguridad:
https://oauth.nequi.com/oauth2/token?grant_type=client_credentials
Pagos
API de Pagos con push
https://api.nequi.com/payments/v2/-services-paymentservice-unregisteredpayment
https://api.nequi.com/payments/v2/-services-paymentservice-getstatuspayment
https://api.nequi.com/payments/v2/-services-reverseservices-reversetransaction
https://api.nequi.com/payments/v2/-services-paymentservice-cancelunregisteredpayment
API de pagos con QR Dinámico
https://api.nequi.com/payments/v2/-services-paymentservice-generatecodeqr
https://api.nequi.com/payments/v2/-services-paymentservice-getstatuspayment
https://api.nequi.com/payments/v2/-services-reverseservices-reversetransaction
https://api.nequi.com/payments/v2/-services-paymentservice-cancelqrpayment
API de Suscripciones
https://api.nequi.com/subscriptions/v2/-services-subscriptionpaymentservice-newsubscription
https://api.nequi.com/subscriptions/v2/-services-subscriptionpaymentservice-getsubscription
https://api.nequi.com/subscriptions/v2/-services-subscriptionpaymentservice-automaticpayment
https://api.nequi.com/subscriptions/v2/-services-subscriptionpaymentservice-getstatuspayment
https://api.nequi.com/subscriptions/v2/-services-reverseservices-reversetransaction
API de Súper QR
https://api.nequi.com/payments/v2/-services-staticqrservices-creatependingpayment
https://api.nequi.com/payments/v2/-services-staticqrservices-getstatuspayment
https://api.nequi.com/payments/v2/-services-staticqrservices-reversepayment
Dispersiones y Reembolsos:
API de Dispersiones
https://api.nequi.com/dispersions/v2/-services-dispersionservice-dispersefunds
https://api.nequi.com/dispersions/v2/-services-dispersionservice-reversedispersion
API de Códigos de plata
https://api.nequi.com/partners/v2/-services-reportsservice-getreports
Reportes:
API de Reportes
https://api.nequi.com/partners/v2/-services-reportsservice-getreports
Experiencias Embebidas
API de Experiencias embebidas
https://api.nequi.com/thirdpartyapps/v2/user/getinfo
https://api.nequi.com/thirdpartyapps/v2/event/send
https://api.nequi.com/thirdpartyapps/v2/payment
https://api.nequi.com/thirdpartyapps/v2/payment/reverse
https://api.nequi.com/thirdpartyapps/v2/reserve
https://api.nequi.com/thirdpartyapps/v2/reserve/get
https://api.nequi.com/thirdpartyapps/v2/reserve/reverse
https://api.nequi.com/thirdpartyapps/v2/reserve/cancel
https://api.nequi.com/thirdpartyapps/v2/reserve/confirm
https://api.nequi.com/thirdpartyapps/v2/reserve/confirm/reverse