Zum Inhalt springen

Gehostete Zahlungsseite

Jede Rechnung und Einzahlung hat eine fertige Zahlungsseite. Senden Sie dem Kunden die von der API zurückgegebene payment_url, sobald die Adresse verfügbar ist.

Die Seite zeigt Token, Netzwerk, Adresse, QR-Code und Zahlungsstatus. Sie müssen keine eigene Zahlungsseite entwickeln.

Verwenden Sie payment_url genau wie zurückgegeben. Erstellen Sie keine URL aus der Issuance-ID und gehen Sie nicht von einem festen Format für public_id aus.

Der Kunde muss den angezeigten Token im angezeigten Netzwerk senden. Das Senden eines anderen Tokens oder die Verwendung eines anderen Netzwerks bezahlt die Rechnung nicht.

Bearbeiten Sie das Branding im Dashboard oder verwenden Sie eine Inhaber-Sitzung:

PATCH /api/v1/shops/{shop_id}/branding
Authorization: Bearer <owner-session-token>
Idempotency-Key: <saved-unique-key>
Content-Type: application/json
{"name":"My shop"}

Das Branding steuert den angezeigten Shop-Namen und das Logo. Legen Sie beim Erstellen der Rechnung oder Einzahlung die return_url einer Zahlung fest. Beides ändert nicht den Auszahlungsempfänger.

Der Rückkehrlink dient der Navigation. Dass ein Kunde ihn öffnet, ist kein Zahlungsnachweis.

Verwenden Sie Rechnungs- und Einzahlungsstatus, um den Status von Ihrem Backend aus zu lesen, oder verifizieren Sie einen signierten Webhook. Bewahren Sie API-Schlüssel auf dem Server auf; setzen Sie sie niemals in den Zahlungslink oder Browser-Code.