Webhook – Card Terminated

Événement : card.terminated

Déclenché dès qu'une carte virtuelle est résiliée avec succès.

Lorsqu'une carte est terminée, PentrraWallet crédite automatiquement le solde restant sur votre compte (après déduction des frais), puis envoie une requête HTTP POST vers l'URL webhook_url que vous avez définie dans vos paramètres API.

Exemple de notification reçue sur votre `webhook_url`

{
  "event": "card.terminated",
  "card_id": "crd_a1b2c3d4e5f6",
  "refund_amount": 24.00,
  "fee_applied": 1.00,
  "original_balance": 25.00,
  "reference": "ATERM_42_A3F9C2B1",
  "status": "completed",
  "timestamp": "2026-01-15T10:35:00+00:00"
}

Description des champs

Champ	Type	Description
`event`	string	Toujours `card.terminated`
`card_id`	string	Identifiant de la carte résiliée
`refund_amount`	float	Montant crédité sur votre solde (USD), après frais
`fee_applied`	float	Frais déduits (USD)
`original_balance`	float	Solde de la carte avant résiliation (USD)
`reference`	string	Référence interne de la transaction — utilisable avec `/verify-trx`
`status`	string	Toujours `completed`
`timestamp`	string	Date et heure de l'événement (ISO 8601)

Vérifier l'authenticité de la notification

Après réception du webhook, nous vous recommandons de vérifier la transaction via l'endpoint /verify-trx en croisant la reference et le refund_amount :

POST /api/v1/verify-trx
{
  "api_key": "pk_live_xxxxxxxxxxxxxxxxxxxx",
  "secret_key": "sk_live_xxxxxxxxxxxxxxxxxxxx",
  "reference": "ATERM_42_A3F9C2B1",
  "amount": 24.00
}

Réponse attendue si la transaction est valide :

{
  "success": true,
  "message": "Transaction received.",
  "data": {
    "reference": "ATERM_42_A3F9C2B1",
    "amount": 24.00,
    "type": "admin_credit",
    "status": "completed",
    "processed_at": "2026-01-15 10:35:00"
  }
}

Notes importantes

Le webhook est envoyé après que le crédit a été appliqué sur votre solde.
Si votre serveur ne répond pas dans les 10 secondes, la requête est abandonnée — le crédit reste effectif.
Votre endpoint doit retourner un HTTP 2xx pour confirmer la réception.
La webhook_url doit être configurée dans votre tableau de bord sous Paramètres API.