Intégrez une fois, encaissez partout.
Une API pour créer un paiement, suivre son état et rembourser. Les modules e-commerce ne sont que des adaptateurs par-dessus.
Créer un paiement
POST https://pay.mowibo.com/api/v1/pay/v1/paiements
Authorization: Bearer sk_live_...
Idempotency-Key: commande-4587
Content-Type: application/json
{
"montant": 250000,
"motif": "Commande #4587",
"source": "api",
"url_retour": "https://ma-boutique.com/merci"
}La réponse contient url_checkout : redirigez-y votre client.
Idempotency-Key garantit qu'un appel rejoué rend le même paiement au lieu d'en créer un second.
Être prévenu du paiement
Nous appelons votre URL en HTTPS, avec une signature. C'est ce message qui fait foi, pas le retour du navigateur : un client qui ferme son onglet doit quand même recevoir sa commande.
Mowibo-Signature: t=1787610000,v1=<hmac-sha256>
Mowibo-Evenement: paiement.reussi
{ "type": "paiement.reussi", "donnees": { "code": "2481930375", ... } }Signez timestamp + "." + corps avec votre secret et comparez.
Refusez ce qui a plus de cinq minutes : sans cela, un message capté une fois pourrait être rejoué.
Deux environnements
Les clés sk_test_ et sk_live_ sont distinctes.
Un développeur qui n'a pas d'environnement de test intègre avec de l'argent réel — nous préférons vous
éviter ça. Le préfixe est lisible à l'œil nu, pour qu'une clé de production collée dans un dépôt public
se remarque tout de suite.