> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /api/v1/sdk/organizations/:orgId/link-as-parent

> Vincula a organização autenticada como pai de outra organização, definindo a taxa de comissão aplicada.

Estabelece um relacionamento hierárquico entre a organização autenticada (pai) e a organização alvo (`orgId`). Ao vincular como pai, é possível definir a taxa percentual de comissão (`fee_percent`) que será retida em cada venda realizada pela organização filha.

## Autenticação

Requer **Organization Access Token (OAT)** da organização pai via header `Authorization: Bearer`.

## Parâmetros de Path

**orgId** `string` *required*

Identificador único da organização que será vinculada como filha.

## Corpo da Requisição

**fee\_percent** `number` *required*

Percentual de comissão a ser retido pela organização pai em cada venda da organização filha. Valores aceitos: `0` a `50`.

## Resposta

**parent\_organization\_id** `string`

Identificador único da organização pai.

**child\_organization\_id** `string`

Identificador único da organização filha vinculada.

**fee\_percent** `number`

Percentual de comissão configurado para o relacionamento.

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/sdk/organizations/org_01j9abc333/link-as-parent" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fee_percent": 10
  }'
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';
const chargefy = new Chargefy({ accessToken: process.env.CHARGEFY_ACCESS_TOKEN });
const result = await chargefy.sdk.organizations.linkAsParent('org_01j9abc333', {
  fee_percent: 10,
});
```

## Resposta de Exemplo

```json theme={null}
{
  "parent_organization_id": "org_01j9abc111",
  "child_organization_id": "org_01j9abc333",
  "fee_percent": 10
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.