Skip to content

Policies

components.payment_gateway.subcomponents.parties.protected.business_logic.policies.legal_entity_sync

LegalEntitySyncPolicy

Keeps legal entities in sync with external data sources (e.g. Global Profile events).

on_profile_updated 

on_profile_updated(unique_key, **data)

Update an existing legal entity from a profile change event.

Only updates existing entities — does not create new ones. Returns None if no entity exists or if it is terminated.

Source code in components/payment_gateway/subcomponents/parties/protected/business_logic/policies/legal_entity_sync.py 
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
def on_profile_updated(
    self,
    unique_key: str,
    **data: Unpack[LegalEntityUpdate],
) -> LegalEntityId | None:
    """Update an existing legal entity from a profile change event.

    Only updates existing entities — does not create new ones.
    Returns None if no entity exists or if it is terminated.
    """
    existing = LegalEntityModelBroker.find_legal_entity_by_unique_key(
        current_session, unique_key
    )
    if existing is None:
        current_logger.info(
            "No legal entity found for %s, skipping sync",
            unique_key,
        )
        return None
    if existing.is_terminated:
        current_logger.info(
            "Legal entity %s is terminated, skipping sync",
            unique_key,
        )
        return None

    legal_entity = LegalEntityModelBroker.upsert_legal_entity(
        current_session, unique_key=unique_key, **data
    )
    return LegalEntityId(legal_entity.id)