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
- Em CulqiPanel > Development > API keys, copie a chave pública e a chave secreta. As chaves de teste começam com
pk_test_esk_test_. - Na Dropify, vá em Aplicativos, encontre Culqi e clique em Instalar e conectar.
- 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.
- 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.
- Na seção Configurações, escolha Modo Sandbox para testar ou Modo Produção para pagamentos reais, com as chaves correspondentes.
- Vá em Pagamentos > Formas de pagamento e ative a Culqi. Você também pode definir um Desconto para pedidos pré-pagos para ela.
- 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?
- Como conectar a PayU à minha loja?
- available payment gateways by country