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
| Champ | Description |
|---|---|
| amount | Montant (unités mineures) |
| amount_with_fee | Montant incluant la commission |
| amount_dest | Montant de destination en cas de conversion (unités mineures), si applicable |
| currency | Devise |
| currency_dest | Devise de destination en cas de conversion, si applicable |
| description | Description |
| env | Environnement (prod / test) |
| error_description | Détail erreur si rejected |
| finished | Horodatage de fin (ISO) |
| id | UUID interne |
| route | Route de traitement utilisée |
| started | Horodatage de début (ISO) |
| status | Statut (voir la section « Statuts » du Glossaire ; created, charging, charged, refunded, rejected, failed) |
| txid | Identifiant externe client |
| type | Type (payment / payout) |
| widget_url | URL du widget si applicable |
| simple_auth_redirect_url | URL 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
txididempotents.