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

cURL

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
  }'

Resposta de Exemplo

{
  "parent_organization_id": "org_01j9abc111",
  "child_organization_id": "org_01j9abc333",
  "fee_percent": 10
}