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

# Transactions

> Récupérez, surveillez et gérez toute l'activité on-chain sur vos portefeuilles

<Note>
  En bref<br />
  Chaque dépôt, retrait, échange ou balayage qui transite par Blockradar crée un enregistrement de transaction. L'API Transactions est votre journal d'activité — utilisez-la pour consulter l'historique, enquêter sur des paiements spécifiques, rejouer des webhooks manqués, annuler des transactions en attente ou réessayer celles qui ont échoué.
</Note>

## Prérequis

<Steps>
  <Step title="Clé API">
    Obtenez votre clé API depuis le [Tableau de bord Blockradar](https://dashboard.blockradar.co).
  </Step>

  <Step title="Portefeuille Créé">
    Vous aurez besoin d'un `walletId` pour interroger les transactions.
  </Step>
</Steps>

## Comment Ça Fonctionne

Lorsqu'un événement on-chain se produit sur un portefeuille Blockradar, Blockradar crée un enregistrement de transaction et envoie un webhook. L'API Transactions vous donne un accès programmatique à tous ces enregistrements.

<CardGroup cols={2}>
  <Card title="Consulter l'historique" icon="clock-rotate-left">
    Récupérez toutes les transactions d'un portefeuille ou filtrez par adresse, actif, statut ou plage de dates.
  </Card>

  <Card title="Enquêter sur les paiements" icon="magnifying-glass">
    Recherchez une transaction spécifique par ID pour vérifier son statut, son hash et ses métadonnées.
  </Card>

  <Card title="Rejouer les webhooks" icon="rotate">
    Renvoyez un webhook pour une transaction que votre système a manquée ou échoué à traiter.
  </Card>

  <Card title="Annuler ou réessayer" icon="arrow-rotate-left">
    Annulez une transaction en attente bloquée ou réessayez une transaction échouée.
  </Card>
</CardGroup>

## États des Transactions

| Statut      | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| `PENDING`   | Transaction soumise à la blockchain, en attente de confirmation |
| `SUCCESS`   | Transaction confirmée et réglée                                 |
| `FAILED`    | Transaction échouée on-chain ou rejetée                         |
| `CANCELLED` | Transaction annulée avant d'être diffusée                       |

## Récupérer des Transactions

```bash theme={null}
GET /v1/wallets/{walletId}/transactions
GET /v1/wallets/{walletId}/transactions/{transactionId}
```

## Rejouer un Webhook Manqué

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook
```

## Annuler une Transaction en Attente

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel
```

<Warning>
  L'annulation n'est possible qu'avant que la transaction soit diffusée sur la blockchain.
</Warning>

## Réessayer une Transaction Échouée

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/retry
```

## Bonnes Pratiques

* **Utilisez les webhooks comme signal principal** — ne sondez pas l'API Transactions pour les mises à jour en temps réel.
* **Stockez les IDs de transaction** — enregistrez l'ID de transaction Blockradar avec vos enregistrements internes.
* **Rejouez les webhooks après une indisponibilité** — utilisez l'endpoint de renvoi pour récupérer les événements manqués.

## Référence API

| Endpoint                                                                    | Description                        |
| --------------------------------------------------------------------------- | ---------------------------------- |
| [Obtenir les transactions](/en/api-reference/transactions/get-transactions) | Récupérer toutes les transactions  |
| [Obtenir une transaction](/en/api-reference/transactions/get-transaction)   | Récupérer une transaction par ID   |
| [Renvoyer un webhook](/en/api-reference/transactions/resend-webhook)        | Rejouer un webhook                 |
| [Annuler](/en/api-reference/transactions/cancel-transaction)                | Annuler une transaction en attente |
| [Réessayer](/en/api-reference/transactions/retry-transaction)               | Réessayer une transaction échouée  |