# Webhooks de retrait

> Version Markdown de la documentation publique de l'API v1 de Bifrost Crypto, pour les agents d'IA et les générateurs de code. Même contenu que les pages HTML, généré à partir de la même source, sans navigation ni mise en forme.
>
> Version HTML: https://bifrostcrypto.com/fr/docs/webhooks-payments
> Fichiers liés: [ai.md](https://bifrostcrypto.com/ai/fr.md) · [Postman](https://bifrostcrypto.com/postman-collection.json) · [OpenAPI](https://bifrostcrypto.com/openapi.json) · [llms.txt](https://bifrostcrypto.com/llms.txt)
> Autres langues: [Português](https://bifrostcrypto.com/ai/pt-BR/webhooks-payments.md) · [English](https://bifrostcrypto.com/ai/en/webhooks-payments.md) · [Español](https://bifrostcrypto.com/ai/es/webhooks-payments.md)
> API v1 · dernière modification du contrat le 2026-10-10

Avis d'un payout créé par l'API.

## `payment_processed` · Payout Confirmé

Envoyé lorsque le retrait est traité. status vaut success. Le corps porte le portefeuille, les montants, le réseau et customer_info.

```json
{
  "data": {
    "status": "success",
    "wallet": "0xBeef0000000000000000000000000000000000b2",
    "network": "BinanceSmartChain",
    "created_at": "2026-03-01 13:00:00",
    "fiat_amount": "40.00",
    "network_fee": "0.00000400",
    "confirmed_at": "2026-03-01 13:00:06",
    "percent_rate": "0.50",
    "reference_id": "33333333-3333-4333-8333-333333333333",
    "transactions": "0xdef0000000000000000000000000000000000000000000000000000000000abc",
    "crypto_amount": "40.00000000",
    "customer_info": "customer@example.com",
    "fiat_currency": "USD",
    "crypto_currency": "USDT",
    "internal_reference": "44444444-4444-4444-8444-444444444444"
  },
  "event": "payment_processed",
  "timestamp": "2026-03-01 13:00:16"
}
```

## `payment_failed` · Payout Échoué

Envoyé lorsque le retrait ne peut pas aboutir. Le corps ne porte que status, reference_id et internal_reference.

```json
{
  "data": {
    "status": "failed",
    "reference_id": "55555555-5555-4555-8555-555555555555",
    "internal_reference": "66666666-6666-4666-8666-666666666666"
  },
  "event": "payment_failed",
  "timestamp": "2026-03-01 13:05:00"
}
```

> Votre intégration doit traiter cet avis : retrouvez le payout par reference_id ou internal_reference et décidez quoi indiquer à votre client. Pour payer à nouveau, créez un nouveau payout avec un nouveau reference_id.

**`customer_info`** (Payin & Payout)

Votre propre identifiant du client, comme un ID utilisateur, un e-mail ou un numéro de commande. Il est renvoyé dans les webhooks et les listes, pour savoir à qui appartient chaque transaction, y compris les payins que Bifrost crée lui-même (paiements supplémentaires et dépôts sur adresse fixe), dont le reference_id est généré par Bifrost.

`"customer_info": "user@email.com" ou "user_12345_order_67890"`