External Account Updated
An external or funding Account has been unlinked or re-linked.
Example Use Case
Monitoring for potential account takeover by tracking associated external accounts.
Request Specifications
Required API Field | Definition | Notes |
---|---|---|
| Timestamp of the event. | The |
One of: | Unique identifier for the External Account being updated. | The |
One of: | Timestamp when the External Account was unlinked (or re-linked). | The |
One of: | Unique identifier of one of the Entities associated with the External 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": "external_account_updated",
"event_status": "successful",
"event_lifecycle_id": "X99-43jf-74382",
"data": {
"external_account_id": "9478cf5a-61b6-4c73-a4bf-e71d133f4cd7",
"external_entity_id": "efa4cfa2-379c-4f9e-aab5-1a9a933cde15",
"timestamp": "2024-03-28T02:32:51.351Z",
"unlink_timestamp": "2024-03-28T02:32:51.351Z"
},
"supplemental_data": {}
}
{
"status_code": 201,
"event_request_token": "EV-OYyPwOsoiYE7V6I6ncse",
"_links": {
"self": {
"href": "/v1/events/EV-OYyPwOsoiYE7V6I6ncse"
}
},
"event": {
"event_type": "external_account_updated",
"event_status": "PROCESSED",
"data": {
"account_number": "0123456",
"account_number_encrypted": "4f76aaf90607...",
"account_number_hashed": "3badcec68d9a6...",
"cif_number": null,
"account_type": null,
"product_code": null,
"product_name": null,
"opening_date": null,
"maturity_date": null,
"closing_date": null,
"activation_date": null,
"expiration_date": null,
"meta": null,
"routing_number": "021000021",
"external_ingestion_identifier": null,
"card_network": null,
"account_name": null,
"tokenization_method": null,
"merchant_category_code": null,
"name_on_card": null,
"account_number_last4": null,
"avs": null,
"account_class": null,
"country_code": null,
"description": null,
"program_name": null,
"mcc_description": null,
"is_linked_account": true,
"link_timestamp": "2024-03-28T02:16:26.983Z",
"unlink_timestamp": "2024-03-28T02:32:51.351Z",
"entities": [
{
"entity_token": "P-pHoEYGBD5I0O7weUUOoo",
"external_entity_id": "efa4cfa2-379c-4f9e-aab5-1a9a933cde15",
"account_holder_type": "primary"
}
],
"currency": "USD",
"account_hash": null,
"external_account_id": "9478cf5a-61b6-4c73-a4bf-e71d133f4cd7",
"account_token": "A-uiQyEF3kvfvBUZ7fXblb"
},
"evaluations": [],
"journey_applications": []
}
}
Updated 16 days ago