Documentation
Introduction
WanePay est une infrastructure de paiement : vous integrez une seule API, et WanePay se charge d’acheminer chaque transaction vers le bon reseau de paiement.
Le modele
Une requete WanePay traverse toujours la meme chaine. Le moteur valide, choisit une connexion, cree une tentative, normalise le resultat, ecrit au ledger puis notifie votre serveur.
POST /v1/payments
|
v
Authentication -> Rate limit -> Validation -> Idempotency
|
v
Payment Engine -> Routing -> Payment Connection -> Reseau de paiement
|
v
Normalisation -> Ledger -> WebhookCe que vous obtenez
- Une API REST versionnee sous
/v1, en JSON, avec des erreurs normalisees. - Zéro configuration pour vos marchands : Fonctionnement en mode Master Aggregator. Vos clients finaux n'ont pas besoin de configurer de comptes chez des opérateurs tiers. WanePay encaisse sur le compte maitre, répartit dans le ledger, et gere les retraits.
- Des statuts identiques quel que soit le moyen de paiement :
pending,processing,succeeded,failed,cancelled,expired,refunded,partially_refunded. - L’idempotence native via l’en-tete
Idempotency-Key. - Des webhooks signes cryptographiquement (HMAC-SHA256, SHA512), rejoues automatiquement en cas d’echec.
- Un ledger en partie double, immuable, consultable ecriture par ecriture.
- Deux environnements totalement etanches : sandbox et production.
URL de base
# Production
https://api.wanepay.com/v1
# En developpement local
http://localhost:3000/api/v1L’environnement (sandbox ou production) n’est pas determine par l’URL mais par la cle API utilisee : sk_test_… ou sk_live_….
Etat des connexions
Connexions sandbox simulees
Les connexions livrees avec cette version (sandbox_tmoney, sandbox_flooz, sandbox_card) sont entierement simulees. Elles ne communiquent avec aucun operateur, aucune banque et aucun reseau carte. Elles existent pour developper et tester votre integration. Une integration reelle ne pourra etre activee qu’apres obtention des acces officiels, contrats et autorisations reglementaires necessaires.