Delete a low balance alert for a customer account
🚧 Coming soon
Use DELETE {URI}/customers/{customerIdentifier}/accounts/{accountIdentifier}/lowbalance/{balanceAlertID}
to delete a low balance alert configured for a specific account under a customer. Low balance alerts are used to notify stakeholders when an account’s balance drops below a defined threshold. Removing an alert may be necessary when thresholds change, accounts are restructured, or notifications are no longer needed. Using delete option, you can maintain clean and relevant alert configurations, ensuring that only necessary notifications are active.
Use case
Acme Wellness uses low balance alerts to monitor funding levels in customer accounts that support automated wellness rewards. A customer updates their funding strategy and no longer needs one of the alerts previously set on their rewards account. The admin then deleted the alert using this endpoint. Once deleted, the account will no longer trigger notifications for that specific threshold, reducing unnecessary alerts.
Use the following endpoint to delete a low balance alert:
Endpoint | Purpose |
---|---|
DELETE {URI}/customers/{customerIdentifier}/accounts/{accountIdentifier}/lowbalance/{balanceAlertID} | Delete a low balance alert for a specific Account under a Customer |
The following parameters are part of your URL path for this API request. customerIdentifier
is a string used to identify the Group (Customer) that contains the account you are transacting from. customerIdentifier
is essential when working with endpoints that involve customer-specific data, especially when multiple customers may have accounts with similar structures or identifiers:
Path param | Data type | Requirement | Description |
---|---|---|---|
customerIdentifier | string | required | A unique string that identifies a specific customer within the system. It's used to associate deleting low balance alerts with the correct customer record. |
accountIdentifier | string | required | A unique string that identifies a specific account belonging to a customer. It's used in combination with the customerIdentifier to accurately target the correct account when deleting low balance alerts. accountIdentifier ensures that you interact with the right account when there are multiple accounts. |
balanceAlertID | uuid | required | A universally unique identifier (UUID) that represents a specific low balance alert configured for a customer's account. It is used to precisely identify which alert should be deleted when calling the DELETE endpoint.balanceAlertID ensures that only the intended alert is removed, especially in cases where multiple alerts may exist for the same account with different thresholds or notification settings. |
Here is an example of the returned payload:
{
"balanceAlertID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "ACTIVE"
}
The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages:
Response code | Meaning |
---|---|
200 | The request was successful. |
400 | The server could not understand the request due to invalid syntax. |
401 | Authentication is required and has either not been provided or failed. |
403 | The server understood the request but refuses to authorize it. |
409 | The server understands the request but cannot process it due to semantic errors. |
500 | Something went wrong on the server, but the server cannot be more specific about what the exact problem is. |
Updated about 15 hours ago