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?id={transaction_id}
Header: x-api-key: <api_key>
Paramètre requis: id.
Champs de réponse
| Champ | Description |
|---|---|
| amount | Montant (unités mineures) |
| amount_with_fee | Montant incluant la commission |
| currency | Devise |
| description | Description |
| env | Environnement (prod / test) |
| error_description | Détail erreur si rejected |
| finished | Horodatage de fin (ISO) |
| id | UUID interne |
| started | Horodatage de début (ISO) |
| status | Statut (created, charging, charged, rejected) |
| 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?id=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.