Projets d'exemple
Du code fonctionnel que vous pouvez exécuter dès maintenant et l'emplacement réel de chaque élément.
Vous trouverez du code Wajub exécutable à trois endroits, chacun répondant à des besoins différents. Le Cookbook présente une fonctionnalité complète dans un vrai framework, la CLI génère la structure d'un récepteur de webhook sur votre disque et chaque dépôt de SDK contient un script minimal qui confirme le bon fonctionnement de l'installation.
Fonctionnalités complètes dans un framework
Les recettes du Cookbook sont des guides complets. Chacune présente une intégration fonctionnelle de bout en bout, avec l'appel serveur, la partie navigateur ou application et le webhook de confirmation.
Cookbook
- Checkout avec Next.js App RouterApp Router, une route serveur et le checkout intégré.
- Handler de webhook avec ExpressCorps brut, vérification de signature et livraison idempotente de la commande.
- Facturation récurrente avec LaravelFactures, cycles et événements associés.
- Marketplace avec DjangoComptes connectés, paiements fractionnés et payouts aux vendeurs.
- Mobile Money avec React NativeL'interface native, du jeton à la confirmation.
- Toutes les recettesLa liste complète, enrichie au fil du temps.
Générer la structure d'un récepteur de webhook
La CLI crée un récepteur fonctionnel dans le dossier de votre choix. Il ne dépend que de Node et vérifie la signature de la même manière que les SDKs. Vous pouvez donc aussi bien étudier son code que l'exécuter.
wajub samples webhooks my-receiver
node my-receiver/server.mjs
# in a second terminal
wajub listen --forward-to localhost:3000/webhooks
wajub trigger payment.succeededwajub samples --list affiche les exemples disponibles. Pour le moment, seul le récepteur de webhook
est proposé. Les prochains exemples apparaîtront dans cette liste.
L'appel minimal dans chaque langage
Deux dépôts de SDK contiennent un dossier examples/ avec un script. Celui-ci crée un paiement et
affiche l'URL. Cela suffit pour vérifier votre clé, votre réseau et votre installation.
| Langage | Fichier | Commande d'exécution |
|---|---|---|
| Go | examples/create_payment/main.go | go run ./examples/create_payment |
| Python | examples/create_payment.py | python examples/create_payment.py |
Chaque script lit WAJUB_API_KEY dans l'environnement. Exportez d'abord une clé de sandbox afin que
le paiement créé soit sans conséquence.
Tous les dépôts de SDK sont publics et consultables
Aucune application d'exemple n'est hébergée séparément. Les dépôts des SDKs constituent eux-mêmes l'implémentation de référence. Leurs tests fournissent souvent la documentation la plus claire sur un cas particulier. Ils sont tous disponibles sur github.com/wajubhq.
Créer votre propre point de départ
Si vous configurez un projet plutôt que d'en étudier un, le parcours le plus direct compte trois étapes.
| Étape | Page |
|---|---|
| Faire fonctionner un appel d'API | Démarrage rapide des SDKs |
| Choisir comment le payeur paie | Choisir une intégration |
| Recevoir la confirmation | Recevoir un webhook |
Gardez Konsole ouverte pendant l'opération. Elle affiche chaque requête et chaque livraison de webhook en temps réel. Pour la plupart des débogages, il suffit alors de lire au lieu de deviner.
Pages associées
- Démarrage rapide des SDKsLe premier appel dans cinq langages présentés côte à côte.
- CLILes commandes listen, trigger, samples et les commandes API.
- Scénarios de testLes cartes et numéros qui produisent chaque résultat.
- Mode testCe qui est simulé et ce qui ne l'est pas.
- Choisir votre SDKLes versions minimales des environnements d'exécution et les contraintes qui excluent une option.
- CookbookToutes les recettes, classées par framework et cas d'utilisation.