GuidesThe HIVE APIsMobile SDKsJavascript SDK

Activity Event

You can subscribe the Activity Webhook to receive all activities associated with the account

Event Details

Event Type: ACTIVITY

Supported Activity Types:

  • CARD_REPLACEMENT

  • DENIED_AUTHORIZATION

When to Use This Webhook

Use this webhook if you need:

  • Real-time notifications when account-level activities occur

  • Updates for events like card replacement initiation or authorization denials

Payloads for CARD_REPLACEMENT Type 

{
  "business_account_uuid": "3ff8d46a-da4d-46f1-a296-db483914b896",
  "entity": {
    "activity_uuid": "example-activity-uuid",
    "account_uuid": "example-account-uuid",
    "wallet_uuid": "example-wallet-uuid",
    "entity_uuid": "example-entity-uuid",
    "entity_type": "ISSUED_CARD",
    "type": "CARD_REPLACEMENT", 
    "type_details": { 
      "card_replacement_details": { 
        "reason": "example", 
        "replacement_card_uuid": "example-replacement-card-uuid",
        "waive_fees": true,
        "description": "Customer reported the card as lost.",
        "waive_fees_reason": "Customer Loyalty",
        "waive_fees_description": "Fees waived as part of our customer loyalty program."
      }
  },
  "event_date": "2022-10-11T09:11:48.214Z",
  "event_retry": 0,
  "event_type": "ACTIVITY",
  "event_uuid": "bb4e7d84-7979-4947-9e1f-29231ed0abaf",
  "event_version": "2021-11-18.1",
  "program_uuid": "3ff8d46a-da4d-46f1-a296-db483914b896"
}

Payloads for DENIED_AUTHORIZATION Type 

{
  "entity": {
    "activity_uuid": "7c2d6f6e-3b3c-4a41-9b26-a3f0d5c2e9ab",
    "account_uuid": "a1b2c3d4-e5f6-4789-ab01-23456789abcd",
    "wallet_uuid": "w1234567-89ab-4cde-f012-3456789abcde",
    "type": "DENIED_AUTHORIZATION",
    "type_details": {
      "denied_authorization_details": {
        "card_uuid": "c0ffee00-1234-4abc-9def-001122334455",
        "denied_reasons": [
          "INSUFFICIENT_FUNDS"
        ],
        "amount": "23.45",
        "currency": "USD",
        "network": "VISA",
        "subnetwork": "BANKNET",
        "merchant_name": "ACME ONLINE STORE",
        "merchant_id": "M1234567890",
        "terminal_id": "T9876543210",
        "is_international": false
      }
    }
  },
  "event_date": "2025-08-12T19:36:40Z",
  "event_retry": 0,
  "event_type": "ACTIVITY",
  "event_uuid": "f4863f42-061d-5f0a-ab8a-e8f25a35c4dd",
  "event_version": "2021-11-18.1",
  "program_uuid": "f874b26c-2dbd-487f-8994-f38605cfb0a5",
  "business_account_uuid": "ba-5c7e9a1b-2345-6789-abcd-ef0123456789"
}