Auto-configuration

Have the configuration you agreed with PayMongo, such as rates, fees, payouts, and tax settings, applied to every child account you create.

Who this section is for

Business, product, and engineering teams at businesses building platforms that have agreed a configuration with PayMongo, such as preferential rates or a payout schedule, and want every child account they create to receive it automatically.

What it is

Auto-configuration applies a configuration agreed between your platform and PayMongo at the parent level. Every child your parent creates receives that configuration when it is activated. Without auto-configuration, the configuration has to be set up per child.

It applies only to accounts your parent creates with the Create an account path, and takes effect on activation. It does not apply to existing accounts you link by invitation.

flowchart LR
  A[Parent agrees terms with PayMongo] --> B[Child created]
  B --> C[Child activated]
  C --> D[Configuration applied automatically]

Supported configurations

ConfigurationWhat it applies to each new child
Preferential ratesThe payment rates agreed with PayMongo.
Transfer feesThe transfer fees agreed with PayMongo.
Instant Settlement feesThe Instant Settlement fees agreed with PayMongo.
Payout destination and scheduleWhere and how often the child's funds are paid out.
Child dashboard accessWhether the child's authorized representative can sign in to the Dashboard. See Disable dashboard access.
Tax configurationsThe tax settings agreed for the child's transactions.

More configurations will be supported soon. Contact [email protected] for more information.

Configurations are set up under a Memorandum of Agreement (MOA) or conforme that PayMongo provides for you to sign. After PayMongo receives and reviews your request, a sales representative reaches out to you.

⚠️

Auto-configuration does not activate capabilities

Auto-configuration does not activate payment methods or other capabilities. A child starts with the default capabilities provisioned at activation. To add more, use the capability request flow. See Account capabilities.

Why it matters

  • Consistency. Every child you create receives the same agreed configuration.
  • Operational simplicity. No per-child requests to apply the configuration.
  • Ready at activation. The configuration is in place the moment activation completes.

Current state

📘

Available by email request

Email [email protected] with:

  1. Your parent account ID (org_…).
  2. The configurations you want applied (see Supported configurations).

After reviewing your request, a PayMongo sales representative reaches out with the MOA or conforme to sign. Once it is signed, PayMongo applies the configuration, and every child your parent creates from then on receives it on activation.

Auto-configuration is a blanket setting: it is scoped to your parent account and applies to every child you create. Exceptions for specific accounts are not supported. To change the configuration after it is set up, contact the account manager who handled your review and MOA.

Roadmap

🚀

Coming soon

  • Self-serve from the Dashboard. Set up and edit auto-configuration without contacting support.

Frequently asked

Does auto-configuration change anything in my code?

No. The Accounts API flow stays the same. Auto-configuration changes what PayMongo applies during activation, not how you call the API.

Does auto-configuration turn on payment methods for my children?

No. It applies agreed configurations such as rates, fees, and payout settings only. Request payment methods and other capabilities per child through Account capabilities.

Can I enable auto-configuration retroactively?

Auto-configuration applies to new children your parent creates after it is enabled. For existing children, contact your account manager.

Does it apply to accounts I link by invitation?

No. It applies only to accounts your parent creates with the Accounts API, not to existing accounts that join through an invitation.

Related pages


Did this page help you?