# Come collego Culqi al mio negozio?

Culqi permette ai clienti in Perù di pagare con carta, Yape o PagoEfectivo sul checkout di Culqi, usando il tuo account Culqi. Addebita in soles (PEN) o in dollari statunitensi (USD), quindi compare al checkout solo quando i tuoi prezzi sono in una di queste valute.

## Passaggi

1. In **CulqiPanel > Development > API keys**, copia la **chiave pubblica** e la **chiave segreta**. Le chiavi di test iniziano con `pk_test_` e `sk_test_`.
2. In Dropify, vai su **App**, trova **Culqi** e clicca su **Installa e connetti**.
3. Nella pagina dell'app clicca su **Collega Culqi**, digita un **Nome dell'account**, compila **Chiave pubblica** e **Chiave segreta**, poi clicca su **Aggiungi account**. Dropify verifica le chiavi con Culqi prima di salvarle.
4. Consigliato: sotto **URL del webhook** clicca su **Copia URL del webhook** e aggiungilo in Culqi (**CulqiPanel > Events > Webhooks**, eventi order.status.changed e charge.creation.succeeded). I pagamenti PagoEfectivo vengono confermati tramite questo URL.
5. Nella sezione **Impostazioni** scegli **Modalità Sandbox** per fare prove o **Modalità Live** per i pagamenti reali, con le chiavi corrispondenti.
6. Vai su **Pagamenti > Metodi di pagamento** e attiva Culqi. Puoi anche impostare uno **Sconto per ordini prepagati** per questo metodo.
7. Fai un ordine di prova in PEN o USD e paga sulla pagina di test di Culqi.

## Problemi comuni

- "Culqi ha rifiutato queste chiavi in modalità test…" → sono chiavi dell'altra modalità, oppure sono state copiate con spazi. Copiale di nuovo o cambia la modalità in **Impostazioni**.
- Culqi non compare al checkout → i tuoi prezzi (o la valuta del visitatore) non sono in PEN o USD, oppure Culqi è disattivato in **Pagamenti > Metodi di pagamento**.
- Il cliente vede "Hai annullato il pagamento. Puoi riprovare o scegliere un altro metodo di pagamento." → il pagamento è stato annullato sulla pagina di Culqi. Se ha solo lasciato la pagina, l'ordine resta in attesa.
- Un ordine pagato in un secondo momento resta non pagato → manca il webhook in Culqi. Aggiungi l'URL del webhook mostrato nella pagina dell'app (passaggio 4).

## Correlati

- [Come collego Openpay al mio negozio?](https://help.dropify.shop/it/payments_gateways/openpay/)
- [Come collego PayU al mio negozio?](https://help.dropify.shop/it/payments_gateways/payu-latam/)
- available payment gateways by country
