Développeurs et API
MoneyTrans® expose une API REST-first pour les portefeuilles, transferts, bénéficiaires, payouts et webhooks. Construisez avec nous via la documentation ci-dessous.
Bases de l'API
REST + JSON
URLs prévisibles orientées ressources. Corps JSON en requête et réponse. Verbes HTTP et codes de statut standards.
Versioning
Routes versionnées (actuellement v1). Les changements incompatibles sont publiés sous une nouvelle version avec préavis de dépréciation.
Idempotence
Les endpoints de mutation acceptent un header Idempotency-Key pour que les retries ne ré-exécutent jamais.
Pagination
Pagination par curseur sur les endpoints de liste. Inclut les comptes totaux où pertinent.
Format d'erreur
Forme cohérente : { code, message, details } avec un catalogue documenté de codes d'erreur.
Temps et monnaie
Timestamps ISO-8601 UTC. Valeurs monétaires en unités mineures (entiers) plus une devise ISO-4217.
Authentification
Authentifiez chaque requête avec une clé API bearer. Les clés sont liées à un environnement (sandbox / production) et à des capacités spécifiques.
Bearer tokens
Authorization: Bearer mt_live_… ou mt_test_… sur chaque requête.
Scopes
Chaque clé porte un ensemble explicite de scopes (wallets:read, transfers:write, webhooks:manage, etc.).
Rotation
Les clés peuvent être rotées et révoquées depuis le tableau de bord. Trail d'audit de qui a créé / utilisé chaque clé.
Signatures de webhook
Chaque webhook est signé avec HMAC-SHA256. Vérifiez le header X-MT-Signature avant traitement.
curl https://moneytrans.com/api/v1/wallets \
-H "Authorization: Bearer mt_live_..." \
-H "Idempotency-Key: 8f1a2c…" \
-H "Content-Type: application/json"Environnements
Deux environnements isolés. Utilisez sandbox pour le développement, le staging et CI ; production pour le mouvement d'argent en direct.
| Environment | Base URL | Key prefix | Notes |
|---|---|---|---|
| Sandbox | sandbox.moneytrans.com | mt_test_… | Données synthétiques / de test, aucun mouvement réel d'argent. |
| Production | moneytrans.com | mt_live_… | Vrais clients, vrais fonds, vrais partenaires. |
Ressources principales
Les blocs de construction de l'API. Chaque ressource est documentée en détail dans la référence de l'API.
Wallets
Créez et gérez des portefeuilles multidevises par utilisateur, partenaire ou tenant. Soldes, holds et entrées de grand livre.
Transfers
Initiez des transferts wallet-to-wallet, ACH, RTP, push-to-card et internationaux. Statut, hooks et reversements.
Beneficiaries
Sauvegardez et réutilisez les détails du bénéficiaire (banque, carte, mobile money, handle de portefeuille). Pré-validés et filtrés.
Funding Sources
Comptes bancaires et cartes partenaires liés utilisés pour financer les transferts. Flux de vérification gérés par la plateforme.
Quotes & FX
Cotations indicatives avec taux verrouillés pour de courtes fenêtres. Fixez les taux par transfert ou par session.
Webhooks
Abonnez-vous aux événements : transfer.completed, transfer.held, kyc.updated, payout.failed, et plus.
Webhooks
Recevez des notifications d'événements en temps réel sur des endpoints HTTPS que vous contrôlez.
- Abonnements configurables par événement
- Signature HMAC-SHA256 sur chaque payload
- Retries automatiques avec backoff exponentiel en cas d'échec
- Outil de replay pour les événements manqués depuis le tableau de bord
- Catalogue d'événements documenté avec exemples de payloads
SDKs et outils
SDKs officiels en préparation pour les stacks les plus courants. L'API REST est entièrement utilisable aujourd'hui avec cURL ou tout client HTTP.
| SDK / Tool | Status | Notes |
|---|---|---|
| Python | Planifié | moneytrans — installable via pip, clients sync et async. |
| Postman | Disponible | Collection Postman publique reflétant la spec OpenAPI. |
| OpenAPI / Swagger | Disponible | Schéma machine-readable à /api/docs/schema/ pour codegen. |
Rate limits et quotas
- Rate limits par clé avec headers de réponse X-RateLimit-*
- Allowance de burst avec recharge type token-bucket
- Quotas séparés pour les endpoints de lecture, écriture et gestion de webhooks
- Quotas plus élevés disponibles sur demande pour les partenaires en production
Status et changelog
Restez informé sur la santé de la plateforme et ce qui est publié.
Page de statut
Disponibilité en direct et historique d'incidents pour sandbox et production.
Changelog
Liste curatée des ajouts à l'API, changements incompatibles et dépréciations avec dates effectives.
Prêt à construire ?
Parcourez la référence complète ou contactez-nous pour un accès sandbox et un kick-off d'intégration.