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
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