> ## 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.
# Paiement
> Traitez les commandes et redirigez les clients vers le paiement hébergé
## Aperçu
La fonction `checkout()` crée une commande à partir du panier actuel et redirige automatiquement le client vers la page de paiement hébergée de Komerza pour finaliser le paiement.
La fonction de paiement valide le panier, crée une commande et **redirige
automatiquement** vers la page de paiement. Aucune gestion manuelle de la
redirection n'est nécessaire.
## Utilisation de base
```javascript theme={null}
const response = await komerza.checkout(emailAddress, couponCode);
```
### Paramètres
L'adresse e-mail du client pour la commande. Doit être un format e-mail
valide.
Code coupon/remise optionnel à appliquer à la commande. Doit faire entre 3 et
32 caractères si fourni.
### Retours
Retourne une Promise qui se résout en `ApiResponse` :
```typescript theme={null}
interface ApiResponse {
success: boolean; // Si la commande a été créée
message?: string; // Message d'erreur en cas d'échec
invalidFields?: Array<{
// Erreurs de validation éventuelles
fieldName: string;
reason: string;
}>;
data?: Order; // Détails de la commande si succès
}
```
Si `success` est `true`, le navigateur redirigera automatiquement vers la page
de paiement. La réponse est principalement utile pour la gestion des erreurs.
## Validation
La fonction de paiement effectue une validation avant de créer la commande :
**Validation du panier :**
* Le panier ne peut pas être vide
* Tous les articles doivent avoir des ID de produit et de variante valides
**Validation de l'e-mail :**
* Doit être un format d'adresse e-mail valide
**Validation du coupon (si fourni) :**
* Doit faire au moins 3 caractères
* Ne peut pas dépasser 32 caractères
## Exemple simple
```javascript theme={null}
// Gestionnaire du bouton de paiement
async function gererPaiement() {
const email = document.getElementById("email").value;
const coupon = document.getElementById("coupon").value;
try {
const response = await komerza.checkout(email, coupon);
// S'exécute uniquement si le paiement a échoué (pas de redirection)
if (!response.success) {
alert(response.message || "Le paiement a échoué");
}
} catch (error) {
console.error("Erreur de paiement :", error);
alert("Une erreur s'est produite lors du paiement");
}
}
```
## Exemple complet avec validation
```html theme={null}
Paiement
```
## Gestion des erreurs
Scénarios d'erreur courants et comment les gérer :
### Panier vide
```javascript theme={null}
const response = await komerza.checkout(email);
if (!response.success && response.message === "Basket is empty") {
alert(
"Veuillez ajouter des articles à votre panier avant de passer commande",
);
}
```
### Erreurs de validation
```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}`);
// Afficher l'erreur à côté du champ de formulaire concerné
});
}
```
### Erreurs générales
```javascript theme={null}
try {
await komerza.checkout(email, coupon);
} catch (error) {
// Erreur réseau ou autre exception
console.error("Échec du paiement :", error);
alert("Impossible de finaliser le paiement. Vérifiez votre connexion.");
}
```