¿Cómo conecto Culqi a mi tienda?
Culqi permite a tus clientes en Perú pagar con tarjeta, Yape o PagoEfectivo en el checkout de Culqi, con tu propia cuenta. Cobra en soles (PEN) o dólares (USD), así que solo aparece en el checkout si tus precios están en una de esas monedas.
Pasos
- En CulqiPanel > Desarrollo > API keys, copia la llave pública y la llave secreta. Las de prueba empiezan por
pk_test_ysk_test_. - En Dropify, ve a Aplicaciones, busca Culqi y haz clic en Instalar y conectar.
- En la página de la app haz clic en Conectar Culqi, escribe un Nombre de la cuenta, completa Clave pública y Clave secreta y haz clic en Agregar cuenta. Dropify verifica las claves con Culqi antes de guardar.
- Recomendado: en URL del webhook haz clic en Copiar URL del webhook y agrégala en Culqi (CulqiPanel > Events > Webhooks, eventos order.status.changed y charge.creation.succeeded). Por ahí se confirman los pagos con PagoEfectivo.
- En la sección Configuración elige Modo de Prueba para probar o Modo en Vivo para cobros reales, con las claves correspondientes.
- Ve a Pagos > Métodos de pago y activa Culqi. También puedes darle un Descuento para pedidos prepagados.
- Haz un pedido de prueba en PEN o USD y paga en la página de prueba de Culqi.
Problemas frecuentes
- "Culqi rechazó estas claves en modo prueba…" → claves del otro modo o copiadas con espacios. Cópialas de nuevo o cambia el modo en Configuración.
- Culqi no aparece en el checkout → tus precios (o la moneda del visitante) no están en PEN o USD, o Culqi está desactivado en Pagos > Métodos de pago.
- El cliente ve "Cancelaste el pago. Puedes intentarlo de nuevo o elegir otro medio de pago." → el pago se canceló en la página de Culqi. Si solo salió de la página, el pedido queda pendiente.
- Un pedido pagado más tarde queda sin pagar → falta el webhook en Culqi. Agrega la URL del webhook que aparece en la página de la app (paso 4).
Relacionado
- ¿Cómo conecto Openpay a mi tienda?
- ¿Cómo conecto PayU a mi tienda?
- available payment gateways by country