# Wie verbinde ich Culqi mit meinem Shop?

Mit Culqi können Kunden in Peru per Karte, Yape oder PagoEfectivo im Checkout von Culqi bezahlen, über Ihr eigenes Culqi-Konto. Es belastet in Soles (PEN) oder US-Dollar (USD), erscheint also im Checkout nur, wenn Ihre Preise in einer dieser Währungen sind.

## Schritte

1. Kopieren Sie unter **CulqiPanel > Development > API keys** den **Public Key** und den **Secret Key**. Testschlüssel beginnen mit `pk_test_` und `sk_test_`.
2. Gehen Sie in Dropify zu **Apps**, suchen Sie **Culqi** und klicken Sie auf **Installieren und verbinden**.
3. Klicken Sie auf der App-Seite auf **Culqi verbinden**, geben Sie einen **Kontiname** ein, füllen Sie **Öffentlicher Schlüssel (Public Key)** und **Geheimer Schlüssel (Secret Key)** aus und klicken Sie dann auf **Konto hinzufügen**. Dropify prüft die Schlüssel vor dem Speichern bei Culqi.
4. Empfohlen: Klicken Sie unter **Webhook-URL** auf **Webhook-URL kopieren** und fügen Sie sie in Culqi hinzu (**CulqiPanel > Events > Webhooks**, Ereignisse order.status.changed und charge.creation.succeeded). PagoEfectivo-Zahlungen werden darüber bestätigt.
5. Wählen Sie im Bereich **Einstellungen** den **Sandbox-Modus** zum Testen oder den **Live-Modus** für echte Zahlungen, jeweils mit den passenden Schlüsseln.
6. Gehen Sie zu **Zahlungen > Zahlungsmethoden** und schalten Sie Culqi ein. Sie können dafür auch einen **Rabatt für Vorauszahlungen** festlegen.
7. Geben Sie eine Testbestellung in PEN oder USD auf und bezahlen Sie auf der Culqi-Testseite.

## Häufige Probleme

- „Culqi hat diese Schlüssel im Testmodus abgelehnt…“ → Schlüssel des anderen Modus oder mit Leerzeichen kopiert. Kopieren Sie sie erneut oder wechseln Sie den Modus in den **Einstellungen**.
- Culqi erscheint nicht im Checkout → Ihre Preise (oder die Währung des Besuchers) sind nicht in PEN oder USD, oder Culqi ist unter **Zahlungen > Zahlungsmethoden** ausgeschaltet.
- Der Kunde sieht „Sie haben die Zahlung abgebrochen. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen.“ → Die Zahlung wurde auf der Culqi-Seite abgebrochen. Hat der Kunde die Seite nur verlassen, bleibt die Bestellung ausstehend.
- Eine später bezahlte Bestellung bleibt unbezahlt → Der Webhook fehlt in Culqi. Fügen Sie die Webhook-URL hinzu, die auf der App-Seite angezeigt wird (Schritt 4).

## Verwandte Artikel

- [Wie verbinde ich Openpay mit meinem Shop?](https://help.dropify.shop/de/payments_gateways/openpay/)
- [Wie verbinde ich PayU mit meinem Shop?](https://help.dropify.shop/de/payments_gateways/payu-latam/)
- available payment gateways by country
