Account category events

The following webhook events are supported under Account category:

Account status

Tango supports sending webhook events when a customer account on your platform changes status. It ensures you receive timely notifications about changes such as accounts becoming active, inactive, disabled, frozen, or deleted. To subscribe to AccountStatus events, create a subscription with thePOST {URI}/webhooks and then select AccountStatus for eventType and ACCOUNTS for category.

Use case

Acme, a wellness incentive company, uses Tango’s AccountStatus webhook to stay informed about changes to their customer accounts. By subscribing to this event type, Acme receives real-time notifications when an account becomes active, inactive, frozen, disabled, or deleted. Real-time notifications allows them to respond quickly—for example, pausing services when an account is frozen—ensuring smooth operations and proactive customer management.

To achieve this goal and stay proactive, Acme subscribes to AccountStatus event using POST {URI}/webhooks. They receive notifications whenever one of their customer accounts becomes frozen, disabled, inactive, or active again.

List of account statuses

The following account statuses are available with the AccountStatus subscription:

Status	Description
Active	The account is Active, allowing you to conduct normal processing, funding, and placing orders.
Inactive	The account is Inactive, meaning you cannot fund or place orders. Unlike a Disabled account, you cannot change the Inactive status. The account might be inactive due to an internal request to close a platform or account(s). Contact your Customer Success Manager (CSM) at [email protected] for questions or help.
Disabled	You can disable your account without any assistance from Tango. Once your account is disabled, no transactions are allowed. For example, you can temporarily disable your seasonal account to prevent any order or funding activity outside the designated time, or you can take your account offline for auditing purposes. You can also disable an account to determine its status.
Frozen	Your account has reached the velocity threshold. No transaction can be processed until Tango lifts the freeze. Contact your Customer Success Manager (CSM) at [email protected] for questions or assistance.
Deleted	The account has been deleted and no longer exists.

Here is a response payload 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

Tango supports sending webhook events when funds are added, removed, or transferred to/from my Tango account. Subscribing to the Transaction event ensures you receive timely notifications for such changes. To subscribe, create a subscription using POST {URI}/webhooks. Select Transaction for the eventType and ACCOUNTS for the category.

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

Here is a response payload 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":
      }

Low balance

Tango supports sending 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. Select LowBalancefor the eventType and ACCOUNTS for the category.

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.

Here is a response payload of LowBalanceevent:

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