Skip to main content
GET
https://sandbox-api.caurisflux.com/api/v1
/
payments
/
status
/
{transactionId}
Statut du paiement
curl --request GET \
  --url https://sandbox-api.caurisflux.com/api/v1/payments/status/{transactionId} \
  --header 'X-API-Key: <api-key>'
Vérifie le statut actuel d’un paiement.

​
Authentification

X-API-Key: pk_test_xxx:sk_test_xxx

​
Paramètres de chemin

ParamètreTypeDescription
transactionIdstringID de transaction retourné lors de l’initiation

​
Requête

curl https://sandbox-api.caurisflux.com/api/v1/payments/status/TX000007272 \
  -H "X-API-Key: pk_test_xxx:sk_test_xxx"

​
Réponse - Paiement complété

{
  "transactionId": "TX000007272",
  "merchantReference": "COMMANDE-12345",
  "type": "collect",
  "status": "success",
  "amount": 10000,
  "currency": "XOF",
  "provider": "wave",
  "customerPhone": "+221771234567",
  "customerName": "Amadou Diallo",
  "customerEmail": "amadou@example.com",
  "message": "Paiement effectué avec succès",
  "errorCode": null,
  "errorMessage": null,
  "expiresAt": null,
  "completedAt": "2024-01-15T12:05:30.000Z",
  "createdAt": "2024-01-15T12:00:00.000Z",
  "updatedAt": "2024-01-15T12:05:30.000Z",
  "metadata": {
    "orderId": "12345",
    "description": "Achat sur MaBoutique.sn"
  }
}

​
Réponse - Paiement en attente

{
  "transactionId": "TX000007272",
  "merchantReference": "COMMANDE-12345",
  "type": "collect",
  "status": "pending",
  "amount": 10000,
  "currency": "XOF",
  "provider": "wave",
  "customerPhone": "+221771234567",
  "customerName": "Amadou Diallo",
  "customerEmail": null,
  "message": "Paiement en attente",
  "errorCode": null,
  "errorMessage": null,
  "expiresAt": "2024-01-15T12:30:00.000Z",
  "completedAt": null,
  "createdAt": "2024-01-15T12:00:00.000Z",
  "updatedAt": "2024-01-15T12:00:00.000Z",
  "metadata": null
}

​
Réponse - Paiement échoué

{
  "transactionId": "TX000007272",
  "merchantReference": "COMMANDE-12345",
  "type": "collect",
  "status": "failed",
  "amount": 10000,
  "currency": "XOF",
  "provider": "wave",
  "customerPhone": "+221771234567",
  "customerName": "Amadou Diallo",
  "customerEmail": "amadou@example.com",
  "message": "Paiement échoué",
  "errorCode": "insufficient_funds",
  "errorMessage": "Solde insuffisant sur le compte Wave",
  "expiresAt": null,
  "completedAt": null,
  "createdAt": "2024-01-15T12:00:00.000Z",
  "updatedAt": "2024-01-15T12:02:00.000Z",
  "metadata": {
    "orderId": "12345",
    "description": "Achat sur MaBoutique.sn"
  }
}

​
Statuts possibles

StatutDescription
pendingEn attente de paiement
processingPaiement en cours de traitement
successPaiement réussi
failedPaiement échoué
cancelledPaiement annulé
expiredPaiement expiré
refundedPaiement remboursé

​
Codes d’erreur

CodeDescription
insufficient_fundsSolde insuffisant
user_cancelledAnnulé par l’utilisateur
timeoutDélai expiré
provider_errorErreur du provider
invalid_phoneNuméro invalide