API NatCash

API NatCash pour Haïti

Avec l'API Tranzak, vous acceptez les paiements NatCash par le même appel que MonCash : seul le payment_method change. Tranzak gère la confirmation, y compris lorsque NatCash n'envoie pas de notification instantanée.

Ce qui est particulier avec NatCash

  • Paiement en gourdes (HTG), minimum 20 HTG par paiement.
  • NatCash n'envoie pas de notification instantanée : si le client paie puis ferme l'onglet, Tranzak interroge NatCash toutes les 2 minutes puis déclenche votre webhook.
  • Ne considérez donc jamais un paiement NatCash comme échoué parce que le client n'est pas revenu sur votre site : attendez le statut final.
  • Un paiement resté en traitement plus de 15 minutes est marqué échoué, sauf s'il a été payé entre-temps.

Tarifs

NatCash est facturé 4,5 % par transaction, sans frais d'installation ni abonnement mensuel.

Le même flux que MonCash

Création du paiement, redirection vers payment_url, retour du client, puis confirmation par webhook signé ou lecture du statut. Si vous avez déjà intégré MonCash, NatCash n'ajoute qu'une valeur de payment_method.

Exemples de code

Créer un paiement NatCash (Node.js)
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: 250,
    currency: 'HTG',
    payment_method: 'natcash',
    customer_name: 'Marie Joseph',
    reference: 'commande-2087',
  }),
});
const payment = await res.json();
// Redirigez le client vers payment.payment_url

Questions fréquentes

Existe-t-il une API NatCash pour les développeurs ?

Oui : l'API Tranzak accepte payment_method = natcash. C'est la même API que pour MonCash et les cartes.

Quel est le montant minimum avec NatCash ?

20 HTG par paiement.

Et si le client ferme la page après avoir payé ?

Tranzak vérifie NatCash toutes les 2 minutes et déclenche votre webhook une fois le paiement confirmé.

Quels sont les frais ?

4,5 % par transaction, sans frais d'installation ni abonnement mensuel.

NatCash et MonCash peuvent-ils être proposés ensemble ?

Oui, avec la même intégration : vous laissez le client choisir et vous passez moncash ou natcash dans payment_method.

À 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