PATCH /api/v1/sdk/organizations/:orgId/checkouts/:checkoutId

Atualiza uma sessão de checkout aberta, desde que pertença à sub-organização do path; valida troca de produto/preço contra :orgId.

Atualiza checkout aberto (status === open), com o mesmo conjunto de campos opcionais que PATCH /v1/checkouts/:id.

Regras específicas deste path:

1. O checkout deve existir e seu produto principal deve ter organization_id === :orgId; caso contrário 404 (igual ao GET escopado).
2. Se o corpo incluir product_id ou product_price_id, o novo produto (resolvido a partir do preço, se for o caso) também deve pertencer a :orgId; senão 422.

Outras regras do núcleo permanecem (ex.: não atualizar checkout já confirmado → 403).

​

Autenticação

JWT da organização pai com relação para :orgId.

​

Escopos

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

​

Parâmetros de path

orgId · string · required

Sub-organização dona esperada do produto principal (e de qualquer produto novo na atualização).

checkoutId · string · required

ID da sessão.

​

Corpo (parcial)

Todos os campos são opcionais; envie apenas o que mudar. Exemplos em snake_case no HTTP:

customer_email · string

customer_name · string

customer_tax_id · string

product_id · string

Novo produto principal — deve ser da sub-org :orgId.

product_price_id · string

Novo preço — produto associado deve ser da sub-org :orgId.

amount · integer

Valor em centavos (quando permitido pelo fluxo de preço).

quantity · integer

discount_id · string

metadata · object

success_url · string

Para a lista completa, alinhe-se ao comportamento de PATCH /v1/checkouts/:id no ambiente que você integra.

​

Resposta

200 OK — checkout atualizado.

​

Erros

HTTP	Motivo
404	Checkout não encontrado ou não pertence a :orgId no sentido do produto principal
403	Checkout não está open
422	Novo product_id / product_price_id não é da sub-org :orgId
401 / 403	Token, escopo ou vínculo pai–filho

​

Exemplos

​

Atualizar e-mail e nome antes do pagamento

cURL

curl -s -X PATCH "${API_BASE:-https://api.chargefy.io/api}/v1/sdk/organizations/${CHILD_ORG_ID}/checkouts/${CHECKOUT_ID}" \
  -H "Authorization: Bearer ${PARENT_JWT}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "[e-mail]",
    "customer_name": "Maria Silva Santos"
  }' | jq .

​

Trocar para outro produto do mesmo filho

cURL

curl -s -X PATCH "${API_BASE}/v1/sdk/organizations/${CHILD_ORG_ID}/checkouts/${CHECKOUT_ID}" \
  -H "Authorization: Bearer ${PARENT_JWT}" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "'"${OTHER_PRODUCT_SAME_CHILD_ID}"'"}' | jq .

​

Metadados para conciliação no marketplace

await chargefy.subOrganizations.updateCheckout(childOrgId, checkoutId, {
  metadata: {
    marketplace_order_ref: 'ord_998877',
    seller_slug: 'loja-b',
  },
})

​

Variáveis (bash)

export API_BASE="https://api.chargefy.io/api"
export PARENT_JWT="<supabase_jwt>..."
export CHILD_ORG_ID="uuid_sub_org"
export CHECKOUT_ID="uuid_checkout"
export OTHER_PRODUCT_SAME_CHILD_ID="uuid_outro_produto_mesma_sub_org"