az54 API docs

Émise à chaque changement de statut, et à la mise à disposition d'une `authorizationUrl` pour les corridors `redirect_url`. Postée en `application/json` sur le `webhookUrl` de la transaction. Timeout 30 s par tentative, aucune redirection suivie, et **jusqu'à 6 tentatives** (immédiate, +30 s, +2 min, +10 min, +1 h, +6 h) tant que la réponse n'est pas 2xx. Chaque tentative est journalisée dans `notifications[]` sur `GET /v1/transactions/by-id/{transactionId}`, et une notification peut être renvoyée à la demande — cf. [réconciliation](/docs/reconciliation).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

phoneNumber*string

amount*number

Montant de la transaction en unité majeure de sa devise, donnée par currencyCode.

currencyCode*string

Devise d'amount, en ISO 4217 (XOF, XAF, CDF, USDC). Celle du corridor de la transaction.

orderId*string

Votre order_id, la clé de rapprochement côté marchand.

transactionId*string

Identifiant technique az54, celui que prend GET /v1/transactions/by-id/{transactionId} — pas la référence du PSP.

status*string

Statut au moment de l'émission, non terminal dans le cas général : une transaction émet plusieurs notifications. pending_approval n'est jamais émis vers une intégration par clé d'API.

Value in

"created"
"pending_approval"
"initiated"
"pending"
"processing"
"completed"
"failed"
"cancelled"

nextAction?

failureCategory?string

Cause normalisée de l'échec, l'une des 8 valeurs du catalogue. Renseignée sur toute notification dont le status est terminal en échec (failed ou cancelled), pay-in comme pay-out.

Value in

"INSUFFICIENT_FUNDS"
"INVALID_RECIPIENT"
"LIMIT_EXCEEDED"
"PROVIDER_ERROR"
"TIMEOUT"
"CANCELLED_BY_USER"
"UNKNOWN"
"PROVIDER_UNAVAILABLE"
"PROVIDER_NOT_AUTHORIZED"
"PROVIDER_INSUFFICIENT_LIQUIDITY"

failureReason?string

Détail brut du PSP, non contractuel. Mêmes conditions de présence que failureCategory.

failureCode?string

Code d'échec brut du PSP, isolé du message que failureReason porte fusionné. Non contractuel : chaque PSP a son propre référentiel. Absent quand le PSP n'a renvoyé qu'un message, et sur les transactions antérieures au 2026-08-28.

signature*string

HMAC-SHA512 hexadécimal minuscule de la concaténation clé₁valeur₁clé₂valeur₂… de tous les autres champs, dans leur ordre d'apparition dans le corps, avec votre secret whsec_….

_nonce*string

Aléa par tentative, qui entre dans la chaîne signée : deux tentatives de la même notification ne portent pas le même _nonce, il ne peut donc pas servir de clé de déduplication. Il n'est vérifié nulle part côté az54 et n'est pas une protection anti-rejeu.

_timestamp*number

Horodatage d'émission, en millisecondes depuis l'epoch. Entre dans la chaîne signée.

Response Body

Example Requests

POST/transaction-notification

Notification de transaction

Request Body

Response Body

200

Request Bodyapplication/json