Entwickler
Eingebettetes Widget
Der Kunde zahlt, ohne Ihre Domain zu verlassen. Sie erstellen die Rechnung über die API und rendern das CryBit-Zahlungsformular auf Ihrer eigenen Seite.
1. Rechnung erstellen
Verwenden Sie dasselbe POST /api/v1/payments. Die Antwort enthält immer confirmation.confirmation_token, das der Rechnungs-uuid entspricht. Das Feld confirmation in der Anfrage ist optional.
2. Skript laden und Container hinzufügen
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. Formular rendern
JavaScript
const checkout = new CryBitCheckout({
confirmation_token: 'INVOICE-UUID',
return_url: 'https://merchant.example/thanks',
lang: 'en',
error_callback: (err) => console.log(err),
})
checkout.render('payment-form').then(() => { /* the form is shown */ })
checkout.on('success', () => { /* status paid: confirm the order by webhook or GET */ })
checkout.on('fail', () => { /* expired, cancelled or refunded */ })
checkout.on('complete', () => checkout.destroy())Modalfenster
Gibt es keinen Container auf der Seite, öffnen Sie das Widget über der Website mit customization: { modal: true } (oder modal: true) und rufen Sie checkout.render() ohne Argumente auf.
Optionen und Events
| Option | Bedeutung |
|---|---|
confirmation_token | Erforderlich. Die Rechnungs-uuid (Aliase: uuid, invoice_uuid). |
return_url | Wohin der Kunde nach der Zahlung gelangt. |
lang | Sprache der Oberfläche; andernfalls die Sprache des Browsers. |
modal / customization.modal | true für ein Pop-up statt eines Containers. |
error_callback, success_callback | Wird bei einem Fehler (kein Token, kein Container) aufgerufen und wenn der Status auf paid wechselt. |
Events: ready, status, success, fail, complete, close, error. Methoden: render(id), on(event, fn), destroy().
Bestätigen Sie die Bestellung per Webhook oder durch Auslesen des Status. Das Widget-Event dient nur der Benutzeroberfläche.
FAQ
Kann ich das Widget testen?
Ja. Bei einem Testhändler zeigt das Widget eine Schaltfläche, um die Rechnung als bezahlt zu markieren, und das Guthaben wird nicht gutgeschrieben.