Reference

The Mambu integration includes several outbound (synchronous) runtime connectors that call the Mambu API v2. Backbase configures each connector in its own values.yaml file. For the environment details you send to Backbase, see Get started.

Connector	Property file	Purpose
`gc-mambu-deposit-connector`	`deposit-v0.values.yaml`	Deposit account operations
`gc-mambu-deposit-transaction-connector`	`deposit-transactions-v0.values.yaml`	Deposit transaction operations
`gc-mambu-loan-connector`	`loan-v0.values.yaml`	Loan account operations
`gc-mambu-loan-transaction-connector`	`loan-transactions-v0.values.yaml`	Loan transaction operations
`gc-mambu-payment-connector`	`payment-v0.values.yaml`	Payment operations
`gc-mambu-party-connector`	`party-v0.values.yaml`, `party-v2.values.yaml`	Party management operations

Configuration properties

Values to obtain from Mambu

Obtain the following value from Mambu and send it to your Backbase support team. Backbase sets it in values.yaml. This value is environment-specific, so it has no default.

Property	Description
`mambu.baseUrl`	Target API endpoint for the Mambu environment.

Common properties

Set these properties in values.yaml. They apply across all Mambu connectors. Product ID mappings set here are inherited by the deposit and party connectors.

Property	Description	Default
`existingSecretName`	Reference to the SOPS secret that holds the Mambu credentials.	`mambu`
`http.client.connect.timeout`	HTTP connect timeout, in milliseconds.	`5000`
`http.client.request.timeout`	HTTP request timeout, in milliseconds.	`10000`
`http.client.socket.timeout`	HTTP socket timeout, in milliseconds.	`5000`
`http.client.connection.max.per.route`	Maximum HTTP connections per route.	`100`
`http.client.connection.max.total`	Maximum total HTTP connections.	`200`
`redelivery.backOffMultiplier`	Backoff multiplier for redelivery attempts.	`2`
`redelivery.delay`	Initial delay between redelivery attempts, in milliseconds.	`200`
`redelivery.maximumRetries`	Maximum number of redelivery attempts.	`3`
`retryFlag`	Enable automatic request retries on connection failure.	`false`
`errorTemplate`	Transformation template used to map core error responses.	`transform-mambu-error-details-v2.json`
`thread.profile.core.pool.size`	Core thread pool size.	`20` (`10` for the deposit connector)
`thread.profile.max.pool.size`	Maximum thread pool size.	`20`

The following product ID mapping patterns translate between Banking OS product types and Mambu product IDs.

Pattern	Description
`product.<KIND>.<TYPE>.<CURRENCY>.id`	Forward mapping: Banking OS product type to Mambu product ID.
`<MAMBU_PRODUCT_ID>`	Reverse mapping: Mambu product ID to Banking OS product type.

The product ID mapping values are environment-specific. Contact your Mambu administrator to obtain the full list of product IDs for your tenant.

gc-mambu-party-connector and gc-mambu-deposit-connector

The party and deposit connectors hold basic configuration. They inherit the product ID mappings from the common values.yaml. They have no additional connector-specific properties.

gc-mambu-deposit-transaction-connector

Set this property in deposit-transactions-v0.values.yaml, in addition to the common properties.

Property	Description	Default
`isMockedDataNeeded`	Return mocked transaction data instead of calling Mambu.	`false`

gc-mambu-loan-connector

Set these properties in loan-v0.values.yaml, in addition to the common properties.

Property	Description	Default
`product.<KIND>.<TYPE>.<CURRENCY>.id`	Forward mapping: Banking OS product type to Mambu product ID.	N/A
`<MAMBU_PRODUCT_ID>`	Reverse mapping: Mambu product ID to Banking OS product type.	N/A
`timeZone`	Optional. Time zone applied to loan operations.	`CET`
`<CoreErrorCode>`	Optional. Maps a Mambu error code to a Banking OS error code.	N/A

gc-mambu-loan-transaction-connector

Set these properties in loan-transactions-v0.values.yaml, in addition to the common properties.

Property	Description	Default
`isMockedDataNeeded`	Return mocked transaction data instead of calling Mambu.	`false`
`isLoanExistCheck`	Verify that the loan exists before retrieving transactions.	`true`
`<CoreErrorCode>`	Optional. Maps a Mambu error code to a Banking OS error code.	N/A

gc-mambu-payment-connector

Set this property in payment-v0.values.yaml. The payment connector uses the common properties and defines the following connector-specific error-code overrides.

Property	Description	Default
`<coreErrorCode>`	Maps a Mambu error code to a Banking OS status code, for example `428=GC401` or `401=GC409`.	N/A

SOPS secrets

The connectors use Basic authentication with credentials stored in a SOPS secret, referenced by the existingSecretName property. Obtain the following credentials from Mambu. Backbase stores the secret.

Credential	Description
`mambu-user-id`	Username for Basic authentication.
`mambu-password`	Password for Basic authentication.

Supported operations

The Mambu connectors expose the Banking OS Unified API. For the operation-to-endpoint tables per domain (deposit, deposit transactions, loan, loan transactions, payment, party), see Overview. For the full contract, see the API playground.

Events

These connectors are synchronous and do not publish or consume events.

Error mapping

The connector maps Mambu error codes to Banking OS status codes. For the full list, see Error codes. You can configure connector-specific overrides as core-to-Banking OS code pairs in a connector’s values.yaml; the payment connector ships with overrides for several Mambu error codes (see gc-mambu-payment-connector). The loan and loan transaction connectors also accept overrides through the <CoreErrorCode> property.

Dependencies

Mambu API v2 (outbound), reachable at mambu.baseUrl.
The shared mambu-connector-sdk library.

Get started

Core banking

Payments

Card management

KYC and KYB

Open Banking

CRM

Fraud detection

Financial data aggregation

Configuration properties

Values to obtain from Mambu

Common properties

gc-mambu-party-connector and gc-mambu-deposit-connector

gc-mambu-deposit-transaction-connector

gc-mambu-loan-connector

gc-mambu-loan-transaction-connector

gc-mambu-payment-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​Values to obtain from Mambu

​Common properties

​gc-mambu-party-connector and gc-mambu-deposit-connector

​gc-mambu-deposit-transaction-connector

​gc-mambu-loan-connector

​gc-mambu-loan-transaction-connector

​gc-mambu-payment-connector

​SOPS secrets

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

Values to obtain from Mambu

Common properties

gc-mambu-party-connector and gc-mambu-deposit-connector

gc-mambu-deposit-transaction-connector

gc-mambu-loan-connector

gc-mambu-loan-transaction-connector

gc-mambu-payment-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies