Account category events

Tango currently supports the following Account-related webhook events:

• Account status: Notifies you when an account becomes active, inactive, disabled, frozen, or deleted.
• Transaction: Notifies you when funds are added, removed, or transferred to or from a Tango account.
• Low balance: Notifies you when an account balance reaches a predefined low threshold.

AccountStatus event

Tango supports sending webhook events when a customer account changes status. This ensures you receive timely notifications for changes such as accounts becoming active, inactive, disabled, frozen, or deleted. Account status determines whether an account can perform core operations such as funding, placing orders, or processing transactions. Here are some advantages of AccountStatus event:

• Ensures real-time operational continuity: Real‑time AccountStatus updates allow your system to immediately respond to inactive, disabled, frozen, or deleted accounts to prevent failed orders and operational errors.
• Prevents failed transactions and customer frustration: Instant visibility into status changes helps you stop users from performing actions that would fail and maintain a smooth, frustration‑free experience.
• Supports compliance, auditing, and risk management: Monitoring account status changes enables accurate audit trails, enforces fraud controls, and ensures compliance with internal and regulatory requirements.
• Improves customer service and support response: Live account status information helps support teams diagnose issues quickly, explaining failed orders or missing access with clarity.

How to subscribe

To subscribe to AccountStatus events, create a webhook subscription. Once subscribed, your webhook endpoint will receive notifications any time your account changes status.

POST {URI}/webhooks
eventTypes = AccountStatus
categories = ACCOUNT

Use case

Acme, a wellness incentive company, needs real-time visibility into their customer account health. By subscribing to AccountStatus events, Acme receives alerts whenever an account becomes: active, inactive, frozen, disabled, or deleted. Real-time notifications allows Acme to respond quickly—for example, pausing services when an account is frozen or re-enabling functionality when it becomes active again.

To achieve, Acme follows the steps below:

Statuses for AccountStatus

The following statuses are returned in eventData.status when the AccountStatus event is triggered:

Example

Here is a response payload example of AccountStatusevent:

{
  "eventId": "45a2ddda-a159-42aa-a3ec-2f7b206a8495",
  "revision": 6,
  "category": "ACCOUNT",
  "eventType": "AccountStatus",
  "eventOccurredAt": "2024-06-17T20:31:19.852635900Z",
  "eventData": {
    "identifier": "A28448941",
    "status": "INACTIVE"
  }
}

Transaction events

Tango supports Transaction events. It sends webhook events when funds are added, removed, or transferred to/from your Tango account. Subscribing to the Transaction event ensures you receive timely notifications for such changes.

To subscribe, create a subscription using:

POST {URI}/webhooks
eventTypes = Transaction
categories = ACCOUNT

Use case

Acme, a wellness incentive company, uses Tango’s Transaction webhook to stay informed about financial activity on its accounts. By subscribing to this event, Acme receives real-time notifications whenever funds are added, removed, or transferred. This enables them to maintain accurate financial oversight and respond quickly to account changes.

To achieve this goal and to stay proactive, Acme subscribes to Transaction event using POST {URI}/webhooks and receives notification whenever funds have been added, removed, or transferred to or from a Tango account

Example

Here is a response payload example of theTransaction event:

"category": "Account",
"eventType": "Transaction",
"eventOccurredAt": "2024-11-09T04:25:36.4844028Z",
      "eventData": {
       "accountIdentifier":
       "Transaction Type":
       "Date":
       "Funding Method":
       "Funding Type::
       "Funding Invoice Number":
       "Transaction ID":
       "Currency":
       "Amount":
       "Note":
      }

LowBalance events

Tango supports LowBalance events. It sends webhook events when an account reaches a predefined low balance. Subscribing to the Transaction event ensures you receive timely notifications for such changes.

To subscribe, create a subscription using:

POST {URI}/webhooks
eventTypes = LowBalance
categories = ACCOUNT

Use case

Acme, a wellness incentive company, uses Tango’s LowBalance webhook to receive alerts when an account balance drops below a predefined threshold. By subscribing to this event, Acme can proactively fund accounts and avoid service interruptions, ensuring seamless reward delivery and account operations.

Example

Here is a response payload example of LowBalanceevent:

{
  "prevCursor": "QUNDT1VOVA==",
  "nextCursor": "QUNDT1VOVA==",
  "prevPageAvailable": false,
  "nextPageAvailable": false,
  "maxResults": 10,
  "items": [
    {
      "category": "ACCOUNT",
      "eventTypes": [
        "LowBalance",
        "AccountStatus",
        "Transaction"
      ]
    }
  ],
  "numberOfElements": 1
}