Savings Transaction Updates

Webhook

POST

savings-transaction-update-notification

This webhook is designed to communicate various user-related actions — such as verification, blacklisting, or inactivation — which are conducted by a third-party service. When the third-party service completes an action, the webhook instantly relays the outcome:

Verification: It notifies whether the user's verification process has succeeded or failed after analysing the provided documents.

Blacklisting: Deprecated It alerts when a user has been added to or updated on the blacklist, usually due to breaching terms of service or other predefined criteria.

Inactivation: It sends a notification if a user's account has been deactivated, which may occur for various reasons.

By subscribing to this webhook, partners can ensure they are immediately informed of critical updates to user status, enabling prompt and appropriate responses within their systems.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Return a 200, 201, 202 or 204 status to indicate that the data was received successfully

This response does not have a body.

Request Example

Shell

JavaScript

Java

curl --location 'https://your-api-server.com' \
--header 'X-BTS-Idempotency-Key;' \
--header 'Signature;' \
--header 'Content-Digest;' \
--header 'Date;' \
--header 'Content-Type: application/json' \
--data '{
    "params": {
        "event_time": "2025-04-11T08:09:07Z",
        "user_id": "1ed55cc7-f413-69a4-88f6-5aa1a9244d15",
        "savings_plan_id": "1f020444-59fc-6ab8-b914-12a53b25f111",
        "id": "a1e00000-0000-0000-0000-000000000001",
        "status": "confirmed",
        "asset_id": "f1e00000-0000-0000-0000-000000000001",
        "fiat_id": "d1e00000-0000-0000-0000-000000000001",
        "fiat_amount": "100.50",
        "confirmation_deadline": "2025-04-12T08:09:07Z",
        "trade_details": {
            "trade_id": "11e00000-0000-0000-0000-000000000001",
            "offer_id": "21e00000-0000-0000-0000-000000000001",
            "asset_amount": "0.0025"
        },
        "error_details": {
            "code": "403",
            "message": "Savings plan transaction was not confirmed by 2025-04-12T08:09:07Z"
        },
        "metadata": {
            "ex_ante": {
                "instrument_isin": "US11135F1012",
                "offer": {
                    "amount_fiat": "840",
                    "amount_asset": "2.89955126",
                    "fee": "0"
                }
            }
        }
    }
}'

Modified at 2026-07-21 14:04:41

Savings Plan Auto Cancel

Crypto Actions Notifications