Accounts mapping

To use a deposit account from Mambu Core within Mambu Payments, you must first create a corresponding internal_account including:

The account_number used for payment routing used to route payments across partner banks and payment schemes
The cbs_account_id used to book payments in the relevant deposit account in Mambu Core

curl --request POST \
     --url https://sandbox.numeral.io/v1/internal_accounts \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "type": "own",
  "name": "Deposit account 123ABC",
  "holder_name": "John Doe",
  "account_number": "DE95500210006463956892",
  "bank_code": "SOMEBIC0XXX",
  "cbs_source": "mambu",
  "cbs_account_id": "123ABC",
  "cbs_account_type": "deposit",
  "connected_account_ids": [
    "0e606186-0e33-45a1-a102-18c12980a0dd"
  ]
}
'

curl --request POST \
     --url https://sandbox.numeral.io/v1/bulk_actions \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "target_object": "internal_account",
  "action": "create",
  "items": [
    {
      "type": "own",
      "name": "Deposit account 123ABC",
      "holder_name": "John Doe",
      "account_number": "DE95500210006463956892",
      "bank_code": "SOMEBIC0XXX",
      "cbs_source": "mambu",
      "cbs_account_id": "123ABC",
      "cbs_account_type": "deposit",
      "connected_account_ids": [
        "0e606186-0e33-45a1-a102-18c12980a0dd"
      ]
  }
  ],
  "fail_on_validation_error": true
}
'

Mambu Payments will create a new internal_account record:

{
  "id": "9271b509-70cf-5459-9904-2af3264b745e",
  "name": "Deposit account 123ABC",
  "type": "own",
  "object": "internal_account",
  "status": "active",
  "bank_code": "SOMEBIC0XXX",
  "cbs_source": "mambu",
  "cbs_account_type": "deposit",
  "cbs_account_id": "123ABC",
  "account_number": "DE95500210006463956892",
  "connected_account_ids": [
    "00000000-1111-1111-1111-000000000001"
  ]
}

ℹ️
The internal_account ID is deterministically generated from the cbs_account_id and your Mambu Payments tenant ID eliminating the need to store the mapping: internal_account.id=UUIDv5(namespace =legal_entity_id, name = cbs_account_id)

🗓️
Automatic synchronisation of your Mambu Core deposit accounts with Mambu Payments internal_account is planned for release in H2 2026.