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
- In CulqiPanel > Development > API keys, copia la chiave pubblica e la chiave segreta. Le chiavi di test iniziano con
pk_test_esk_test_. - In Dropify, vai su App, trova Culqi e clicca su Installa e connetti.
- 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.
- 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.
- Nella sezione Impostazioni scegli Modalità Sandbox per fare prove o Modalità Live per i pagamenti reali, con le chiavi corrispondenti.
- Vai su Pagamenti > Metodi di pagamento e attiva Culqi. Puoi anche impostare uno Sconto per ordini prepagati per questo metodo.
- 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?
- Come collego PayU al mio negozio?
- available payment gateways by country