Une API de paiement unique pour Haïti

Tranzak (tranzak.co) est une passerelle de paiement offrant une API REST unique pour accepter MonCash, NatCash, les cartes bancaires et, sur approbation, les crypto-actifs en Haïti. Les marchands et les développeurs créent un paiement par un appel HTTP, et Tranzak le confirme par un webhook signé.

Moyens de paiement pris en charge

Un montant demandé en USD pour MonCash ou NatCash est converti en gourdes au taux Tranzak, et le paiement est créé en HTG. Aucun abonnement ni frais d'installation : détail sur la page Tarifs.

Comment intégrer l'API

1. Créez un compte et générez une clé de test tk_test_… depuis votre tableau de bord. Le mode test n'utilise aucun argent réel.
2. Créez un paiement avec POST /api/gateway/v1/payments, authentifié par l'en-tête X-Api-Key.
3. Redirigez le client vers le payment_url renvoyé dans la réponse (MonCash et NatCash).
4. Confirmez le paiement côté serveur : par le webhook signé, ou en lisant GET /payments/{transaction_id} jusqu'au statut completed. Une redirection du navigateur n'est jamais une preuve de paiement.
5. Passez en production avec une clé tk_live_….

curl -X POST https://tranzak.co/api/gateway/v1/payments \
  -H "X-Api-Key: $TRANZAK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "currency": "HTG",
    "payment_method": "moncash",
    "customer_name": "Jean Baptiste",
    "reference": "commande-1042"
  }'

const res = await fetch('https://tranzak.co/api/gateway/v1/payments', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.TRANZAK_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amount: 500,
    currency: 'HTG',
    payment_method: 'natcash',
    customer_name: 'Jean Baptiste',
    reference: 'commande-1042',
  }),
});
const payment = await res.json();

L'API est du HTTP et du JSON classiques : elle fonctionne avec n'importe quel langage (PHP, Laravel, Node.js, Python, etc.). Tranzak ne publie pas de SDK : on appelle directement l'API.

Ressources pour les développeurs et les IA

• Contrat OpenAPI 3.1 : endpoints, schémas et événement webhook.
• Collection Postman à importer pour tester l'API.
• Guide d'intégration pour les agents de programmation IA, et llms.txt.
• API MonCash, API NatCash, exemples en Laravel, Node.js, Python et PHP et choisir une passerelle de paiement.
• Guide : l'API MonCash et paiements par carte en Haïti.
• Plugin WooCommerce pour accepter MonCash, NatCash et cartes sans écrire de code.

Questions fréquentes