Zum Hauptinhalt springen
Eine Bestellung (Rechnung) enthält die Produkte, den Kunden und den Preis. Der Kunde bezahlt auf der gehosteten checkout_url, wo er eine beliebige Zahlungsmethode wählt, die Ihr Shop akzeptiert. Bestellungen, die über die API erstellt werden, folgen denselben Regeln wie Ihre Storefront: Preise stammen aus Ihrem Katalog, Lagerbestand wird reserviert, Gutscheine und Produktregeln gelten, und Betrugsprüfungen werden ausgeführt.

Bestellung erstellen

Antwort (201)
Leiten Sie den Kunden zur checkout_url weiter. Unbezahlte Bestellungen laufen nach 3 Stunden ab.

Physische Produkte

Fügen Sie für Produkte, die versendet werden, die Adresse hinzu. Rufen Sie die Optionen zuerst mit POST /shipping/quote ab oder lassen Sie shipping_rate_id weg, um den günstigsten Tarif zu verwenden.
Die Versandkosten werden zu total_cents addiert und als shipping_cents angezeigt. Ohne Adresse gibt der Kunde sie vor dem Bezahlen auf der Checkout-Seite ein. Versenden Sie die Bestellung nach der Zahlung mit POST /orders/{invoiceId}/shipments.

Bestellstatus

Warten Sie auf den Webhook order.completed, statt regelmäßig abzufragen. Siehe Webhooks.

Nach dem Erstellen der Bestellung

Verwenden Sie Ihre eigene Bestell-ID als Idempotency-Key für Aufrufe zum Erstellen, Abschließen und Erstatten. Wiederholungen erzeugen dann niemals eine zweite Bestellung oder eine zweite Rückerstattung.