Children policies
A children policy defines the operating choices an app may grant to its child apps. It is an authority boundary, not the configuration applied to a child: the children policy lists permitted values and ranges, while an operating policy selects concrete values from within those constraints.
This feature is available to selected accounts during private beta.
How children policies govern child apps
The app's active children policy governs the reusable operating policies and inline configurations it can apply while creating a child. Inttegro validates the concrete operating configuration against the parent's latest active children policy before saving an immutable snapshot for the child app. The application relationship is not returned on the children-policy object.
Children policies use immutable versions. id is stable across versions, version identifies the returned record, and active_version identifies the version currently governing new policy decisions. Look up a children policy version by number, or omit version to return the latest active version. Page children policy versions returns the complete history newest first.
Each capability expresses authority differently from an operating policy:
- Payment currencies are the currency values a child configuration may select.
- Payment and payout amount limits are inclusive ranges in minor currency units.
- Payout
enabledvalues list whether enabled, disabled, or both are permitted. - Payout balance-transaction aging entries include the platform-owned public identifier and its resolved
t_plusduration. - Payment-method
enabledandconfirms_usevalues list the booleans that an operating policy may select.
The children policy object
Properties
- Name
activeVersion- Type
number- Description
Latest active version of this policy.
capabilitiesChildrenPolicyCapabilitiesClick or tap to expandPermitted payment, payout, and payment-method options for child operating configurations. At least one capability group is present.
- Name
createdAt- Type
Date- Description
When version one of the policy was created.
- Name
description- Type
string- Description
Optional explanation of the authority granted by the policy.
- Name
id- Type
string- Description
Stable policy identifier beginning with
cp_.
- Name
name- Type
string- Description
Human-readable policy name.
- Name
updatedAt- Type
Date- Description
When the active version last changed.
- Name
version- Type
number- Description
Immutable version represented by this object.
- Name
versionCreatedAt- Type
Date- Description
When this exact immutable version was created.
Capability properties
paymentMethodsChildrenPolicyPaymentMethodsCapabilitiesClick or tap to expandOptional settings authority for each supported payment method. Each included method has
confirms_useandenabledarrays containing its permitted boolean values.paymentsChildrenPolicyPaymentsCapabilitiesClick or tap to expandOptional payment authority.
currenciescontains unique lowercase three-letter currency codes.limits.amount.maxandlimits.amount.mindefine the inclusive minor-unit range.payoutsChildrenPolicyPayoutsCapabilitiesClick or tap to expandOptional payout authority.
bt_aging_speclists the permitted platform aging specifications,enabledlists permitted boolean values, andlimits.amountdefines the inclusive minor-unit range.
Look up a children policy version
Returns one children policy version. Omit version to return the latest active version.
Request body
Response
The response contains the requested policy version in children_policy.
Request
import { InttegroClient } from '@inttegro/inttegro-sdk'
const apiKey = process.env.INTTEGRO_API_KEY
if (!apiKey) throw new Error('INTTEGRO_API_KEY is required')
const inttegro = new InttegroClient({ apiKey })
const childrenPolicy = await inttegro.childrenPolicies.lookup({ version: 2 })
Response
- Object
- JSON
ChildrenPolicyResponse {
childrenPolicy: { … },
}
{
"children_policy": {
"active_version": 3,
"capabilities": { … },
"created_at": "2026-10-01T09:00:00Z",
"description": "Authority for standard child merchant accounts.",
"id": "cp_36vCQl1XPkXvtFGbK5KZ4dZF4lvwURGFoCCqhUcp",
"name": "Standard child operating authority",
"updated_at": "2026-11-01T14:30:00Z",
"version": 2,
"version_created_at": "2026-10-20T11:00:00Z"
}
}
Errors
400 Bad Request— The lookup request is malformed, orversionis less than 1.401 Unauthorized— Authentication is missing or invalid.403 Forbidden— This feature is not available to the account.404 Not Found— No children policy exists at the requested version.422 Unprocessable Entity— The request is invalid for this operation.503 Service Unavailable— Policy validation or storage is temporarily unavailable. Retry with backoff.
Page children policy versions
Returns immutable children policy versions newest first.
Request body
Response
The response contains pagination metadata and complete children policy objects in page.
Request
import { InttegroClient } from '@inttegro/inttegro-sdk'
const apiKey = process.env.INTTEGRO_API_KEY
if (!apiKey) throw new Error('INTTEGRO_API_KEY is required')
const inttegro = new InttegroClient({ apiKey })
const page = await inttegro.childrenPolicies.page({ number: 1, size: 2 })
Response
Errors
400 Bad Request—numberorsizeis outside the accepted range, or the request contains unsupported attributes.401 Unauthorized— Authentication is missing or invalid.403 Forbidden— This feature is not available to the account.404 Not Found— No children policy is available.422 Unprocessable Entity— The versions cannot be returned for this operation.503 Service Unavailable— Policy storage is temporarily unavailable. Retry with backoff.
Related resources
- Operating policies — Select concrete child settings, create reusable policies, and assign them to apps.
- Create an app — Create a child app under a parent operating boundary.
- Lookup an app — Retrieve an app and its operating-policy snapshot.