Zum Inhalt
Perly
StartenKostenlos starten

Anleitungen

WooCommerce

Eine Zahlungsart für WooCommerce: Bitcoin und USDC/USDT direkt in Ihre Wallet, die Bestellung markiert ein signierter Webhook als bezahlt.

Als Markdown ansehen

Das Plugin von Perly Pay bringt Krypto in den klassischen Checkout und in den Checkout-Block. Jede Bestellung wird zu einer Rechnung in Perly Pay; der Käufer bezahlt sie über dem Shop oder auf einer eigenen Seite; ein signierter Webhook markiert die Bestellung als bezahlt. WordPress 6.5+, WooCommerce 8.6+, PHP 8.1+. Auf dem Server müssen Sie nichts installieren: Das PHP-SDK ist schon enthalten.

Rechnungen sind in USD oder EUR. In einem Shop mit anderer Währung ist die Zahlungsart ausgeblendet, und ihre Einstellungen erklären, warum.

Installation

  1. 1

    Zip holen

    Das Plugin ist auf dem Weg zu WordPress.org. Bis es dort ist, schreiben Sie uns für perly-pay-woocommerce.zip.

  2. 2

    Installieren

    In WordPress: Plugins → Neues Plugin hinzufügen → Plugin hochladen, Zip wählen, aktivieren. WooCommerce muss aktiv sein.

  3. 3

    Einstellungen öffnen

    WooCommerce → Einstellungen → Zahlungen → Perly Pay.

Einstellungen

FeldWas hinein gehört
Geheimer SchlüsselDashboard → Developers → API keys. sk_test_… für den Testmodus, sk_live_… für echtes Geld. Die Einstellungen zeigen, in welchem Modus Sie sind.
Signatur-Secret des Webhookswhsec_…. Webhook einrichten füllt es selbst aus.
ZahlungsseiteFenster öffnet den Checkout über dem Shop (pay.js). Weiterleitung schickt den Käufer auf seine Seite. Auf Handys öffnet sich immer die Seite selbst.
Status nach der ZahlungWie WooCommerce entscheidet (In Bearbeitung; Fertiggestellt bei Downloads), immer In Bearbeitung oder immer Fertiggestellt.
Titel, BeschreibungWas Käufer im Checkout sehen.
Debug-ProtokollEreignisse und Fehler unter WooCommerce → Status → Protokolle. Nie Schlüssel, Secrets oder Käuferdaten.
  1. 1

    Schlüssel einfügen

    Und auf Verbindung testen klicken: Sie sehen, ob der Schlüssel funktioniert, seinen Modus und ob der Webhook dieses Shops in Perly Pay existiert.

  2. 2

    Webhook einrichten

    Klicken Sie auf Webhook einrichten. Es fügt die Adresse des Shops (sie steht über den Buttons, …/wp-json/perly-pay/v1/webhook) in Perly Pay hinzu und speichert das Secret. Oder fügen Sie sie selbst unter Developers → Webhooks hinzu und setzen Sie das Secret ein.

  3. 3

    Fenster erlauben

    Fügen Sie unter Dashboard → Settings die Adresse des Shops bei Sites that may embed the checkout hinzu. Ohne das bietet das Fenster an, den Checkout in einem neuen Tab zu öffnen.

  4. 4

    Einschalten

    Haken Sie Krypto mit Perly Pay annehmen an und speichern Sie.

Testen

Mit einem Schlüssel sk_test_… bestellen Sie in Ihrem eigenen Shop und wählen Perly Pay. Die Bestellung wartet als Zahlung ausstehend. Bezahlen Sie die Rechnung mit Test-Coins oder über die API – ihre ID steht in den Bestellnotizen:

bash
curl -X POST https://pay.perly.io/api/v1/invoices/inv_…/simulate \
  -H "Authorization: Bearer $PERLY_PAY_SECRET_KEY" -H "Content-Type: application/json" -d '{}'

Nach wenigen Sekunden wird die Bestellung In Bearbeitung, mit einer Notiz: Netzwerk, Betrag und Link zur Transaktion. {"outcome":"short"} und {"outcome":"over"} testen die anderen Fälle, sobald auf der Rechnungsseite eine Coin gewählt ist.

Wie Bestellungen den Zahlungen folgen

In Perly PayBestellung
Bezahlt, Absender geprüft (invoice.fulfilled)Bezahlt: der gewählte Status, Bestand reduziert, E-Mail an den Käufer. Eine Notiz mit jeder Überweisung und ihrer Transaktion.
Gesehen, teilweise bezahlt, bezahlt und noch in PrüfungEine Notiz. Wartet weiter.
Zur Prüfung angehaltenIn Wartestellung, mit Grund. Entscheiden Sie in Perly Pay.
Abgelaufen oder storniert, nichts bezahltStorniert.
Abgelaufen, teilweise bezahltIn Wartestellung: in Perly Pay erstatten oder annehmen.
ErstattetVollständig rückerstattet oder eine Notiz über den Teil.

Jedes Ereignis wird einmal angewendet, auf die Bestellung, für die es erstellt wurde, und ein spätes „abgelaufen“ storniert nie eine Zahlung. Kommt der Käufer vor dem Webhook auf die Dankeseite zurück, fragt das Plugin die API und aktualisiert die Bestellung sofort.

Erstattungen

Erstatten Sie wie immer von der Bestellseite: Das Plugin eröffnet eine Erstattung in Perly Pay in der Coin, mit der bezahlt wurde (einen Teil bei einer Teilerstattung). Perly Pay bittet den Käufer per E-Mail um eine Adresse und prüft sie; die Bestellnotizen sagen, was wohin zu senden ist. Sie senden aus Ihrer Wallet und fügen die Transaktions-ID in Perly Pay ein – Perly Pay hält nie Geld.

Live gehen

  • Schalten Sie in Perly Pay den Live-Modus ein und verbinden Sie die öffentlichen Schlüssel Ihrer Wallet.
  • Fügen Sie einen Schlüssel sk_live_… ein. Live-Schlüssel und -Webhooks sind von den Test-Pendants getrennt: Klicken Sie noch einmal auf Webhook einrichten.
  • Fügen Sie die https-Adresse des Live-Shops im Live-Modus bei Sites that may embed the checkout hinzu.
  • Machen Sie eine kleine echte Bestellung und erstatten Sie sie.