> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caurisflux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Statut du paiement

> Vérifier le statut d un paiement

Vérifie le statut actuel d'un paiement.

### Authentification

```bash theme={null}
X-API-Key: pk_test_xxx:sk_test_xxx
```

### Paramètres de chemin

| Paramètre       | Type   | Description                                     |
| --------------- | ------ | ----------------------------------------------- |
| `transactionId` | string | ID de transaction retourné lors de l'initiation |

### Requête

```bash theme={null}
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é

```json theme={null}
{
  "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

```json theme={null}
{
  "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é

```json theme={null}
{
  "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

| Statut       | Description                     |
| ------------ | ------------------------------- |
| `pending`    | En attente de paiement          |
| `processing` | Paiement en cours de traitement |
| `success`    | Paiement réussi                 |
| `failed`     | Paiement échoué                 |
| `cancelled`  | Paiement annulé                 |
| `expired`    | Paiement expiré                 |
| `refunded`   | Paiement remboursé              |

### Codes d'erreur

| Code                 | Description              |
| -------------------- | ------------------------ |
| `insufficient_funds` | Solde insuffisant        |
| `user_cancelled`     | Annulé par l'utilisateur |
| `timeout`            | Délai expiré             |
| `provider_error`     | Erreur du provider       |
| `invalid_phone`      | Numéro invalide          |