Skip to main content
Cria uma sessão de checkout com o mesmo corpo que POST /v1/checkouts, com uma regra extra:
  • Todo produto envolvido na criação (product_id, ou produto derivado de product_price_id, ou cada ID em products[]) deve ter organization_id igual a :orgId.
  • Se você tentar usar um produto de outra sub-organização ou da org pai, a API responde 422 com mensagem clara (não expõe dados do produto alheio).
Isso evita ambiguidade em marketplaces com muitos vendedores: a URL deixa explícito para qual filho aquela sessão está sendo aberta.

​
Autenticação

JWT da organização pai, com vínculo direto para :orgId em organization_relationships.

​
Escopos

Pelo menos um de: web:write ou checkouts:write.

​
Parâmetros de path

​
orgId
string
required
UUID da sub-organização dona do catálogo. Os produtos do corpo devem pertencer a essa org.

​
Corpo

Igual a POST /v1/checkouts (campos em snake_case no HTTP). É obrigatório fornecer um entre:
  • product_id
  • product_price_id (produto inferido do preço)
  • products (lista de IDs de produto; o fluxo interno usa o primeiro como principal, como no endpoint principal)
Campos frequentes:
​
product_id
string
ID do produto da sub-org :orgId.
​
product_price_id
string
ID de preço; o produto associado deve ser da sub-org :orgId.
​
customer_email
string
E-mail pré-preenchido no checkout.
​
customer_name
string
Nome do comprador.
​
customer_tax_id
string
CPF/CNPJ quando aplicável.
​
amount
integer
Valor em centavos quando usar preço customizado ou bundle com cross_sell (mesmas regras do endpoint principal).
​
success_url
string
URL de retorno após sucesso.
​
metadata
object
Metadados arbitrários gravados na sessão.

​
Resposta

201 Created com o objeto checkout (inclui client_secret, url para abrir o fluxo, etc.), no mesmo formato que POST /v1/checkouts.

​
Erros

HTTPMotivo
401 / 403Token ou escopo; ou pai não é pai de :orgId
404Produto/preço inexistente
422Produto não pertence a :orgId, ou validação de preço / cross_sell
500Erro interno

​
Exemplos

​
Checkout simples com produto e e-mail

curl -s -X POST "${API_BASE:-https://api.chargefy.io/api}/v1/sdk/organizations/${CHILD_ORG_ID}/checkouts" \
  -H "Authorization: Bearer ${PARENT_JWT}" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "'"${CHILD_PRODUCT_ID}"'",
    "customer_email": "[email protected]",
    "customer_name": "Maria Silva",
    "success_url": "https://marketplace.exemplo.com/obrigado"
  }' | jq .

​
Usando product_price_id (mesmo filho, preço explícito)

curl -s -X POST "${API_BASE:-https://api.chargefy.io/api}/v1/sdk/organizations/${CHILD_ORG_ID}/checkouts" \
  -H "Authorization: Bearer ${PARENT_JWT}" \
  -H "Content-Type: application/json" \
  -d '{
    "product_price_id": "'"${CHILD_PRICE_ID}"'",
    "customer_email": "[email protected]",
    "require_billing_address": true
  }' | jq .

​
Erro esperado: produto de outra org no mesmo marketplace

Se OTHER_PRODUCT_ID for de outro filho (ou da pai), o path ainda aponta para CHILD_ORG_ID: 
curl -s -o /dev/stderr -w "%{http_code}" -X POST "${API_BASE}/v1/sdk/organizations/${CHILD_ORG_ID}/checkouts" \
  -H "Authorization: Bearer ${PARENT_JWT}" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "'"${OTHER_PRODUCT_ID}"'"}'
# Esperado: HTTP 422 — corpo com mensagem sobre produto e sub-organização da URL

​
Variáveis (bash)

export API_BASE="https://api.chargefy.io/api"
export PARENT_JWT="<supabase_jwt>..."
export CHILD_ORG_ID="uuid_sub_org"
export CHILD_PRODUCT_ID="uuid_produto"
export CHILD_PRICE_ID="uuid_preco"