API vs CHECKOUTPAGE

ClaPay prend en charge deux principales façons de traiter les paiements :

• Tunnel : API (serveur à serveur)
• Tunnel : CHECKOUTPAGE (flux de redirection/checkout)

Ce guide explique la différence entre ces deux modes et comment utiliser le mode API dans vos intégrations.

🔁 Mode Tunnel API

Le tunnel API permet de traiter directement les paiements depuis votre backend. Ce mode est idéal pour les plateformes qui souhaitent gérer l'expérience de paiement de manière programmatique.

✅ Cas d'Utilisation

• MERCHANT (Dépôt)
• CASHIN (Retrait)
• Idéal pour les applications avec des flux de paiement intégrés.

🧾 Paramètres du Corps de la Requête à Ajouter au Payload Classique

Champ	Obligatoire	Description
operator_otp	Oui	OTP si requis par l'opérateur
tunnel	Oui	Doit être défini sur "API"

note

Certains opérateurs exigent un OTP à l'avance, d'autres non.

🧪 Exemple de Requête

{
  ...
  "tunnel": "API"
}

🔁 Mode Tunnel CHECKOUTPAGE

Le mode CHECKOUTPAGE vous permet de rediriger vos utilisateurs vers une page sécurisée hébergée par ClaPay où ils peuvent effectuer leurs paiements facilement et en toute sécurité.

C'est la méthode la plus rapide pour intégrer des paiements sans gérer de composants d'interface utilisateur ou de conformité vous-même.

✅ Pourquoi Utiliser la CHECKOUTPAGE ?

• Aucun développement front-end requis.
• Environnement sécurisé pour les utilisateurs.
• Expérience adaptée aux mobiles.
• Idéal pour les MVPs ou les sites nécessitant une configuration rapide des paiements.

🔧 Comment Cela Fonctionne

1. Envoyez une requête au point de terminaison d'initialisation de paiement de ClaPay.
2. Définissez "tunnel": "CHECKOUTPAGE" dans votre payload.
3. Recevez un payment_url dans la réponse.
4. Redirigez votre client vers cette URL.
5. ClaPay gère le reste : saisie du paiement, confirmation, redirection.

📤 Exemple de Requête

{
  ...
  "tunnel": "CHECKOUTPAGE"
}

📊 Résumé : Mode API vs CHECKOUTPAGE

ClaPay propose deux moyens puissants pour traiter les paiements. Voici un tableau comparatif pour vous aider à choisir celui qui convient le mieux à vos besoins.

Fonctionnalité	Tunnel ("API")	Tunnel ("CHECKOUTPAGE")
Contrôle de l'UI	Contrôle total (votre propre formulaire de paiement)	Aucun contrôle (hébergé par ClaPay)
Facilité d'Intégration	Nécessite une logique backend	Intégration rapide
Gestion de la Sécurité	Gérée par vous	Gérée par ClaPay
Redirection Requise	❌ Non	✅ Oui
Expérience Personnalisée	✅ Hautement personnalisable	❌ Non personnalisable
Idéal pour	Applications, plateformes avec UI de paiement existante	Sites web, MVPs, configurations low-code
Exemples de Cas d'Utilisation	Applications mobiles, flux backend	Sites e-commerce simples, pages de dons

✅ Utilisez le Tunnel API si vous avez besoin d'un contrôle total sur la gestion des paiements dans votre application.

✅ Utilisez la CHECKOUTPAGE si vous souhaitez simplicité, sécurité hébergée et configuration rapide.

note

Vous pouvez prendre en charge les deux modes en parallèle pour répondre à différents flux utilisateur.

Cette page vous a-t-elle été utile ?