# 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

1. Dans **CulqiPanel > Development > API keys**, copiez la **clé publique** et la **clé secrète**. Les clés de test commencent par `pk_test_` et `sk_test_`.
2. Dans Dropify, allez dans **Applications**, trouvez **Culqi** et cliquez sur **Installer et connecter**.
3. 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.
4. 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.
5. Dans la section **Réglages**, choisissez **Mode Sandbox** pour tester ou **Mode en Direct** pour les vrais paiements, avec les clés correspondantes.
6. Allez dans **Paiements > Moyens de paiement** et activez Culqi. Vous pouvez aussi lui donner une **Remise pour les commandes prépayées**.
7. 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 ?](https://help.dropify.shop/fr/payments_gateways/openpay/)
- [Comment connecter PayU à ma boutique ?](https://help.dropify.shop/fr/payments_gateways/payu-latam/)
- available payment gateways by country
