View Issue Details

IDProjectCategoryView StatusLast Update
0012294Talerspecificationpublic2026-11-21 22:54
Reporterbot-cg [agent]  
PrioritynormalSeverityblockReproducibilityalways
Status new 
Summary0012294: VQF 902.1 asks legal entities for DOMICILE_ADDRESS, but tops-kyx-check requires REGISTERED_OFFICE_ADDRESS: every legal entity is frozen
DescriptionEvery legal entity that onboards with the exchange's own VQF 902.1 form ("Identification of the customer", vqf_902_1_customer) has its account frozen.

The form stores the company's address under different attributes depending on the customer type:

- sole proprietor ("Information on customer (sole proprietor)"): REGISTERED_OFFICE_ADDRESS ("Registered office" / "Sitz");
- legal entity ("Information on customer (legal entity)"): DOMICILE_ADDRESS ("Domicile" / "Sitz").

taler-exchange-helper-measure-tops-kyx-check, the AML program of measure kyx, requires REGISTERED_OFFICE_ADDRESS for every legal-entity customer type (OPERATIONAL, FOUNDATION, TRUST, LIFE_INSURANCE). For a legal entity the attribute is never there, so the jq check fails and the program hands over to taler-exchange-helper-measure-freeze. Onboarding of businesses is therefore blocked.

The harness tests (test-tops-aml-measures.ts, test-tops-aml-pdf.ts) submit REGISTERED_OFFICE_ADDRESS for legal entities directly, without the form, which is why they pass.

Fix: the form should ask every business for REGISTERED_OFFICE_ADDRESS, not only sole proprietors; that is, the legal-entity section should store the company's address ("Domicile" / "Sitz", labels unchanged) as REGISTERED_OFFICE_ADDRESS. Natural persons who are not sole proprietors have no registered office and are not asked for one, and kyx-check does not require it from them. Two components change, each in a child of this issue with a patch:

- the form in taler-typescript-core (web-util);
- the exchange's PDF template for vqf_902_1_customer, which prints the legal entity's DOMICILE_ADDRESS as "Domicile" and would otherwise print an empty field.

Note for older records: legal entities that already submitted the form have DOMICILE_ADDRESS in their attributes. The PDF template patch falls back to it; the AML officer view, which shows stored attributes through the form definition, will not show their address under the corrected field.
Steps To Reproduce1. In the KYC web app of an exchange with the TOPS configuration, choose "legal entity" on VQF 902.1 and fill in the form.
2. Submit it.
3. taler-exchange-helper-measure-tops-kyx-check finds no REGISTERED_OFFICE_ADDRESS and runs taler-exchange-helper-measure-freeze: the account is frozen.
TagsTOPS

Required notifications

Address or linkRemarkAdded byNotifiedActions

The plan

IDSummaryStatusLocked byEstimated effort (hours)
0012295VQF 902.1: ask legal entities for REGISTERED_OFFICE_ADDRESS (patch attached) new
0012296VQF 902.1 PDF: print a legal entity's REGISTERED_OFFICE_ADDRESS (patch attached) new
This issue (hours)
Its children (hours)0
Together (hours)0
Not planned yet: 0012295, 0012296. The plan of this issue cannot be finished while part of it is unplanned.

Relationships

parent of 0012295 new VQF 902.1: ask legal entities for REGISTERED_OFFICE_ADDRESS (patch attached) 
parent of 0012296 new VQF 902.1 PDF: print a legal entity's REGISTERED_OFFICE_ADDRESS (patch attached) 
Not all the children of this issue are yet resolved or closed.

Activities

There are no notes attached to this issue.

Issue History

Date ModifiedUsernameFieldChange
2026-11-21 22:54bot-cgNew Issue
2026-11-21 22:54bot-cgRelationship addedparent of 0012296
2026-11-21 22:54bot-cgRelationship addedparent of 0012295
2026-11-21 22:54bot-cgImplementer => Alexis_Lafargue
2026-11-21 22:54bot-cgReviewer => Amoui NGoran
2026-11-21 22:54bot-cgRelease signed by => schanzen
2026-11-21 22:54bot-cgDeployed by => vecirex
2026-11-21 22:54bot-cgVerifier => Alexis_Lafargue
2026-11-21 22:54bot-cgCommunicator => CM_7