# ¿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

1. En **CulqiPanel > Desarrollo > API keys**, copia la **llave pública** y la **llave secreta**. Las de prueba empiezan por `pk_test_` y `sk_test_`.
2. En Dropify, ve a **Aplicaciones**, busca **Culqi** y haz clic en **Instalar y conectar**.
3. 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.
4. 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.
5. En la sección **Configuración** elige **Modo de Prueba** para probar o **Modo en Vivo** para cobros reales, con las claves correspondientes.
6. Ve a **Pagos > Métodos de pago** y activa Culqi. También puedes darle un **Descuento para pedidos prepagados**.
7. 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?](https://help.dropify.shop/es/payments_gateways/openpay/)
- [¿Cómo conecto PayU a mi tienda?](https://help.dropify.shop/es/payments_gateways/payu-latam/)
- available payment gateways by country
