Tranzak API

L'API Tranzak : ressources pour développeurs

Cette page rassemble ce qu'il faut pour travailler avec l'API Tranzak : le principe d'authentification, les endpoints principaux et les fichiers à importer dans vos outils.

Les bases

  • URL de base : https://tranzak.co/api/gateway/v1.
  • Authentification : en-tête X-Api-Key (clé tk_test_ pour le test, tk_live_ pour la production), à garder côté serveur.
  • Format : HTTP et JSON. Les montants des transactions sont renvoyés sous forme de chaînes de caractères.

Endpoints principaux

  • POST /payments : créer un paiement (moncash, natcash ou card).
  • GET /payments/{transaction_id} : lire un paiement.
  • POST /payments/{transaction_id}/verify : demander au fournisseur le dernier statut.
  • GET /payments/reference/{reference} : retrouver un paiement par votre propre référence.
  • GET /exchange-rate : taux HTG/USD utilisé pour les cartes.
  • GET /events : flux d'événements de test (clés de test uniquement).

Webhooks

Tranzak envoie un événement payment.success ou payment.failed à l'adresse de votre site, avec l'en-tête X-Tranzak-Signature : le HMAC-SHA256 hexadécimal du corps brut, calculé avec votre secret. Vérifiez-le avant de traiter l'événement.

Fichiers et guides

  • Contrat OpenAPI 3.1 : /openapi.json
  • Collection Postman : /downloads/tranzak-gateway.postman_collection.json
  • Guide pour agents IA : /ai, et résumé lisible par les IA : /llms.txt

Questions fréquentes

Où est la documentation de l'API Tranzak ?

Dans le contrat OpenAPI (/openapi.json), le guide d'intégration (/ai) et la documentation du tableau de bord développeur.

Comment s'authentifier ?

Avec l'en-tête X-Api-Key contenant votre clé, de test (tk_test_) ou de production (tk_live_).

Comment vérifier un webhook ?

Comparez l'en-tête X-Tranzak-Signature avec le HMAC-SHA256 du corps brut de la requête, calculé avec votre secret, par une comparaison à temps constant.

Y a-t-il un SDK ?

Non : l'API est du HTTP et du JSON, avec des exemples de code en Laravel, Node.js, Python et PHP.

À 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