Link Clients

The process [COMMON] Link MBU customer to CCy subaccount and contact [Linked to MBU webhook] is used in the integration as a prerequisite for inbound payments and conversions, or other types of payments made on behalf of a Currencycloud contact.

This process is triggered when a new deposit account is approved for a client or a group in Mambu, firing a pre-configured webhook containing client information such as name, address, date of birth, and contact details. See Additional Information below for a full list of required fields. Using this information, checks are made whether a new link needs to be created or one already exists. If no existing link is found, a sub-account and contact are created in Currencycloud. The details of the Currencycloud sub-account and contact are fed back to Mambu and saved in the matching custom fields in the client record.

This flow handles the following cases. If the client:

  • Already has both a sub-account and contact linked, no action is needed and the process finishes successfully.
  • Has a sub-account but no linked contact, a new contact is created in Currencycloud for that client.
  • Has no linked sub-account, a new sub-account and contact is created in Currencycloud and linked to that client’s account in Mambu.

Sequence diagram

Sub-account and contact linkage

Additional information

The following information needs to be populated in Mambu so that the sub-account and contact can be created in Currencycloud:

  • Client entity:
    • Birthdate,
    • Mobile phone,
    • Email address,
    • Street address - line 1,
    • City,
    • Country (2-digit ISO code).
  • Group entity:
    • Mobile phone,
    • Email address,
    • Street address - line 1,
    • City,
    • Country (2-digit ISO code).