Passer au contenu principal
En bref
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é.

Prérequis

1

Clé API

Obtenez votre clé API depuis le Tableau de bord Blockradar.
2

Portefeuille Créé

Vous aurez besoin d’un walletId pour interroger les transactions.

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.

Consulter l'historique

Récupérez toutes les transactions d’un portefeuille ou filtrez par adresse, actif, statut ou plage de dates.

Enquêter sur les paiements

Recherchez une transaction spécifique par ID pour vérifier son statut, son hash et ses métadonnées.

Rejouer les webhooks

Renvoyez un webhook pour une transaction que votre système a manquée ou échoué à traiter.

Annuler ou réessayer

Annulez une transaction en attente bloquée ou réessayez une transaction échouée.

États des Transactions

StatutDescription
PENDINGTransaction soumise à la blockchain, en attente de confirmation
SUCCESSTransaction confirmée et réglée
FAILEDTransaction échouée on-chain ou rejetée
CANCELLEDTransaction annulée avant d’être diffusée

Récupérer des Transactions

GET /v1/wallets/{walletId}/transactions
GET /v1/wallets/{walletId}/transactions/{transactionId}

Rejouer un Webhook Manqué

POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook

Annuler une Transaction en Attente

POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel
L’annulation n’est possible qu’avant que la transaction soit diffusée sur la blockchain.

Réessayer une Transaction Échouée

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

EndpointDescription
Obtenir les transactionsRécupérer toutes les transactions
Obtenir une transactionRécupérer une transaction par ID
Renvoyer un webhookRejouer un webhook
AnnulerAnnuler une transaction en attente
RéessayerRéessayer une transaction échouée