Comment connecter Culqi à ma boutique ?
Culqi permet à vos clients au Pérou de payer par carte, Yape ou PagoEfectivo sur le checkout de Culqi, avec votre propre compte. Il encaisse en soles (PEN) ou en dollars (USD) : il n'apparaît au paiement que si vos prix sont dans l'une de ces devises.
Étapes
- Dans CulqiPanel > Development > API keys, copiez la clé publique et la clé secrète. Les clés de test commencent par
pk_test_etsk_test_. - Dans Dropify, allez dans Applications, trouvez Culqi et cliquez sur Installer et connecter.
- Sur la page de l'application, cliquez sur Connecter Culqi, saisissez un Nom du compte, remplissez Clé publique et Clé secrète, puis cliquez sur Ajouter un compte. Dropify vérifie les clés auprès de Culqi avant d'enregistrer.
- Recommandé : sous URL du webhook, cliquez sur Copier l'URL du webhook et ajoutez-la dans Culqi (CulqiPanel > Events > Webhooks, événements order.status.changed et charge.creation.succeeded). Les paiements PagoEfectivo sont confirmés par ce biais.
- Dans la section Réglages, choisissez Mode Sandbox pour tester ou Mode en Direct pour les vrais paiements, avec les clés correspondantes.
- Allez dans Paiements > Moyens de paiement et activez Culqi. Vous pouvez aussi lui donner une Remise pour les commandes prépayées.
- Passez une commande test en PEN ou USD et payez sur la page de test de Culqi.
Problèmes courants
- « Culqi a refusé ces clés en mode test… » → clés de l'autre mode ou copiées avec des espaces. Recopiez-les ou changez de mode dans Réglages.
- Culqi n'apparaît pas au paiement → vos prix (ou la devise du visiteur) ne sont pas en PEN ou USD, ou Culqi est désactivé dans Paiements > Moyens de paiement.
- Le client voit « Vous avez annulé le paiement. Vous pouvez réessayer ou choisir un autre moyen de paiement. » → le paiement a été annulé sur la page Culqi. S'il a seulement quitté la page, la commande reste en attente.
- Une commande payée plus tard reste impayée → le webhook manque chez Culqi. Ajoutez l'URL du webhook affichée sur la page de l'application (étape 4).
Voir aussi
- Comment connecter Openpay à ma boutique ?
- Comment connecter PayU à ma boutique ?
- available payment gateways by country