Documentation API az54

É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. **Une seule tentative**, timeout 30 s, aucune redirection suivie, aucun retry : une réponse autre que 2xx ou un délai dépassé perdent la notification définitivement.

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. Le corps ne porte pas la devise : c'est celle du pay-in d'origine, retrouvée par orderId.

orderId*string

Votre order_id, jamais l'identifiant technique az54 — c'est la clé de rapprochement.

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. Renseignée uniquement sur l'échec synchrone d'un pay-out ; absente d'un pay-in en échec, dont l'issue passe par un callback PSP.

Value in

"INSUFFICIENT_FUNDS"
"INVALID_RECIPIENT"
"LIMIT_EXCEEDED"
"PROVIDER_ERROR"
"TIMEOUT"
"CANCELLED_BY_USER"
"UNKNOWN"

failureReason?string

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

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 notification, qui entre dans la chaîne signée. az54 ne rejoue pas ses notifications, mais rien n'interdit à un tiers de le faire : ce champ 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