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
- Kopieren Sie unter CulqiPanel > Development > API keys den Public Key und den Secret Key. Testschlüssel beginnen mit
pk_test_undsk_test_. - Gehen Sie in Dropify zu Apps, suchen Sie Culqi und klicken Sie auf Installieren und verbinden.
- 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.
- 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.
- 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.
- Gehen Sie zu Zahlungen > Zahlungsmethoden und schalten Sie Culqi ein. Sie können dafür auch einen Rabatt für Vorauszahlungen festlegen.
- 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?
- Wie verbinde ich PayU mit meinem Shop?
- available payment gateways by country