Zum Hauptinhalt springen
Diese Anleitung führt Sie durch eine vollständige Bestellung mit der PapelShip Store API: Erstellen Sie eine Bestellung für eines Ihrer Produkte, leiten Sie den Kunden zum gehosteten Checkout weiter und bestätigen Sie die Zahlung, bevor Sie sich darauf verlassen.

Voraussetzungen

  • Ein PapelShip Shop mit mindestens einem Produkt
  • Ein Store API-Schlüssel (pk_live_...) mit der Berechtigung orders:write sowie Ihre Shop-ID für den Header x-store-hash
Beides finden Sie im PapelShip Dashboard in den API-Einstellungen Ihres Shops. Siehe Authentifizierung.
1

Bestellung erstellen

Senden Sie die E-Mail-Adresse des Kunden und die Produkte. Fügen Sie einen Idempotency-Key-Header hinzu, damit Wiederholungen niemals eine zweite Bestellung erzeugen.
2

Kunden zum Checkout weiterleiten

Die Antwort enthält die Bestellung mit ihrer checkout_url. Leiten Sie den Kunden dorthin weiter, damit er mit einer beliebigen Zahlungsmethode bezahlt, die Ihr Shop akzeptiert.
Antwort (201)
Speichern Sie invoice.id zusammen mit Ihrer Bestellung. Unbezahlte Bestellungen laufen nach 3 Stunden ab. Um eine Karte sofort zu belasten oder das Kartenformular auf Ihrer eigenen Website anzuzeigen, siehe PapelPay.
3

Zahlung bestätigen

Verlassen Sie sich niemals allein darauf, dass der Kunde auf Ihre Website zurückkehrt. Warten Sie auf den Webhook order.completed oder rufen Sie die Bestellung auf Ihrem Server ab:
Die Bestellung ist bezahlt und ausgeliefert, wenn status den Wert completed hat.
Bewahren Sie Ihren API-Schlüssel auf Ihrem Server auf. Liefern Sie ihn niemals in Browser-Code, mobilen Apps oder Desktop-Clients aus.

Nächste Schritte

Bestellungen

Physische Produkte, Status, Stornierung und Rückerstattungen.

PapelPay

Kartenzahlungen, Abonnements und das Kartenformular auf Ihrer Website.