az54
Ouvrir le tableau de bord
API docsAPI ReferenceDashboard docs

Consulter une transaction par son identifiant

Rattrapage recommandé après une notification manquée : contrairement au reçu public (`GET /v1/transactions/{orderId}`), scopé à votre organisation et porte le détail complet (frais, `netAmount`, cause d'échec, journal des notifications webhook). Un `id` d'une autre organisation rend `404`, au même titre qu'un `id` inexistant.

GET
/v1/transactions/by-id/{transactionId}

Authorization

AuthorizationBearer <token>

Clé d'API de l'organisation, envoyée en Authorization: Bearer sk_live_… (sk_test_… sur le serveur Sandbox). Il n'existe aucun header X-API-Key.

In: header

Path Parameters

transactionId*string

Identifiant technique az54 de la transaction (champ id, pas votre order_id). Renvoyé par POST /v1/pay-in, POST /v1/pay-out et cette même liste.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/transactions/by-id/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "success": true,  "data": {    "id": "string",    "orderId": "string",    "amount": 0,    "fee": 0,    "netAmount": 0,    "phoneNumber": "string",    "currencyCode": "string",    "countryCode": "string",    "status": "string",    "type": "string",    "operatorName": "string",    "description": "string",    "payerName": "string",    "failureCategory": "INSUFFICIENT_FUNDS",    "failureReason": "string",    "failureCode": "string",    "failedAt": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "notifications": [      {        "attemptNo": 0,        "url": "string",        "httpStatus": 0,        "errorKind": "SKIPPED_NO_URL",        "errorDetail": "string",        "durationMs": 0,        "createdAt": "2019-08-24T14:15:22Z"      }    ]  }}

Lister vos transactions GET

Pay-in et pay-out confondus, triés par `createdAt` décroissant. Le filtre `orderId` sert de rattrapage quand une notification a été manquée.

Renvoyer la notification webhook d'une transaction POST

Rattrapage en libre-service après épuisement de l'échelle de retries automatique (jusqu'à 6 tentatives, cf. [réconciliation](/docs/reconciliation)) : programme une nouvelle notification — avec sa propre chaîne de tentatives, ce n'est pas un envoi synchrone — consultable ensuite dans `notifications[]` sur `GET /v1/transactions/by-id/{transactionId}`. Refusé tant que la transaction n'est pas dans un état terminal (`completed`, `failed`, `cancelled`). Plafonné à 3 requêtes par minute et par transaction.