> ## 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/products

> Cria um produto em nome de uma sub-organização filha, gerenciado pela organização pai autenticada.

Cria um produto associado a uma sub-organização filha. A organização autenticada deve ser a organização pai da `orgId` informada. Retorna o objeto do produto criado com status HTTP `201 Created`.

> **Taxas de split:** o percentual de comissão cobrado pela organização pai é configurado **uma vez** na relação pai/filha (via [hosted onboarding sessions](https://scaleup-c34c4386.mintlify.site/api-reference/hosted-onboarding-sessions/create) ou [link-as-parent](https://scaleup-c34c4386.mintlify.site/api-reference/sdk/organizations/link-as-parent.md)) e aplicado automaticamente em todas as vendas da filha. Não há mais override por produto.

**Ver também:** [Listar produtos da sub-organização](https://scaleup-c34c4386.mintlify.site/api-reference/sdk/organizations/products-list.md) e [Atualizar produto da sub-organização](https://scaleup-c34c4386.mintlify.site/api-reference/sdk/organizations/products-update.md) para manter o catálogo depois da criação.

## Autenticação

Requer **Organization Access Token (OAT)** da organização pai via header `Authorization: Bearer`. A organização autenticada deve ser a organização pai da `orgId` informada.

## Parâmetros de Path

**orgId** `string` *required*

Identificador único da sub-organização filha para a qual o produto será criado.

## Corpo da Requisição

**name** `string` *required*

Nome do produto.

**description** `string`

Descrição detalhada do produto.

**metadata** `object`

Metadados livres (chave/valor) associados ao produto.

**is\_tax\_applicable** `boolean`

Indica se o produto é tributável. Padrão: `true`.

**prices** `array` *required*

Lista com pelo menos 1 price inline. O primeiro vira `default_price_id` do produto (a menos que `default_price_index` seja passado).

**Price**

**currency** `string` *required*

Código ISO de 3 letras em minúsculas (ex: `brl`).

**unit\_amount** `integer` *required*

Valor unitário em minor units (centavos). `0` é válido para preço gratuito one-time.

**type** `string`

`one_time` (padrão) ou `recurring`.

**interval** `string`

Obrigatório quando `type=recurring`. Valores: `day`, `week`, `month`, `year`.

**interval\_count** `integer`

Quantidade de intervalos entre cobranças (padrão `1`). Só tem efeito em prices recurring.

**tax\_behavior** `string`

`unspecified` (padrão), `inclusive` ou `exclusive`.

**metadata** `object`

Metadados livres por price.

**active** `boolean`

Padrão: `true`.

**default\_price\_index** `integer`

Índice (base 0) do price dentro de `prices[]` que vira o `default_price_id`. Padrão: `0`.

## Resposta

Retorna o objeto do produto criado com status `201 Created`, incluindo `default_price_id` e `prices[]` completo.

**id** `string`

Identificador único do produto criado.

**name** `string`

Nome do produto.

**description** `string`

Descrição do produto.

**default\_price\_id** `string`

ID da price padrão — usada em checkouts quando o caller não especifica `product_price_id`.

**prices** `array`

Lista de prices criadas (shape Stripe-like: `id`, `type`, `currency`, `unit_amount`, `interval`, `interval_count`, `tax_behavior`, `metadata`, `active`, `zoop_recurrence_plan_id`).

**organization\_id** `string`

Identificador da organização à qual o produto pertence.

**created\_at** `string`

Data e hora de criação do produto no formato ISO 8601.

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/sdk/organizations/org_01j9abc333/products" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Plano Mensal",
    "description": "Acesso completo ao plano mensal",
    "prices": [
      {
        "currency": "brl",
        "unit_amount": 9900,
        "type": "recurring",
        "interval": "month",
        "interval_count": 1
      }
    ]
  }'
```

```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.createProduct('org_01j9abc333', {
  name: 'Plano Mensal',
  description: 'Acesso completo ao plano mensal',
  prices: [
    {
      currency: 'brl',
      unit_amount: 9900,
      type: 'recurring',
      interval: 'month',
      interval_count: 1,
    },
  ],
});
```

## Resposta de Exemplo

```json theme={null}
{
  "id": "prod_01j9xyz999",
  "name": "Plano Mensal",
  "description": "Acesso completo ao plano mensal",
  "default_price_id": "price_01j9xyz998",
  "prices": [
    {
      "id": "price_01j9xyz998",
      "type": "recurring",
      "currency": "brl",
      "unit_amount": 9900,
      "interval": "month",
      "interval_count": 1,
      "tax_behavior": "unspecified",
      "metadata": {},
      "active": true,
      "zoop_recurrence_plan_id": null
    }
  ],
  "organization_id": "org_01j9abc333",
  "created_at": "2024-11-01T10:30:00Z"
}
```


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