Pour les développeurs

Intégrer le paiement mobile en Haïti

Intégrer un paiement mobile fiable demande plus qu'un appel d'API : il faut gérer la confirmation, les doublons et les cas où le client ne revient jamais sur votre site. Voici la démarche avec Tranzak.

La démarche en six étapes

  • Créer un compte, puis un site dans la section Développeur : adresse du webhook (HTTPS publique) et adresse de retour.
  • Développer avec une clé de test tk_test_ : aucun argent réel, et un flux d'événements de test pour travailler sans webhook public.
  • Créer le paiement par POST /api/gateway/v1/payments, puis rediriger le client vers payment_url.
  • Confirmer côté serveur : webhook signé (HMAC-SHA256) et, en filet de sécurité, lecture du statut du paiement jusqu'à un état final.
  • Rendre le « marquer la commande payée » idempotent : un paiement ne doit produire ses effets qu'une seule fois.
  • Passer en production en remplaçant la clé de test par une clé tk_live_.

Les pièges à éviter

  • Se fier au retour du navigateur : le client peut fermer l'onglet, ou falsifier l'URL de retour.
  • Supposer qu'un paiement NatCash a échoué si le client ne revient pas : la confirmation peut arriver quelques minutes plus tard.
  • Ne pas gérer la réception en double d'un même webhook.
  • Exposer la clé API dans le navigateur ou dans le code source public.

Outils fournis

Un contrat OpenAPI 3.1, une collection Postman et un guide pensé pour les agents de programmation IA sont publics. Il n'y a pas de SDK : l'API est du HTTP et du JSON.

Questions fréquentes

Comment intégrer un paiement mobile dans mon application ?

Appelez l'API Tranzak pour créer le paiement, redirigez le client vers payment_url, puis confirmez le résultat par webhook signé ou lecture du statut.

Peut-on développer sans argent réel ?

Oui. Une clé de test simule les paiements, et un flux d'événements de test évite d'avoir à exposer un webhook public.

Quels langages sont pris en charge ?

Tous : l'API est du HTTP et du JSON. La page d'intégration donne des exemples en Laravel, Node.js, Python et PHP.

Quels moyens de paiement sont couverts ?

MonCash et NatCash en gourdes, et les cartes Visa et Mastercard.

À lire aussi

Commencez avec une clé de test gratuite

Créez votre compte et testez votre première intégration sans argent réel.

Créer un compte