Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource
The Mambu Payments connector ships three families of plugins on top of the Mambu Payments datasource: DisableSearch, relation plugins that add the links the Numeral API does not expose natively, and action plugins that expose payment operations (create, approve, cancel, verify) as actions.
The Mambu Payments connector is only available for Ruby (gem forest_admin_datasource_mambu_payments).
Nothing is registered automatically: opt each plugin in. DisableSearch and the relation plugins install at the datasource level (@create_agent.use), and raise an ArgumentError when installed on a single collection. The action plugins install at the collection level (collection.use) and take the registered Datasource instance as their datasource option.
ForestAdminDatasourceMambuPayments::Plugins::DisableSearch removes the search bar from all 17 Mambu collections. The Numeral API has no free-text search, and the OR condition Forest builds to emulate one is refused by the datasource, so without this plugin a search returns an error.
Every relation plugin lives under ForestAdminDatasourceMambuPayments::Plugins::Relations and takes no option: @create_agent.use(<plugin>, {}). Install only the links you need — each one adds API calls when the relation is displayed.
Direct links
The target collection already carries the foreign key, so these plugins only declare the one-to-many relation on the host.
An account holder is reached through an account. These plugins import account_holder_id from the related account (read-only), add a many-to-one to MambuAccountHolder on the host, and add the reverse one-to-many on MambuAccountHolder. A filter on the holder is resolved by listing the intermediate accounts of that holder first.
Plugin
Adds on the host
Adds on MambuAccountHolder
Through
LinkAccountHolderToIncomingPayments
MambuIncomingPayment.account_holder
incoming_payments
the internal account
LinkAccountHolderToDirectDebitMandates
MambuDirectDebitMandate.account_holder
direct_debit_mandates
the external account
LinkPaymentOrderToReceivingAccountHolder
MambuPaymentOrder.receiving_account_holder
payment_orders
the receiving external account
Links resolved through an intermediate collection
The target collection has no foreign key to the host at all. These plugins add a virtual foreign key column on the target — always empty on a record, filterable with EQUAL and IN only — and the one-to-many on the host. Opening the relation lists the intermediate collection first, then filters the target on the ids it found.
Plugin
Adds
Resolved through
LinkPaymentOrderToTransactions
MambuPaymentOrder.transactions
MambuReconciliation (reconciliations of the payment order)
LinkIncomingPaymentToTransactions
MambuIncomingPayment.transactions
MambuReconciliation (reconciliations of the incoming payment)
LinkIncomingPaymentToExpectedPayments
MambuIncomingPayment.matched_expected_payments
MambuReconciliation, twice: the transactions reconciled with the incoming payment, then the expected payments reconciled with those transactions
LinkInternalAccountToBalances
MambuInternalAccount.balances
the internal account’s connected_account_ids
LinkInternalAccountToPaymentOrders
MambuInternalAccount.payment_orders
the internal account’s connected_account_ids
LinkInternalAccountToBalances and LinkInternalAccountToPaymentOrders resolve through the connected accounts: they list every balance or payment order of the connected accounts the internal account belongs to, not only the ones tied to that internal account.
A resolution reads at most 10,000 intermediate records and logs a warning when it reaches that cap.
Action plugins
Every action plugin lives under ForestAdminDatasourceMambuPayments::Plugins::SmartActions, installs on any collection with collection.use, and requires the datasource option. The host collection does not need to be a Mambu collection: an action plugin reads the Mambu id from the column you name in record_id_field, so a collection of your own database that stores a Mambu id works as well as the Mambu collection itself.
Option
Applies to
Description
datasource
all
Required. The ForestAdminDatasourceMambuPayments::Datasource instance.
record_id_field
update, approve, cancel, verify
Required. Column of the host collection holding the Mambu id to act on — 'id' on the Mambu collection itself.
action_name
create, update
Overrides the action label.
result_field
create
Writable column of the host record that receives the id of the created resource. Best-effort: a failed write-back is logged and reported in the success message, without rolling back the creation.
scopes
approve, cancel, verify
[:single], [:bulk] or both (default). Registers one action per scope.
Create actions
Single-scope actions that create a resource from the values of their form.
Plugin
Default label
Form fields (all required)
CreateAccountHolder
Create Mambu account holder
Name
CreateInternalAccount
Create Mambu internal account
Type (own or virtual), Name, Holder name, Account number
CreateExternalAccount
Create Mambu external account
Holder name, Account number, Bank code (BIC, UK sort code, US routing number or local equivalent)
CreatePaymentOrder
Create Mambu payment order
Type (for example sepa_credit_transfer), Direction (credit or debit), Amount (integer, in the currency’s smallest unit), Currency (ISO 4217), Reference, Connected account id
Single-scope actions that update the resource whose id is in record_id_field. Every form field is optional: an empty field keeps the current value, and an empty form is refused.
Plugin
Default label
Form fields
UpdateAccountHolder
Update Mambu account holder
Name
UpdateInternalAccount
Update Mambu internal account
Name, Holder name, Account number
UpdateExternalAccount
Update Mambu external account
Holder name, Account number, Bank code
Payment order and verification actions
These actions act on every selected record and call the API once per id. A failure on one id does not stop the others: the success message counts the records processed and lists the ids that failed (the failure details go to the log). The action reports an error only when every id failed, and that error carries the API’s message for the first failure.
Plugin
Labels (single / bulk)
Behavior
ApprovePaymentOrder
Approve Mambu payment order / Approve selected Mambu payment orders
Calls POST /payment_orders/{id}/approve. The API only approves orders in status pending_approval.
CancelPaymentOrder
Cancel Mambu payment order / Cancel selected Mambu payment orders
Calls POST /payment_orders/{id}/cancel. Optional form field: Reason, a reason code used for SEPA direct debits only.
TriggerPayeeVerification
Trigger payee verification / Trigger payee verification on selected accounts
Calls POST /external_accounts/{id}/verify. The verification is asynchronous: the account moves to pending_verification and the result arrives later through Mambu Payments.
Update actions follow the same per-id behavior. A create action makes a single call: when the API rejects it, the action fails with the API’s own error message.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Forest Documentation","colors":{"primary":"#3F5B1E","light":"#DDF327","dark":"#3F5B1E"},"logo":{"light":"https://mintcdn.com/forest/ZO8t9buUjTuKyt-F/images/Standard.svg?fit=max\u0026auto=format\u0026n=ZO8t9buUjTuKyt-F\u0026q=85\u0026s=d4e172941c964df57009cfa8be809b96","dark":"https://mintcdn.com/forest/ZO8t9buUjTuKyt-F/images/LIME.svg?fit=max\u0026auto=format\u0026n=ZO8t9buUjTuKyt-F\u0026q=85\u0026s=91e95470256b93527860cba6c206cbc4"},"favicon":{"light":"https://mintcdn.com/forest/ZO8t9buUjTuKyt-F/images/Standard.svg?fit=max\u0026auto=format\u0026n=ZO8t9buUjTuKyt-F\u0026q=85\u0026s=d4e172941c964df57009cfa8be809b96","dark":"https://mintcdn.com/forest/ZO8t9buUjTuKyt-F/images/LIME.svg?fit=max\u0026auto=format\u0026n=ZO8t9buUjTuKyt-F\u0026q=85\u0026s=91e95470256b93527860cba6c206cbc4"},"navbar":{"links":[{"href":"mailto:support@forestadmin.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.forestadmin.com"}},"footer":{"socials":{"twitter":"https://twitter.com/forest_admin","github":"https://github.com/ForestAdmin","linkedin":"https://linkedin.com/company/forestadmin"}},"contextual":{"options":["copy","view","claude","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"forest","hasAudioNarration":false,"actualSubdomain":"forest","customDomains":["docs.forest.app"],"gitSource":{"type":"github","owner":"forestadmin","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc56e220d97acf6c36953d","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Legacy","count":289},{"language":"default","tag":"JavaScript Agents","count":141},{"language":"default","tag":"Ruby Agent","count":140},{"language":"default","tag":"Product","count":115},{"language":"default","tag":"Integrations","count":64},{"language":"default","tag":"Actions","count":48},{"language":"default","tag":"Smart Action Examples","count":34},{"language":"default","tag":"Connect","count":32},{"language":"default","tag":"Process","count":32},{"language":"default","tag":"Upgrade","count":31}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@forestadmin.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"product/process/advanced-concepts/plugins/mambu-payments","slug":"/product/process/advanced-concepts/plugins/mambu-payments","pageMetadata":{"title":"Mambu Payments plugins","description":"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource","href":"/product/process/advanced-concepts/plugins/mambu-payments"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Mambu Payments connector ships three families of plugins on top of the `,_jsx(_components.a,{href:`/get-started/connect/data-sources/mambu-payments`,children:`Mambu Payments datasource`}),`: `,_jsx(_components.code,{children:`DisableSearch`}),`, relation plugins that add the links the Numeral API does not expose natively, and action plugins that expose payment operations (create, approve, cancel, verify) as actions.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The Mambu Payments connector is only available for Ruby (gem `,_jsx(_components.code,{children:`forest_admin_datasource_mambu_payments`}),`).`]})}),`\n`,_jsxs(_components.p,{children:[`Nothing is registered automatically: opt each plugin in. `,_jsx(_components.code,{children:`DisableSearch`}),` and the relation plugins install `,_jsx(_components.strong,{children:`at the datasource level`}),` (`,_jsx(_components.code,{children:`@create_agent.use`}),`), and raise an `,_jsx(_components.code,{children:`ArgumentError`}),` when installed on a single collection. The action plugins install `,_jsx(_components.strong,{children:`at the collection level`}),` (`,_jsx(_components.code,{children:`collection.use`}),`) and take the registered `,_jsx(_components.code,{children:`Datasource`}),` instance as their `,_jsx(_components.code,{children:`datasource`}),` option.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`ruby`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`ruby`,children:_jsxs(_components.code,{language:`ruby`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# app/lib/forest_admin_rails/create_agent.rb`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`mambu`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ForestAdminDatasourceMambuPayments`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Datasource`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`new`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`api_key:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` ENV`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'MAMBU_PAYMENTS_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`])`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ForestAdminAgent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Builder`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`AgentFactory`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`instance`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`add_datasource`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(mambu, {})`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`plugins`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ForestAdminDatasourceMambuPayments`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`Plugins`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Datasource level`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`DisableSearch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {})`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Relations`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`LinkExternalAccountToPaymentOrders`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {})`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Relations`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`LinkPaymentOrderToTransactions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {})`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Collection level`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`customize_collection`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'MambuPaymentOrder'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`do`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`collection`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`|`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` collection.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`SmartActions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`ApprovePaymentOrder`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`datasource:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` mambu, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`record_id_field:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` collection.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`SmartActions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`CancelPaymentOrder`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`datasource:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` mambu, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`record_id_field:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`end`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`disable-search`,children:`Disable search`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ForestAdminDatasourceMambuPayments::Plugins::DisableSearch`}),` removes the search bar from all 17 Mambu collections. The Numeral API has no free-text search, and the `,_jsx(_components.code,{children:`OR`}),` condition Forest builds to emulate one is refused by the datasource, so without this plugin a search returns an error.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`ruby`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`ruby`,children:_jsxs(_components.code,{language:`ruby`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`ForestAdminDatasourceMambuPayments`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`DisableSearch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {})`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`relation-plugins`,children:`Relation plugins`}),`\n`,_jsxs(_components.p,{children:[`Every relation plugin lives under `,_jsx(_components.code,{children:`ForestAdminDatasourceMambuPayments::Plugins::Relations`}),` and takes no option: `,_jsx(_components.code,{children:`@create_agent.use(\u003cplugin>, {})`}),`. Install only the links you need — each one adds API calls when the relation is displayed.`]}),`\n`,_jsx(Heading,{level:`3`,id:`direct-links`,children:`Direct links`}),`\n`,_jsx(_components.p,{children:`The target collection already carries the foreign key, so these plugins only declare the one-to-many relation on the host.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plugin`}),_jsx(_components.th,{children:`Adds`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkExternalAccountToPaymentOrders`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuExternalAccount.payment_orders`}),` (origin key `,_jsx(_components.code,{children:`receiving_account_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkExternalAccountToIncomingPayments`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuExternalAccount.incoming_payments`}),` (origin key `,_jsx(_components.code,{children:`external_account_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkExternalAccountToDirectDebitMandates`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuExternalAccount.direct_debit_mandates`}),` (origin key `,_jsx(_components.code,{children:`external_account_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkInternalAccountToIncomingPayments`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuInternalAccount.incoming_payments`}),` (origin key `,_jsx(_components.code,{children:`internal_account_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkPaymentOrderToEvents`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuPaymentOrder.events`}),` (origin key `,_jsx(_components.code,{children:`MambuEvent.related_object_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkPaymentOrderToReturns`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuPaymentOrder.returns`}),` (origin key `,_jsx(_components.code,{children:`MambuReturn.related_payment_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkIncomingPaymentToEvents`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuIncomingPayment.events`}),` (origin key `,_jsx(_components.code,{children:`MambuEvent.related_object_id`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkIncomingPaymentToReturns`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuIncomingPayment.returns`}),` (origin key `,_jsx(_components.code,{children:`MambuReturn.related_payment_id`}),`)`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`account-holder-links`,children:`Account holder links`}),`\n`,_jsxs(_components.p,{children:[`An account holder is reached through an account. These plugins import `,_jsx(_components.code,{children:`account_holder_id`}),` from the related account (read-only), add a many-to-one to `,_jsx(_components.code,{children:`MambuAccountHolder`}),` on the host, and add the reverse one-to-many on `,_jsx(_components.code,{children:`MambuAccountHolder`}),`. A filter on the holder is resolved by listing the intermediate accounts of that holder first.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plugin`}),_jsx(_components.th,{children:`Adds on the host`}),_jsxs(_components.th,{children:[`Adds on `,_jsx(_components.code,{children:`MambuAccountHolder`})]}),_jsx(_components.th,{children:`Through`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkAccountHolderToIncomingPayments`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuIncomingPayment.account_holder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`incoming_payments`})}),_jsx(_components.td,{children:`the internal account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkAccountHolderToDirectDebitMandates`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuDirectDebitMandate.account_holder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`direct_debit_mandates`})}),_jsx(_components.td,{children:`the external account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkPaymentOrderToReceivingAccountHolder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuPaymentOrder.receiving_account_holder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`payment_orders`})}),_jsx(_components.td,{children:`the receiving external account`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`links-resolved-through-an-intermediate-collection`,children:`Links resolved through an intermediate collection`}),`\n`,_jsxs(_components.p,{children:[`The target collection has no foreign key to the host at all. These plugins add a virtual foreign key column on the target — always empty on a record, filterable with `,_jsx(_components.code,{children:`EQUAL`}),` and `,_jsx(_components.code,{children:`IN`}),` only — and the one-to-many on the host. Opening the relation lists the intermediate collection first, then filters the target on the ids it found.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plugin`}),_jsx(_components.th,{children:`Adds`}),_jsx(_components.th,{children:`Resolved through`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkPaymentOrderToTransactions`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuPaymentOrder.transactions`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuReconciliation`}),` (reconciliations of the payment order)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkIncomingPaymentToTransactions`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuIncomingPayment.transactions`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuReconciliation`}),` (reconciliations of the incoming payment)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkIncomingPaymentToExpectedPayments`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuIncomingPayment.matched_expected_payments`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MambuReconciliation`}),`, twice: the transactions reconciled with the incoming payment, then the expected payments reconciled with those transactions`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkInternalAccountToBalances`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuInternalAccount.balances`})}),_jsxs(_components.td,{children:[`the internal account’s `,_jsx(_components.code,{children:`connected_account_ids`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`LinkInternalAccountToPaymentOrders`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MambuInternalAccount.payment_orders`})}),_jsxs(_components.td,{children:[`the internal account’s `,_jsx(_components.code,{children:`connected_account_ids`})]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`LinkInternalAccountToBalances`}),` and `,_jsx(_components.code,{children:`LinkInternalAccountToPaymentOrders`}),` resolve through the connected accounts: they list every balance or payment order of the connected accounts the internal account belongs to, not only the ones tied to that internal account.`]})}),`\n`,_jsx(_components.p,{children:`A resolution reads at most 10,000 intermediate records and logs a warning when it reaches that cap.`}),`\n`,_jsx(Heading,{level:`2`,id:`action-plugins`,children:`Action plugins`}),`\n`,_jsxs(_components.p,{children:[`Every action plugin lives under `,_jsx(_components.code,{children:`ForestAdminDatasourceMambuPayments::Plugins::SmartActions`}),`, installs on any collection with `,_jsx(_components.code,{children:`collection.use`}),`, and requires the `,_jsx(_components.code,{children:`datasource`}),` option. The host collection does not need to be a Mambu collection: an action plugin reads the Mambu id from the column you name in `,_jsx(_components.code,{children:`record_id_field`}),`, so a collection of your own database that stores a Mambu id works as well as the Mambu collection itself.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Applies to`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`datasource`})}),_jsx(_components.td,{children:`all`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Required.`}),` The `,_jsx(_components.code,{children:`ForestAdminDatasourceMambuPayments::Datasource`}),` instance.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`record_id_field`})}),_jsx(_components.td,{children:`update, approve, cancel, verify`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Required.`}),` Column of the host collection holding the Mambu id to act on — `,_jsx(_components.code,{children:`'id'`}),` on the Mambu collection itself.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`action_name`})}),_jsx(_components.td,{children:`create, update`}),_jsx(_components.td,{children:`Overrides the action label.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`result_field`})}),_jsx(_components.td,{children:`create`}),_jsx(_components.td,{children:`Writable column of the host record that receives the id of the created resource. Best-effort: a failed write-back is logged and reported in the success message, without rolling back the creation.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`scopes`})}),_jsx(_components.td,{children:`approve, cancel, verify`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`[:single]`}),`, `,_jsx(_components.code,{children:`[:bulk]`}),` or both (default). Registers one action per scope.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`create-actions`,children:`Create actions`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Single`}),`-scope actions that create a resource from the values of their form.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plugin`}),_jsx(_components.th,{children:`Default label`}),_jsx(_components.th,{children:`Form fields (all required)`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CreateAccountHolder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Create Mambu account holder`})}),_jsx(_components.td,{children:`Name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CreateInternalAccount`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Create Mambu internal account`})}),_jsxs(_components.td,{children:[`Type (`,_jsx(_components.code,{children:`own`}),` or `,_jsx(_components.code,{children:`virtual`}),`), Name, Holder name, Account number`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CreateExternalAccount`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Create Mambu external account`})}),_jsx(_components.td,{children:`Holder name, Account number, Bank code (BIC, UK sort code, US routing number or local equivalent)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CreatePaymentOrder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Create Mambu payment order`})}),_jsxs(_components.td,{children:[`Type (for example `,_jsx(_components.code,{children:`sepa_credit_transfer`}),`), Direction (`,_jsx(_components.code,{children:`credit`}),` or `,_jsx(_components.code,{children:`debit`}),`), Amount (integer, in the currency’s smallest unit), Currency (ISO 4217), Reference, Connected account id`]})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`ruby`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`ruby`,children:_jsxs(_components.code,{language:`ruby`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`customize_collection`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Customer'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`do`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`collection`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`|`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` collection.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ForestAdminDatasourceMambuPayments`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`SmartActions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`CreateAccountHolder`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`datasource:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` mambu, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`result_field:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'mambu_account_holder_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` )`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`end`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`update-actions`,children:`Update actions`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Single`}),`-scope actions that update the resource whose id is in `,_jsx(_components.code,{children:`record_id_field`}),`. Every form field is optional: an empty field keeps the current value, and an empty form is refused.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plugin`}),_jsx(_components.th,{children:`Default label`}),_jsx(_components.th,{children:`Form fields`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UpdateAccountHolder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Update Mambu account holder`})}),_jsx(_components.td,{children:`Name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UpdateInternalAccount`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Update Mambu internal account`})}),_jsx(_components.td,{children:`Name, Holder name, Account number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UpdateExternalAccount`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Update Mambu external account`})}),_jsx(_components.td,{children:`Holder name, Account number, Bank code`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`payment-order-and-verification-actions`,children:`Payment order and verification actions`}),`\n`,_jsx(_components.p,{children:`These actions act on every selected record and call the API once per id. A failure on one id does not stop the others: the success message counts the records processed and lists the ids that failed (the failure details go to the log). The action reports an error only when every id failed, and that error carries the API’s message for the first failure.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plugin`}),_jsx(_components.th,{children:`Labels (single / bulk)`}),_jsx(_components.th,{children:`Behavior`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ApprovePaymentOrder`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Approve Mambu payment order`}),` / `,_jsx(_components.code,{children:`Approve selected Mambu payment orders`})]}),_jsxs(_components.td,{children:[`Calls `,_jsx(_components.code,{children:`POST /payment_orders/{id}/approve`}),`. The API only approves orders in status `,_jsx(_components.code,{children:`pending_approval`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CancelPaymentOrder`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Cancel Mambu payment order`}),` / `,_jsx(_components.code,{children:`Cancel selected Mambu payment orders`})]}),_jsxs(_components.td,{children:[`Calls `,_jsx(_components.code,{children:`POST /payment_orders/{id}/cancel`}),`. Optional form field: Reason, a reason code used for SEPA direct debits only.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`TriggerPayeeVerification`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Trigger payee verification`}),` / `,_jsx(_components.code,{children:`Trigger payee verification on selected accounts`})]}),_jsxs(_components.td,{children:[`Calls `,_jsx(_components.code,{children:`POST /external_accounts/{id}/verify`}),`. The verification is asynchronous: the account moves to `,_jsx(_components.code,{children:`pending_verification`}),` and the result arrives later through Mambu Payments.`]})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`ruby`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`ruby`,children:_jsxs(_components.code,{language:`ruby`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`@create_agent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`customize_collection`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'MambuExternalAccount'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`do`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`collection`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`|`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` collection.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`use`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ForestAdminDatasourceMambuPayments`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Plugins`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`SmartActions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#4EC9B0`},children:`::`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`TriggerPayeeVerification`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`datasource:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` mambu, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`record_id_field:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`scopes:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`:single`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` )`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`end`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Update actions follow the same per-id behavior. A create action makes a single call: when the API rejects it, the action fails with the API’s own error message.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Mambu Payments plugins","description":"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource","href":"/product/process/advanced-concepts/plugins/mambu-payments"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Disable search","slug":"disable-search","depth":2,"children":[]},{"title":"Relation plugins","slug":"relation-plugins","depth":2,"children":[{"title":"Direct links","slug":"direct-links","depth":3,"children":[]},{"title":"Account holder links","slug":"account-holder-links","depth":3,"children":[]},{"title":"Links resolved through an intermediate collection","slug":"links-resolved-through-an-intermediate-collection","depth":3,"children":[]}]},{"title":"Action plugins","slug":"action-plugins","depth":2,"children":[{"title":"Create actions","slug":"create-actions","depth":3,"children":[]},{"title":"Update actions","slug":"update-actions","depth":3,"children":[]},{"title":"Payment order and verification actions","slug":"payment-order-and-verification-actions","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"forest","siteName":"Forest Documentation","title":"Mambu Payments plugins - Forest Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T13:29:00.184Z","originalFileLocation":"product/process/advanced-concepts/plugins/mambu-payments.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource\">\u003cmeta data-mint-head name=\"application-name\" content=\"Forest Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Mambu Payments plugins - Forest Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Forest Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://forest.mintlify.site/_mintlify/api/og/v2?division=Plugins\u0026amp;title=Mambu+Payments+plugins\u0026amp;description=Add+reverse+relations%2C+disable+search+and+expose+payment+operations+as+actions+on+top+of+the+Mambu+Payments+datasource\u0026amp;theme=5ff2aad1d7ae12d0b1ff840d\u0026amp;signature=6868704a0609ea4cf27c87c6cc932ed29b1bfbccd0514917094bffe516368a64\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Mambu Payments plugins - Forest Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://forest.mintlify.site/_mintlify/api/og/v2?division=Plugins\u0026amp;title=Mambu+Payments+plugins\u0026amp;description=Add+reverse+relations%2C+disable+search+and+expose+payment+operations+as+actions+on+top+of+the+Mambu+Payments+datasource\u0026amp;theme=5ff2aad1d7ae12d0b1ff840d\u0026amp;signature=6868704a0609ea4cf27c87c6cc932ed29b1bfbccd0514917094bffe516368a64\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/forest/9euPPsOQWnB89Kt3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Forest Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3F5B1E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/product/process/advanced-concepts/plugins/mambu-payments.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.forest.app/#organization\",\"name\":\"Forest Documentation\",\"url\":\"https://docs.forest.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/forest/ZO8t9buUjTuKyt-F/images/Standard.svg?fit=max\u0026auto=format\u0026n=ZO8t9buUjTuKyt-F\u0026q=85\u0026s=d4e172941c964df57009cfa8be809b96\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.forest.app#website\",\"name\":\"Forest Documentation\",\"url\":\"https://docs.forest.app\",\"publisher\":{\"@id\":\"https://docs.forest.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments#webpage\",\"url\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments\",\"name\":\"Mambu Payments plugins\",\"description\":\"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource\",\"dateModified\":\"2026-11-17T13:29:00.184Z\",\"isPartOf\":{\"@id\":\"https://docs.forest.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Process\",\"item\":\"https://docs.forest.app/product/process/actions/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Advanced Concepts\",\"item\":\"https://docs.forest.app/product/process/advanced-concepts/hooks/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Plugins\",\"item\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/overview\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Mambu Payments plugins\",\"item\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments#article\",\"headline\":\"Mambu Payments plugins\",\"name\":\"Mambu Payments plugins\",\"description\":\"Add reverse relations, disable search and expose payment operations as actions on top of the Mambu Payments datasource\",\"url\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments\",\"mainEntityOfPage\":{\"@id\":\"https://docs.forest.app/product/process/advanced-concepts/plugins/mambu-payments#webpage\"},\"dateModified\":\"2026-11-17T13:29:00.184Z\",\"publisher\":{\"@id\":\"https://docs.forest.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.forest.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Forest Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Forest Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/product/process/advanced-concepts/plugins/mambu-payments.md","siteName":"Forest Documentation","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Get Started","pages":[{"title":"Get Started","href":"/get-started/intro-to-forest-admin"}]},{"tab":"Product","groups":[{"group":"Overview","pages":[{"title":"Product","href":"/product/overview"}]},{"group":"Connect","pages":[{"title":"Overview","href":"/get-started/connect/overview"},{"title":"Architecture","href":"/get-started/connect/architectures/self-hosted"},{"title":"Deployment options","href":"/get-started/connect/architectures/deployment-options"},{"group":"Data Sources","pages":[{"title":"Add datasources to your project","href":"/get-started/connect/data-sources/overview"},{"title":"SQL datasource","href":"/get-started/connect/data-sources/sql"},{"title":"Sequelize datasource","href":"/get-started/connect/data-sources/sequelize"},{"title":"Mongoose datasource","href":"/get-started/connect/data-sources/mongoose"},{"title":"MongoDB datasource","href":"/get-started/connect/data-sources/mongodb"},{"title":"Dummy datasource","href":"/get-started/connect/data-sources/dummy"},{"title":"ActiveRecord datasource","href":"/get-started/connect/data-sources/active-record"},{"title":"Mongoid datasource","href":"/get-started/connect/data-sources/mongoid"},{"title":"Hubspot","href":"/get-started/connect/data-sources/hubspot"},{"title":"Elasticsearch","href":"/get-started/connect/data-sources/elasticsearch"},{"title":"Airtable","href":"/get-started/connect/data-sources/airtable"},{"title":"Stripe","href":"/get-started/connect/data-sources/stripe"},{"title":"RPC","href":"/get-started/connect/data-sources/rpc"},{"title":"GraphQL / Hasura","href":"/get-started/connect/data-sources/graphql-hasura"},{"title":"CosmosDB","href":"/get-started/connect/data-sources/cosmosdb"},{"title":"DynamoDB datasource","href":"/get-started/connect/data-sources/dynamodb"},{"title":"Snowflake","href":"/get-started/connect/data-sources/snowflake"},{"title":"Pylon","href":"/get-started/connect/data-sources/pylon"},{"title":"Intercom","href":"/get-started/connect/data-sources/intercom"},{"title":"Zendesk","href":"/get-started/connect/data-sources/zendesk"},{"title":"Mambu Payments","href":"/get-started/connect/data-sources/mambu-payments"},{"group":"Custom datasources","pages":[{"title":"Overview","href":"/get-started/connect/data-sources/custom-datasources/overview"},{"title":"Translation","href":"/get-started/connect/data-sources/custom-datasources/translation"},{"title":"Replication","href":"/get-started/connect/data-sources/custom-datasources/replication"}]}]},{"group":"Integrations","pages":[{"title":"All integrations","href":"/get-started/connect/integrations/overview"},{"title":"MCP Connectors","href":"/get-started/connect/integrations/mcp-servers"},{"title":"Forest Gateway","href":"/product/embed/gateway"},{"title":"Standalone Forest Gateway","href":"/product/embed/gateway-standalone"},{"title":"Zendesk App","href":"/product/embed/zendesk"},{"title":"n8n Node","href":"/product/embed/n8n"}]},{"group":"Advanced Concepts","pages":[{"title":"Environment Variables","href":"/get-started/connect/environment-variables"},{"title":"Data Types","href":"/get-started/connect/data-types"},{"title":"Relationships","href":"/get-started/connect/relationships-schema"},{"title":"TypeScript Autocompletion","href":"/get-started/connect/typescript-autocompletion"},{"title":".forestadmin-schema.json","href":"/reference/schema/forestadmin-schema"}]}]},{"group":"Process","pages":[{"group":"Actions","pages":[{"title":"Overview","href":"/product/process/actions/overview"},{"title":"No-code actions","hidden":true,"href":"/product/process/actions/nocode-actions"},{"group":"Code-based actions","pages":[{"title":"Overview","href":"/product/process/actions/custom-actions/overview"},{"title":"Forms","href":"/product/process/actions/custom-actions/forms"},{"title":"Result types","href":"/product/process/actions/custom-actions/result-types"},{"title":"Context \u0026 scope","href":"/product/process/actions/custom-actions/context-scope"},{"title":"Related data invalidation","href":"/product/process/actions/custom-actions/related-data-invalidation"}]}]},{"group":"Fields","pages":[{"title":"Overview","href":"/product/process/fields/overview"},{"title":"Computed fields","href":"/product/process/fields/computed"},{"title":"Import, rename \u0026 remove fields","href":"/product/process/fields/import-rename-remove"},{"title":"Field validation","href":"/product/process/fields/validation"},{"title":"Writing behavior","href":"/product/process/fields/write"},{"title":"Filtering \u0026 Sorting","href":"/product/process/fields/filter"},{"title":"Binary fields","href":"/product/process/fields/binary"}]},{"group":"Segments","pages":[{"title":"Creating segments","href":"/product/process/segments/creating-segments"},{"title":"Code-based segments","href":"/product/process/segments/smart-segments/overview"}]},{"group":"Relationships","pages":[{"title":"Overview","href":"/product/process/relationships/overview"},{"title":"Single-record relationships","href":"/product/process/relationships/single-record"},{"title":"Multiple-records relationships","href":"/product/process/relationships/multiple-records"},{"title":"Computed foreign keys","href":"/product/process/relationships/computed-fks"},{"title":"Under the hood","href":"/product/process/relationships/under-the-hood"}]},{"group":"Workflows","pages":[{"title":"Workflows","href":"/product/process/workflows/overview"},{"title":"Workflow triggers","href":"/product/process/workflows/triggers"},{"title":"Run a workflow on data change","sidebarTitle":"On data change","href":"/product/process/workflows/automated-inboxes"},{"title":"Forest Runtime","href":"/product/process/workflows/forest-runtime"}]},{"group":"Advanced Concepts","pages":[{"title":"Hooks","href":"/product/process/advanced-concepts/hooks/overview"},{"group":"Plugins","pages":[{"title":"Plugins","href":"/product/process/advanced-concepts/plugins/overview"},{"title":"Active Storage","description":"Expose Rails Active Storage attachments as File fields in Forest","href":"/product/process/advanced-concepts/plugins/active-storage"},{"title":"Mambu Payments plugins","href":"/product/process/advanced-concepts/plugins/mambu-payments"},{"title":"Pylon plugins","description":"Surface Pylon operations as actions on any collection (create, reply to and close issues)","href":"/product/process/advanced-concepts/plugins/pylon"},{"title":"Zendesk plugins","href":"/product/process/advanced-concepts/plugins/zendesk"}]},{"title":"Testing your back-end","href":"/product/process/advanced-concepts/testing"},{"group":"Developer Workflow","pages":[{"title":"Environments \u0026 branches","href":"/product/process/advanced-concepts/developer-workflow/environments-and-branches"},{"title":"Schema updates","href":"/product/process/advanced-concepts/developer-workflow/schema-updates"},{"title":"TypeScript setup \u0026 autocompletion","href":"/product/process/advanced-concepts/developer-workflow/typescript-setup"}]}]}]},{"group":"Build","pages":[{"title":"Layout editor","href":"/product/build/layout-editor"},{"title":"Collection configuration","href":"/product/build/collection-configuration"},{"group":"Workspaces","pages":[{"title":"Workspaces","href":"/product/build/workspaces"},{"title":"Example 1: KYC","href":"/product/build/workspaces/kyc"},{"title":"Example 2: Incident Management","href":"/product/build/workspaces/incident-management"}]},{"title":"Dashboards","href":"/product/manage/dashboards"},{"title":"Fields \u0026 widgets","href":"/product/build/fields-and-widgets/overview"},{"group":"Advanced Concepts","pages":[{"title":"Layout versioning","href":"/product/build/layout-versioning"},{"title":"Smart views","href":"/product/build/custom-views/smart-views"},{"title":"Search Configuration","href":"/product/build/search-configuration"},{"title":"Pagination Configuration","href":"/product/build/pagination"}]}]},{"group":"Execute","pages":[{"title":"Browsing \u0026 searching data","href":"/product/execute/browse"},{"title":"Executing actions","href":"/product/execute/actions"},{"title":"Executing workflows","href":"/product/execute/workflows"},{"title":"Export data","href":"/product/execute/export"}]},{"group":"Collaborate","pages":[{"title":"Approval workflows","href":"/product/collaborate/approval-workflows"},{"title":"Notes","href":"/product/collaborate/notes"}]},{"group":"Manage","pages":[{"title":"Team performance","href":"/product/manage/team-performance"},{"title":"Inbox","href":"/product/manage/inbox"},{"title":"Charts","href":"/product/manage/charts/overview"},{"title":"Smart Charts","href":"/product/manage/charts/smart-charts"}]},{"group":"Embed","pages":[{"title":"Forest MCP Server","href":"/product/embed/mcp-server"},{"title":"Forest Gateway","href":"/product/embed/gateway"},{"title":"Standalone Forest Gateway","href":"/product/embed/gateway-standalone"},{"title":"Zendesk App","href":"/product/embed/zendesk"},{"title":"n8n Node","href":"/product/embed/n8n"}]},{"group":"Control","pages":[{"title":"Roles \u0026 Permissions","href":"/get-started/control/roles-permissions"},{"title":"Teams","href":"/get-started/control/teams"},{"title":"Scopes","href":"/get-started/control/scopes-and-visibility"},{"title":"Audit \u0026 Activity Logs","href":"/get-started/control/audit"},{"title":"Audit Trail","href":"/get-started/control/audit-trail"},{"group":"Authentication","pages":[{"title":"Single Sign-On (SSO)","href":"/get-started/control/authentication/sso"},{"group":"SSO Providers","pages":[{"title":"SSO Provider Guides","href":"/get-started/control/authentication/sso-providers/overview"},{"title":"Google Workspace SSO","href":"/get-started/control/authentication/sso-providers/google"},{"title":"Okta SSO","href":"/get-started/control/authentication/sso-providers/okta"},{"title":"Azure AD / Entra ID SSO","href":"/get-started/control/authentication/sso-providers/azure"},{"title":"Generic SAML 2.0 SSO","href":"/get-started/control/authentication/sso-providers/generic-saml"}]},{"title":"Two-Factor Authentication (2FA)","href":"/get-started/control/authentication/2fa"},{"group":"SCIM Provisioning","pages":[{"title":"SCIM Integration with Okta","href":"/get-started/control/authentication/scim-okta"},{"title":"SCIM Integration with OneLogin","href":"/get-started/control/authentication/scim-onelogin"},{"title":"Manual SCIM Integration with Okta","href":"/get-started/control/authentication/scim-okta-manual"}]}]},{"group":"Security","pages":[{"title":"Security \u0026 Privacy Architecture","href":"/get-started/control/security/architecture"},{"title":"IP Whitelisting","href":"/get-started/control/security/ip-whitelisting"},{"title":"Auto Logout","href":"/get-started/control/security/auto-logout"},{"title":"Two-Factor Authentication Enforcement","href":"/get-started/control/security/2fa-enforcement"}]}]},{"group":"Project Settings","pages":[{"title":"General Settings","href":"/get-started/project-settings/general"},{"title":"User Management","href":"/get-started/project-settings/users"},{"title":"Service Accounts","href":"/get-started/project-settings/service-accounts"},{"title":"Interface \u0026 Branding","href":"/get-started/project-settings/interface"}]}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/overview"}]},{"tab":"Legacy","pages":[{"title":"Legacy","href":"/legacy/agents-overview"}]}]},"basePath":"","title":"Mambu Payments plugins - Forest Documentation","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}