Bank Account Updated

An existing Bank Account has been updated.

Example Use Case

Updating the Bank Account record with the latest account balance or status to be used in ongoing monitoring.

Request Specifications

Required API FieldDefinitionNotes
timestampTimestamp of the event.
One of:
external_account_id
account_token
Unique identifier for the Bank Account being updated.The account_token is Alloy's assigned identifier for the Account record, returned in the response for bank_account_created/ external_account_created events.
One of:
external_entity_id
entity_token
Unique identifier of one of the Entities associated with the Account.Not strictly required if the event is not being monitored, but recommended to include for future proofing your integration.

This field has no impact on which Entities are attached to the Account, although it should match at least one of the Entities that the Account belongs to.

Example Request/Response:

{
    "event_type": "bank_account_updated",
    "event_lifecycle_id": "X99-43jf-434klj",
    "event_status": "successful",
    "data": {
        "external_account_id": "105a61e2-0dd9-4c63-858b-e9d7009cdd1d",
        "external_entity_id": "9e82d5e7-ada0-4957-a8fd-4d937c99bae8",
        "timestamp": "2024-03-25T22:44:52.284Z",
        "account_balance": 185000,
        "status": "Frozen",
        "status_detail": "Awaiting verification",
        "supplemental_data": {}
    }
}
{
    "status_code": 201,
    "event_request_token": "EV-74ddyRtVhBq3eF1EuyAk",
    "_links": {
        "self": {
            "href": "/v1/events/EV-74ddyRtVhBq3eF1EuyAk"
        }
    },
    "event": {
        "event_type": "bank_account_updated",
        "event_status": "PROCESSED",
        "data": {
            "account_number": "10426757",
            "account_number_encrypted": "b848f6488f3568c8c8ef90ad4...",
            "account_number_hashed": "de92be6b6473badcec68d9a6c23f...",
            "cif_number": null,
            "account_type": null,
            "product_code": "DDA01",
            "product_name": "Alloy Business Checking",
            "opening_date": "2023-03-22T00:00:00.000Z",
            "maturity_date": null,
            "closing_date": null,
            "activation_date": null,
            "expiration_date": null,
            "meta": {
                "somedata": "string"
            },
            "routing_number": "000123456789",
            "external_ingestion_identifier": null,
            "card_network": "visa",
            "account_name": "John Doe Business",
            "tokenization_method": null,
            "merchant_category_code": null,
            "name_on_card": null,
            "account_number_last4": null,
            "avs": null,
            "account_class": "deposit",
            "country_code": "US",
            "description": null,
            "program_name": null,
            "mcc_description": null,
            "is_linked_account": false,
            "link_timestamp": null,
            "unlink_timestamp": null,
            "currency": "USD",
            "account_hash": null,
            "account_balance": "0.00",
            "credit_limit": null,
            "status": "Frozen",
            "status_detail": "Awaiting verification",
            "as_of_date": "2024-03-25T00:00:00.000Z",
            "external_account_id": "105a61e2-0dd9-4c63-858b-e9d7009cdd1d",
            "account_token": "A-veYTeL4YRlFnRsxinwt7"
        },
        "evaluations": [],
        "journey_applications": []
    }
}