# Como conectar a Culqi à minha loja?

A Culqi permite que clientes no Peru paguem por cartão, Yape ou PagoEfectivo no checkout da Culqi, usando a sua própria conta Culqi. Ela cobra em soles (PEN) ou dólares americanos (USD), então só aparece no checkout quando seus preços estão em uma dessas moedas.

## Passos

1. Em **CulqiPanel > Development > API keys**, copie a **chave pública** e a **chave secreta**. As chaves de teste começam com `pk_test_` e `sk_test_`.
2. Na Dropify, vá em **Aplicativos**, encontre **Culqi** e clique em **Instalar e conectar**.
3. Na página do aplicativo, clique em **Conectar Culqi**, digite um **Nome da conta**, preencha **Chave pública** e **Chave secreta**, depois clique em **Adicionar conta**. A Dropify verifica as chaves com a Culqi antes de salvar.
4. Recomendado: em **URL do webhook**, clique em **Copiar URL do webhook** e adicione-a na Culqi (**CulqiPanel > Events > Webhooks**, eventos order.status.changed e charge.creation.succeeded). Os pagamentos PagoEfectivo são confirmados por ele.
5. Na seção **Configurações**, escolha **Modo Sandbox** para testar ou **Modo Produção** para pagamentos reais, com as chaves correspondentes.
6. Vá em **Pagamentos > Formas de pagamento** e ative a Culqi. Você também pode definir um **Desconto para pedidos pré-pagos** para ela.
7. Faça um pedido de teste em PEN ou USD e pague na página de teste da Culqi.

## Problemas comuns

- "A Culqi recusou estas chaves no modo de teste…" → chaves do outro modo, ou copiadas com espaços. Copie-as de novo ou troque o modo em **Configurações**.
- A Culqi não aparece no checkout → seus preços (ou a moeda do visitante) não estão em PEN ou USD, ou a Culqi está desativada em **Pagamentos > Formas de pagamento**.
- O cliente vê "Você cancelou o pagamento. Você pode tentar de novo ou escolher outra forma de pagamento." → o pagamento foi cancelado na página da Culqi. Se ele apenas saiu da página, o pedido continua pendente.
- Um pedido pago mais tarde continua sem pagamento → o webhook está faltando na Culqi. Adicione a URL do webhook mostrada na página do aplicativo (passo 4).

## Relacionados

- [Como conectar a Openpay à minha loja?](https://help.dropify.shop/pt/payments_gateways/openpay/)
- [Como conectar a PayU à minha loja?](https://help.dropify.shop/pt/payments_gateways/payu-latam/)
- available payment gateways by country
