C'est très facile d'intégrer Zopayo ! Retrouvez ci-dessous la référence complète de l'API REST, les spécifications des requêtes POST, la gestion stricte du délai d'expiration de 30 minutes et le traitement automatisé des Webhooks.
Pour pouvoir générer des liens de paiement et encaisser des fonds réels, assurez-vous de respecter les étapes préalables suivantes sur votre espace marchand :
Votre compte doit être CONFIRMÉ sur client.zopayo.com pour autoriser les flux financiers.
Renseignez toutes les informations de votre profil entreprise et vos coordonnées de contact officiel.
Récupérez votre clé API secrète dans votre menu Clés API / SDK. Ne la divulguez jamais côté client.
Renseignez votre URL sécurisée (HTTPS) de notification automatique dans votre tableau de bord.
L'initialisation d'un paiement se fait via une requête de serveur à serveur au format JSON (POST). Notre API vous renverra une URL de paiement sécurisée vers laquelle vous devrez rediriger votre client.
Chaque lien de paiement généré possède une durée de vie stricte de 30 minutes. Une fois ce délai dépassé, le lien expire définitivement et le client ne pourra plus finaliser son paiement.
| Paramètre | Type | Requis | Description & Contraintes |
|---|---|---|---|
| cle_prive | String | OUI | Votre clé API privée d'authentification secrète. |
| params_montant | String | OUI | 'true' : le client saisit le montant sur la page. 'false' : le montant est fixe. |
| montant | String | COND. | Montant à payer (ex: "50000.00"). *Obligatoire et > 0 si params_montant vaut 'false'. |
| devise | String | OUI | Code de la devise (ex : "MGA", "EUR", "USD", "CHF"). *Obligatoire. |
| id_relation | String | NON | Votre référence interne (ex: ID Commande). Max : 100 caractères. |
| raison | String | NON | Motif du paiement affiché au client. Max : 100 caractères. |
| url_emi | String (URL) | OUI | URL de redirection vers votre site après un SUCCÈS. Doit commencer obligatoirement par https://. |
| url_error_emi | String (URL) | OUI | URL de redirection vers votre site en cas d'ÉCHEC / ANNULATION. Doit commencer obligatoirement par https://. |
{
"success": true,
"message": "Lien de paiement généré avec succès.",
"payment_url": "https://request.zopayo.com/?token=..."
}{
"success": false,
"message": "Erreur : La clé privée est invalide."
}Rejoignez les commerçants qui font confiance à Zopayo pour stabiliser leurs encaissements en ligne.
Recevez en avant-première nos mises à jour d'API, les nouveaux opérateurs partenaires intégrés, et nos guides d'optimisation pour booster vos encaissements à Madagascar.
Zéro spam. Uniquement des annonces de versions majeures, des notes de mise à jour d'API et des correctifs de sécurité pour les développeurs et marchands.