Vorgio als Zahlungsanbieter

Vorgio ist ein Rechnungs-Tool. Die Payment-Provider-Integration verwandelt Vorgio in eine Checkout-Option für Ihre Kunden: Wenn einer Ihrer Kunden im Checkout „Kauf auf Rechnung" auswählt, ruft Ihr Shop Vorgio auf, Vorgio legt den Kundendatensatz und eine nummerierte Rechnung an und versendet die Rechnung per E-Mail an den Kunden. Ihr Shop wird per Webhooks benachrichtigt, sobald die Rechnung versendet und (später) als bezahlt markiert wird.

So funktioniert „Kauf auf Rechnung" / „offene Rechnung" im DACH-Raum, paketiert für jede Shop-Plattform.

#Wer ist wofür zuständig

Bereich	Verantwortlich
Die Kontaktdaten des Kunden, die Rechnung selbst, die gesetzliche Aufbewahrung	Vorgio (das Vorgio-Team des Händlers)
Die Bestellung, der Produktkatalog, die Erfüllung	Ihr Shop
Bankseitige Zahlung (der Kunde überweist den Betrag)	Die Bank des Kunden → die Bank des Händlers
Abgleich („diese Rechnung wurde bezahlt")	Der Händler, indem er die Rechnung in Vorgio als bezahlt markiert (manuell oder über das Plugin Ihres Shops, sobald dessen eigener Processor die Überweisung bestätigt)

Vorgio ist kein Payment-Processor. Keine Kartendaten, kein PSD2, kein SCA. Geld fließt out-of-band per SEPA-Überweisung (die Rechnung trägt einen EPC-QR-Code mit der IBAN des Händlers).

#Zwei Integrationswege

#Server-zu-Server (empfohlen)

Der Server Ihres Shops ruft Vorgio auf. Das Vorgio-API-Token verlässt Ihren Server nie.

 1Customer → Your shop checkout → Your shop server → Vorgio API → invoice email to customer
 2                                                       ↓
 3                                                  webhook back to your shop

Diesen Weg nutzen das PHP SDK und das WooCommerce-Plugin. Er ist der einfachste, sicherste und schnellste Weg zur Integration. Wählen Sie ihn, sofern Sie keinen triftigen Grund dagegen haben.

#Browser-seitig über das JS-Widget

Wenn Sie keinen serverseitigen Checkout-Flow haben (z. B. ein Static-Site-Shop, der ausschließlich clientseitiges JavaScript nutzt), verwenden Sie das JS-Widget. Das Widget hält Ihr API-Token nie selbst — stattdessen erstellt Ihr schlanker Server (oder eine kleine Serverless-Funktion) einen einmaligen Checkout Intent und übergibt dem Browser ein client_secret, das an genau diesen Intent gebunden ist. Der Browser fordert dann Vorgio auf, den Intent zu bestätigen, und Vorgio erstellt die Rechnung und versendet sie.

Sie benötigen dafür weiterhin eine serverseitige Komponente — und sei es nur ein einzelner Cloudflare Worker oder eine Vercel-Funktion — denn das Erstellen des Intents erfordert das geheime API-Token.

#Was Sie zum Start benötigen

Einen Vorgio-Account und mindestens ein Team. (Falls noch nicht geschehen, registrieren Sie sich auf der Vorgio-Hauptseite.)
Ein API-Token, das in den Einstellungen Ihres Teams mit dem Preset „Payment-Provider-Integration" ausgestellt wurde. Siehe Erste Schritte.
Einen Webhook-Endpoint auf Ihrem Server, der invoice.sent- und invoice.paid-Events empfangen kann. Siehe Webhooks.

#Was diese Anleitung abdeckt

Erste Schritte — Token ausstellen, ersten Aufruf durchführen
Der /v1/checkouts-Endpoint — der eine Aufruf, der alles erledigt
Webhooks — Versand-/Zahlungs-Events mit verifizierten Signaturen empfangen
Clients & external_id — Find-or-Create-Semantik
Metadata — die Order-ID Ihres Shops im Round-Trip mitführen
Rate Limits — Defaults, der Floor und der Umgang mit 429ern
Fehlerreferenz — RFC 7807 Problem-Typen
PHP SDK — vorgio/vorgio-php (Vorschau)
WooCommerce-Plugin — Drop-in für WP-Shops (Vorschau)
JS-Widget — Browser-seitiger Checkout via @vorgio-app/vorgio-js
Go-Live — Produktions-Checkliste
Test-Modus — die vollständige API gegen das produktive Vorgio ausführen, ohne echte Nebenwirkungen

Für die rohen Endpoint-Strukturen (Request/Response/Header) siehe die automatisch generierte /api-reference.