> ## 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 public

> Vérifier le statut d un paiement sans authentification

Vérifie le statut d'un paiement sans authentification.

<Note>
  Cet endpoint ne nécessite pas d'authentification. Utilisez-le pour les pages de confirmation côté client.
</Note>

<Warning>
  Pour des raisons de sécurité, cet endpoint retourne des informations limitées.
</Warning>

### 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/public/status/TX000007272
```

### Réponse

```json theme={null}
{
  "transactionId": "TX000007272",
  "status": "success",
  "amount": 10000,
  "currency": "XOF"
}
```

### 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é                 |

### Utilisation côté client

```javascript theme={null}
// Vérification du statut après retour sur le site
async function checkPaymentStatus(transactionId) {
  const response = await fetch(
    `https://sandbox-api.caurisflux.com/api/v1/payments/public/status/${transactionId}`
  );
  const data = await response.json();

  if (data.status === 'success') {
    // Afficher message de succès
    showSuccessMessage();
  } else if (data.status === 'pending') {
    // Paiement toujours en cours
    showPendingMessage();
  } else {
    // Paiement échoué ou annulé
    showErrorMessage();
  }
}
```

<Info>
  Pour obtenir tous les détails d'un paiement (provider, metadata...), utilisez l'endpoint authentifié `GET /payments/status/:transactionId`.
</Info>