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 Field | Definition | Notes |
---|---|---|
timestamp | Timestamp 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": []
}
}
Updated 2 months ago