Aller au contenu principal

Récupérer le statut d'une transaction

Retourne l'état actuel d'une transaction via son id (API key).

Requête

GET /api/v1/transactions/{transaction_id}
Header: x-api-key: <api_key>

{transaction_id} est l'id interne (UUID) de la transaction, en segment de chemin.

Champs de réponse

ChampDescription
amountMontant (unités mineures)
amount_with_feeMontant incluant la commission
amount_destMontant de destination en cas de conversion (unités mineures), si applicable
currencyDevise
currency_destDevise de destination en cas de conversion, si applicable
descriptionDescription
envEnvironnement (prod / test)
error_descriptionDétail erreur si rejected
finishedHorodatage de fin (ISO)
idUUID interne
routeRoute de traitement utilisée
startedHorodatage de début (ISO)
statusStatut (voir la section « Statuts » du Glossaire ; created, charging, charged, refunded, rejected, failed)
txidIdentifiant externe client
typeType (payment / payout)
widget_urlURL du widget si applicable
simple_auth_redirect_urlURL d'authentification 3DS/additionnelle

Exemple

curl --location 'https://app.heth.me/api/v1/transactions/c033ceaa-3726-4479-8be3-c9af8a0b2336' \
--header 'x-api-key: VOTRE_CLE'

Notes

  • Backoff exponentiel conseillé pour le polling.
  • Absence de finished = en cours.
  • Utilisez des txid idempotents.