> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Bezahlvorgang
> Bestellungen verarbeiten und Kunden zum gehosteten Checkout weiterleiten
## Übersicht
Die Funktion `checkout()` erstellt eine Bestellung aus dem aktuellen Warenkorb und leitet den Kunden automatisch zur gehosteten Checkout-Seite von Komerza weiter, um die Zahlung abzuschließen.
Die Checkout-Funktion validiert den Warenkorb, erstellt eine Bestellung und
**leitet automatisch** zur Zahlungsseite weiter. Keine manuelle
Weiterleitungsverarbeitung erforderlich.
## Grundlegende Verwendung
```javascript theme={null}
const response = await komerza.checkout(emailAddress, couponCode);
```
### Parameter
E-Mail-Adresse des Kunden für die Bestellung. Muss ein gültiges E-Mail-Format
sein.
Optionaler Coupon-/Rabattcode für die Bestellung. Muss 3-32 Zeichen lang sein,
wenn angegeben.
### Rückgabe
Gibt ein Promise zurück, das zu `ApiResponse` aufgelöst wird:
```typescript theme={null}
interface ApiResponse {
success: boolean; // Ob die Bestellung erstellt wurde
message?: string; // Fehlermeldung bei Misserfolg
invalidFields?: Array<{
// Validierungsfehler falls vorhanden
fieldName: string;
reason: string;
}>;
data?: Order; // Bestelldetails bei Erfolg
}
```
Wenn `success` `true` ist, leitet der Browser automatisch zur Checkout-Seite
weiter. Die Antwort ist hauptsächlich für die Fehlerbehandlung nützlich.
## Validierung
Die Checkout-Funktion führt vor der Bestellerstellung eine Validierung durch:
**Warenkorb-Validierung:**
* Warenkorb darf nicht leer sein
* Alle Artikel müssen gültige Produkt- und Varianten-IDs haben
**E-Mail-Validierung:**
* Muss ein gültiges E-Mail-Format sein
**Coupon-Validierung (falls angegeben):**
* Muss mindestens 3 Zeichen lang sein
* Darf 32 Zeichen nicht überschreiten
## Einfaches Beispiel
```javascript theme={null}
// Checkout-Button-Handler
async function handleCheckout() {
const email = document.getElementById("email").value;
const coupon = document.getElementById("coupon").value;
try {
const response = await komerza.checkout(email, coupon);
// Wird nur ausgeführt, wenn der Checkout fehlschlug (keine Weiterleitung)
if (!response.success) {
alert(response.message || "Checkout fehlgeschlagen");
}
} catch (error) {
console.error("Checkout-Fehler:", error);
alert("Beim Checkout ist ein Fehler aufgetreten");
}
}
```
## Vollständiges Beispiel mit Validierung
```html theme={null}
Bezahlen
```
## Fehlerbehandlung
Häufige Fehlerszenarien und deren Behandlung:
### Leerer Warenkorb
```javascript theme={null}
const response = await komerza.checkout(email);
if (!response.success && response.message === "Basket is empty") {
alert("Bitte legen Sie Artikel in den Warenkorb, bevor Sie zur Kasse gehen");
}
```
### Validierungsfehler
```javascript theme={null}
const response = await komerza.checkout(email, coupon);
if (!response.success && response.invalidFields) {
response.invalidFields.forEach((field) => {
console.log(`${field.fieldName}: ${field.reason}`);
// Fehler neben dem zugehörigen Formularfeld anzeigen
});
}
```
### Allgemeine Fehler
```javascript theme={null}
try {
await komerza.checkout(email, coupon);
} catch (error) {
// Netzwerkfehler oder andere Ausnahme
console.error("Checkout fehlgeschlagen:", error);
alert(
"Checkout konnte nicht abgeschlossen werden. Überprüfen Sie Ihre Verbindung.",
);
}
```