Conventions de champs & Glossaire

Montant & Devise

Terme	Définition
amount	Entier en unités mineures
amount_with_fee	Montant incluant la commission
currency	Code devise / token (USDT)

Identifiants

Terme	Définition
id	UUID interne de transaction
txid	Identifiant externe idempotent

Routage & Environnement

Terme	Définition
route	Alias de traitement configuré
env	Environnement: prod (défaut) ou test

Statuts

Statut	Signification
created	Acceptée, en attente
charging	En cours
charged	Terminée avec succès
rejected	Échec définitif

Temps

Champ	Signification
started	Horodatage de début (ISO)
finished	Horodatage de fin (ISO)

money_storage

Champ	Signification
network	Réseau blockchain
type	Type d'instrument
wallet_id	Identifiant de wallet
cardnumber	Numéro de carte virtuelle
cvv	CVV virtuel
exp_month / exp_year	Expiration
cardholder	Titulaire

Erreurs

Champ	Signification
error_description	Message d'erreur (non stable)

Idempotence

Renvoyer uniquement avec le même txid pour une opération identique.

Polling

Délais: 1s → 2s → 4s → 8s jusqu'à charged / rejected.

Webhook

Informative uniquement — confirmer par GET.