Skip to main content

Update client-ref BCAN mapping

PUT

{BASE_URL}/accounts/client-bcan

Replaces the HKIDR CID details of an existing mapping, identified by account_number and client_ref. The assigned id, bcan, ce_number and order_tag never change.

This is a full replacement, not a partial update: every CID field is overwritten with the value sent, and optional fields you omit are cleared.

Validation is the same as for POST. hkidr_consent must be true and id_number must not be blank. Individuals and joint accounts need at least one of english_first_middle_name, english_last_name or chinese_name. Other client types need english_legal_entity_name or chinese_legal_entity_name.

Returns 400 DataRetrieval_Error if no mapping exists for client_ref; use POST to create one.

Request​

Responses​

Mapping updated.