Nequi (Colombia)
Cobre con una solicitud directa en la app Nequi usando las credenciales de Nequi Conecta de su comercio.
Con Nequi directo, su cliente escribe el celular asociado a su cuenta y recibe una solicitud en la app Nequi. Cuando la aprueba, Vendialo confirma el pago y actualiza la orden automáticamente. No interviene otra pasarela: la liquidación y las condiciones comerciales son las acordadas entre su negocio y Nequi.
Disponible en Colombia. La tienda debe cobrar en pesos colombianos (COP) y tener una integración de pagos aprobada por Nequi Conecta.
Antes de empezar
Nequi entrega credenciales propias a cada comercio. No hay claves públicas compartidas y los valores de ejemplo de la documentación técnica no sirven para cobrar ni para entrar al sandbox.
Solicite la integración desde el portal oficial de Nequi para negocios. Nequi le pedirá los datos legales y de contacto de su negocio y luego le enviará:
- Client ID
- Client Secret
- API Key (
x-api-key) - Código del comercio, normalmente con formato
NIT_...
Para probar antes de cobrar dinero real, pida también acceso al ambiente Sandbox y un celular habilitado para pruebas.
Proteja sus claves. No las publique en Trello, WhatsApp, correo abierto ni documentos compartidos. Cárguelas directamente en Vendialo o envíelas a soporte por el canal seguro acordado.
Cómo conectarlo
- Entre al panel de Vendialo y abra Cobros.
- Busque la tarjeta Nequi. Solo aparece en tiendas configuradas para Colombia.
- Pegue el Client ID, el Client Secret, la API Key y el Código del comercio.
- Elija Pruebas (Sandbox) mientras valida la integración, o Producción cuando Nequi haya habilitado el comercio para cobrar.
- Marque Mostrar Nequi en el checkout.
- Toque Guardar y probar conexión. Vendialo activará el medio solamente si puede autenticarse con las credenciales ingresadas.
Cómo lo usa el cliente
- En el checkout elige Nequi e ingresa su celular colombiano de 10 dígitos.
- Vendialo envía la solicitud de pago directamente a Nequi.
- El cliente abre la notificación en su app y aprueba o rechaza el cobro.
- La página espera la respuesta y la orden cambia a pagada cuando Nequi confirma la transacción.
Si el cliente tarda en responder, Vendialo vuelve a consultar el estado automáticamente. Una orden pendiente nunca se marca como pagada sin la confirmación server-to-server de Nequi.
Cómo devolver un pago
Abra la orden pagada y use Reembolsar orden. Vendialo solicita primero la reversa a Nequi con los datos de la transacción original; solo marca la orden como reembolsada si Nequi acepta la operación. No haga además una devolución manual, porque podría devolver el dinero dos veces.
Pruebas y producción
- Use Sandbox únicamente con las credenciales y el celular de prueba entregados por Nequi.
- Cambie a Producción solo después de completar las pruebas y recibir la habilitación comercial.
- Haga una compra pequeña y confirme que la orden figure como pagada antes de anunciar el medio.
- Si cambia de credenciales, vuelva a usar Guardar y probar conexión.
Homologación. La conexión técnica está incluida en Vendialo, pero cada comercio necesita credenciales, celular de prueba y aprobación propios de Nequi. No active Producción hasta completar una compra y una reversa en el ambiente asignado por Nequi.