> ## 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.
# Kasa
> Przetwarzaj zamówienia i przekierowuj klientów do hostowanej kasy
## Przegląd
Funkcja `checkout()` tworzy zamówienie z aktualnego koszyka i automatycznie przekierowuje klienta do hostowanej strony kasy Komerza w celu dokończenia płatności.
Funkcja kasy waliduje koszyk, tworzy zamówienie i **automatycznie
przekierowuje** do strony płatności. Nie jest potrzebna ręczna obsługa
przekierowania.
## Podstawowe użycie
```javascript theme={null}
const response = await komerza.checkout(emailAddress, couponCode);
```
### Parametry
Adres e-mail klienta dla zamówienia. Musi być w prawidłowym formacie e-mail.
Opcjonalny kod kuponu/rabatu do zastosowania w zamówieniu. Musi mieć od 3 do
32 znaków, jeśli podany.
### Zwraca
Zwraca Promise, które rozwiązuje się do `ApiResponse`:
```typescript theme={null}
interface ApiResponse {
success: boolean; // Czy zamówienie zostało utworzone
message?: string; // Komunikat błędu w przypadku niepowodzenia
invalidFields?: Array<{
// Błędy walidacji jeśli są
fieldName: string;
reason: string;
}>;
data?: Order; // Szczegóły zamówienia w przypadku sukcesu
}
```
Jeśli `success` jest `true`, przeglądarka automatycznie przekieruje do strony
kasy. Odpowiedź jest głównie przydatna do obsługi błędów.
## Walidacja
Funkcja kasy przeprowadza walidację przed utworzeniem zamówienia:
**Walidacja koszyka:**
* Koszyk nie może być pusty
* Wszystkie produkty muszą mieć prawidłowe ID produktu i wariantu
**Walidacja e-maila:**
* Musi być w prawidłowym formacie adresu e-mail
**Walidacja kuponu (jeśli podany):**
* Musi mieć co najmniej 3 znaki
* Nie może przekraczać 32 znaków
## Prosty przykład
```javascript theme={null}
// Obsługa przycisku kasy
async function obsluzKase() {
const email = document.getElementById("email").value;
const coupon = document.getElementById("coupon").value;
try {
const response = await komerza.checkout(email, coupon);
// Wykonuje się tylko jeśli kasa się nie powiodła (brak przekierowania)
if (!response.success) {
alert(response.message || "Kasa się nie powiodła");
}
} catch (error) {
console.error("Błąd kasy:", error);
alert("Wystąpił błąd podczas realizacji zamówienia");
}
}
```
## Pełny przykład z walidacją
```html theme={null}
Kasa
```
## Obsługa błędów
Typowe scenariusze błędów i sposób ich obsługi:
### Pusty koszyk
```javascript theme={null}
const response = await komerza.checkout(email);
if (!response.success && response.message === "Basket is empty") {
alert("Dodaj produkty do koszyka przed złożeniem zamówienia");
}
```
### Błędy walidacji
```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}`);
// Wyświetl błąd obok odpowiedniego pola formularza
});
}
```
### Błędy ogólne
```javascript theme={null}
try {
await komerza.checkout(email, coupon);
} catch (error) {
// Błąd sieci lub inna wyjątek
console.error("Kasa się nie powiodła:", error);
alert("Nie można sfinalizować zamówienia. Sprawdź połączenie.");
}
```