{"openapi":"3.1.0","info":{"title":"Wolf Sandbox API","version":"1.0.0","summary":"Pagamentos simulados (Pix e cartões de teste), pedidos, Payment Links e webhooks.","description":"API pública do **Wolf Sandbox** (Production Simulation Edition). O único provedor é o simulador: nenhuma cobrança é real, os QR Codes Pix são sintéticos e cartões de teste escolhem o cenário (não existe campo de número de cartão).\n\n- **Autenticação:** `Authorization: Bearer sk_test_...` (API key) ou o token de sessão do app do seller, conforme cada operação.\n- **Valores:** `amount_minor` é uma string com o inteiro em centavos (`\"9900\"` = R$ 99,00); nunca ponto flutuante.\n- **Idempotência:** operações marcadas exigem `Idempotency-Key` (8 a 255 caracteres).\n- **Erros:** envelope `{\"error\": {\"code\", \"message\", \"request_id\"}}`; `code` é estável.\n- **Rate limit:** `429 RATE_LIMITED` com `Retry-After`.\n- **Servidores:** o `/openapi.json` de cada ambiente informa o próprio `servers`.","x-wolf-edition":"production-simulation"},"servers":[{"url":"https://api.v2.wolfpayteste.online","description":"Wolf Sandbox (staging)"}],"tags":[{"name":"PaymentIntents","description":"Crie, confirme e acompanhe pagamentos Pix simulado e cartão de teste."},{"name":"Refunds","description":"Reembolsos totais ou parciais de pagamentos capturados."},{"name":"Simulator","description":"Ferramentas que só existem na edição de simulação: simular o pagamento de um Pix e forçar a reconciliação."},{"name":"Orders","description":"Pedidos de uma oferta e seus pagamentos."},{"name":"Products","description":"Catálogo: produtos."},{"name":"Offers","description":"Catálogo: ofertas (preço de um produto)."},{"name":"Checkout Sessions","description":"Sessões de checkout hospedado criadas pelo seller."},{"name":"Payment Links","description":"Links de pagamento persistentes de uma oferta."},{"name":"Public Checkout","description":"Rotas públicas usadas pelo checkout hospedado (sem API key): ler a sessão, registrar os dados do comprador (etapa 1), pagar, simular o Pix e abrir um Payment Link."},{"name":"Webhooks","description":"Endpoints de webhook, entregas, teste, replay e rotação do segredo."},{"name":"API Keys","description":"API keys do seller (só por sessão humana do app do seller)."},{"name":"Organizations","description":"Organizações do usuário autenticado (sessão do app do seller)."},{"name":"Reports","description":"Painel, finanças e checkouts abandonados do seller."},{"name":"Payouts, Settlements & Disputes","description":"Leitura de repasses, liquidações e disputas **sintéticos**."}],"paths":{"/v1/api-keys":{"get":{"operationId":"listApiKeys","tags":["API Keys"],"summary":"Listar API keys","description":"Chave vencida aparece com `status: \"expired\"`.","security":[{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"API keys (sem segredo).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiCredential"}}},"required":["data"]},"example":{"data":[{"id":"key_0a1b2c3d4e5f60718293a4b5c6d7e8f9","name":"Integração da loja","key_prefix":"sk_test_a1B2c3D4e5F6","scopes":["payments:read","payments:write","refunds:write"],"status":"active","expires_at":"2027-11-06T00:00:00.000Z","last_used_at":null,"created_at":"2026-11-06T12:00:00.000Z","revoked_at":null}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["api-keys:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]},"post":{"operationId":"createApiKey","tags":["API Keys"],"summary":"Criar API key","description":"Nesta edição só emite `sk_test_`. `expires_at` é opcional (instante ISO-8601 com offset, no futuro e em até 365 dias). O `secret` é exibido uma única vez. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiCredentialRequest"},"example":{"name":"Integração da loja","scopes":["payments:read","payments:write","refunds:write"],"expires_at":"2027-11-06T00:00:00Z"}}}},"responses":{"201":{"description":"API key criada (ou replay sem o segredo).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreatedApiCredential"},{"$ref":"#/components/schemas/ReplayedApiCredential"}]},"example":{"credential":{"id":"key_0a1b2c3d4e5f60718293a4b5c6d7e8f9","name":"Integração da loja","key_prefix":"sk_test_a1B2c3D4e5F6","scopes":["payments:read","payments:write","refunds:write"],"status":"active","expires_at":"2027-11-06T00:00:00.000Z","last_used_at":null,"created_at":"2026-11-06T12:00:00.000Z","revoked_at":null},"secret":"sk_test_EXEMPLO_segredo_exibido_uma_unica_vez"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["api-keys:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/api-keys/{id}/revoke":{"post":{"operationId":"revokeApiKey","tags":["API Keys"],"summary":"Revogar API key","security":[{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da API key (`key_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"API key revogada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiCredential"},"example":{"id":"key_0a1b2c3d4e5f60718293a4b5c6d7e8f9","name":"Integração da loja","key_prefix":"sk_test_a1B2c3D4e5F6","scopes":["payments:read","payments:write","refunds:write"],"status":"revoked","expires_at":"2027-11-06T00:00:00.000Z","last_used_at":null,"created_at":"2026-11-06T12:00:00.000Z","revoked_at":"2026-11-06T12:10:00.000Z"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["api-keys:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/checkout-sessions":{"post":{"operationId":"createCheckoutSession","tags":["Checkout Sessions"],"summary":"Criar sessão de checkout","description":"Cria uma sessão de checkout hospedado de uma oferta `active` (`ttl_minutes` de 5 a 1440, padrão 30). O `client_secret` é exibido só na primeira resposta; um replay devolve a sessão com `secret_already_revealed: true`. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCheckoutSessionRequest"},"example":{"offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","ttl_minutes":30}}}},"responses":{"201":{"description":"Sessão criada (ou replay sem o segredo).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreatedCheckoutSession"},{"$ref":"#/components/schemas/ReplayedCheckoutSession"}]},"example":{"id":"cs_2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","amount_minor":"9900","currency":"BRL","status":"open","payment_intent_id":null,"expires_at":"2026-11-06T12:30:00.000Z","client_secret":"csec_EXEMPLO_segredo_de_uso_unico_da_sessao"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/dashboard":{"get":{"operationId":"getDashboard","tags":["Reports"],"summary":"Painel","description":"Com `period` (`today`, `7d` ou `30d`; `currency` opcional, padrão BRL): visão geral do período no fuso da organização — \"hoje\" começa à meia-noite local — com KPIs contra o período anterior equivalente, série, métodos, Pix emitido × pago, saldos, waterfall e ritmo do dia. Formatos anteriores, mantidos por uma release: sem parâmetros, resumo de todos os pagamentos; com `from`, `to` (datas UTC `AAAA-MM-DD`) e `currency` — os três juntos — resumo do período. Misturar os formatos → `400 VALIDATION_FAILED`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"currency","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Z]{3}$"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["today","7d","30d"]}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Resumo.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DashboardPeriod"},{"$ref":"#/components/schemas/Dashboard"},{"$ref":"#/components/schemas/SellerDashboard"}]},"example":{"period":"today","currency":"BRL","timezone":"America/Sao_Paulo","from":"2026-11-06T03:00:00.000Z","to":"2026-11-06T15:00:00.000Z","previous_from":"2026-11-05T03:00:00.000Z","previous_to":"2026-11-05T15:00:00.000Z","generated_at":"2026-11-06T15:00:00.120Z","kpis":{"gross":{"value":"29700","previous":"19800","delta":"9900"},"paid":{"value":3,"previous":2,"delta":1},"pix_conversion":{"value":6667,"previous":5000,"delta":1667,"numerator":2,"denominator":3,"previous_numerator":1,"previous_denominator":2},"card_approval":{"value":5000,"previous":10000,"delta":-5000,"numerator":1,"denominator":2,"previous_numerator":1,"previous_denominator":1}},"series":{"granularity":"hour","buckets":[{"start":"2026-11-06T12:00:00.000Z","label":"2026-11-06T09:00","gross_minor":"19800","pix_minor":"19800","card_minor":"0","paid_count":2},{"start":"2026-11-06T13:00:00.000Z","label":"2026-11-06T10:00","gross_minor":"9900","pix_minor":"0","card_minor":"9900","paid_count":1}]},"methods":[{"method":"pix","paid_count":2,"gross_minor":"19800"},{"method":"card","paid_count":1,"gross_minor":"9900"}],"pix":{"emitted_count":3,"paid_count":2,"pending_count":1,"expired_count":0,"emitted_minor":"29700","paid_minor":"19800"},"balances":{"available_minor":"9404","pending_minor":"29700","reserved_minor":"0","dispute_hold_minor":"0","payout_pending_minor":"0","paid_out_minor":"150000"},"waterfall":{"gross_minor":"29700","refunds_minor":"4900","disputes_minor":"0","fees_minor":"0","net_minor":"24800","fees_settled_payments":0,"succeeded_payments":3},"rhythm":{"status":"insufficient_history","date":"2026-11-06","current_hour":12,"reason":"history_shorter_than_4_weeks"},"recent_sales":[{"payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","amount_minor":"9900","currency":"BRL","status":"succeeded","display_status":"paid","payment_method":"card","created_at":"2026-11-06T12:00:00.000Z"}]}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["reports:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/disputes":{"get":{"operationId":"listDisputes","tags":["Payouts, Settlements & Disputes"],"summary":"Listar disputas sintéticas","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Disputas.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Dispute"}}},"required":["data"]},"example":{"data":[{"id":"dsp_9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b","payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","amount_minor":"9900","currency":"BRL","status":"created","reason_code":"product_not_received","provider_id":"simulator","external_id":"sim_dsp_0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f","provider_status":"needs_response","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z","resolved_at":null}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]}},"/v1/disputes/{id}":{"get":{"operationId":"getDispute","tags":["Payouts, Settlements & Disputes"],"summary":"Consultar disputa sintética","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da disputa (`dsp_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Disputa.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"},"example":{"id":"dsp_9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b","payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","amount_minor":"9900","currency":"BRL","status":"created","reason_code":"product_not_received","provider_id":"simulator","external_id":"sim_dsp_0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f","provider_status":"needs_response","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z","resolved_at":null}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/finance":{"get":{"operationId":"getFinance","tags":["Reports"],"summary":"Saldos e journals","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Saldos e journals recentes.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceSnapshot"},"example":{"balances":[{"code":"seller_available","currency":"BRL","balance_minor":"9504"}],"journals":[{"id":"jrn_1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f","source_type":"payment_intent","source_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","operation_key":"capture:pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","currency":"BRL","debit_minor":"9900","credit_minor":"9900","created_at":"2026-11-06T12:00:05.000Z"}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]}},"/v1/finance/fees":{"get":{"operationId":"getFinanceFees","tags":["Reports"],"summary":"Taxas vigentes","description":"Política de taxas vigente do seller em pontos-base (100 = 1 %): a do seller, se existir, senão a da plataforma; `overrides` lista as políticas por produto ou oferta.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Taxas.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceFees"},"example":{"default":{"scope":"global","scope_id":null,"provider_id":"simulator","fee_basis_points":499,"reserve_basis_points":0,"max_installments":12,"version":"1"},"overrides":[]}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/finance/forecast":{"get":{"operationId":"getFinanceForecast","tags":["Reports"],"summary":"Previsão de liberações","description":"Liberações previstas do saldo a liberar (liquidação sintética, nenhum dinheiro real). Cada pagamento aprovado tem o prazo congelado na aprovação, em dias corridos no fuso da organização (Pix D+1 e cartão de teste D+30, ou o prazo da conta definido pela Wolf), e fica disponível às 00:00 locais do dia do prazo. Com a liquidação automática ligada, `data` traz o valor líquido (depois da taxa e da reserva) por dia e método, uma liberação já vencida aparece com a data de hoje, `held` soma os pagamentos retidos (disputa aberta, reembolso em andamento, revisão) e `reason` é `null`. Com ela desligada, `data` vem vazio com `reason: \"no_canonical_settlement_schedule\"`. `terms` lista os prazos vigentes para novos pagamentos e `pending_minor` o saldo a liberar.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"currency","in":"query","required":false,"schema":{"default":"BRL","type":"string","pattern":"^[A-Z]{3}$"}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Previsão.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceForecast"},"example":{"currency":"BRL","pending_minor":"29700","reason":null,"data":[{"date":"2026-09-29","amount_minor":"9406","gross_minor":"9900","fee_minor":"494","reserve_minor":"0","payments":1,"methods":[{"payment_method_type":"pix","amount_minor":"9406","gross_minor":"9900","payments":1}]},{"date":"2026-10-28","amount_minor":"18812","gross_minor":"19800","fee_minor":"988","reserve_minor":"0","payments":2,"methods":[{"payment_method_type":"card","amount_minor":"18812","gross_minor":"19800","payments":2}]}],"terms":[{"payment_method_type":"pix","days":1,"source":"platform_default"},{"payment_method_type":"card","days":30,"source":"platform_default"}],"held":{"gross_minor":"0","payments":0,"reasons":[]}}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/finance/payouts":{"get":{"operationId":"listFinancePayouts","tags":["Payouts, Settlements & Disputes"],"summary":"Histórico de saques","description":"Saques sintéticos do seller, do mais recente ao mais antigo, com a origem (`seller`: pedido pelo app; `admin`: criado pela operação da Wolf) e o estado (`created` = em processamento, `paid`, `failed`).","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Saques.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancePayoutList"},"example":{"data":[{"id":"pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","amount_minor":"123456","currency":"BRL","status":"paid","origin":"seller","destination_ref":"sim_seller_default","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","resolved_at":"2026-11-06T12:00:05.000Z"}]}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/finance/statement":{"get":{"operationId":"getFinanceStatement","tags":["Reports"],"summary":"Extrato do saldo disponível","description":"Lançamentos da conta de saldo disponível do seller, do mais recente ao mais antigo, com `balance_after_minor` (saldo logo após cada lançamento). Paginado por `cursor`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"currency","in":"query","required":false,"schema":{"default":"BRL","type":"string","pattern":"^[A-Z]{3}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048,"pattern":"^s1_[0-9a-f]+$"}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Extrato.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceStatement"},"example":{"currency":"BRL","account":"seller_available","balance_minor":"9404","data":[{"id":"pst_4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a","journal_id":"jrn_1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f","source_type":"settlement","source_id":"stl_6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b","payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","amount_minor":"9404","balance_after_minor":"9404","created_at":"2026-11-06T12:00:05.000Z"}],"next_cursor":null}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/me/organizations":{"get":{"operationId":"listMyOrganizations","tags":["Organizations"],"summary":"Listar minhas organizações","description":"Organizações do usuário da sessão. Com mais de uma, envie `wolf-organization-id` nas demais rotas.","security":[{"sellerSession":[]}],"responses":{"200":{"description":"Organizações.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Organization"}}},"required":["data"]},"example":{"data":[{"id":"org_6a5b4c3d2e1f00918273645546372819","seller_id":"sel_8f7e6d5c4b3a29180716253443526170","legal_name":"Estúdio Exemplo Ltda","display_name":"Estúdio Exemplo","status":"active","role":"OWNER","capabilities":["payments:read","payments:write","refunds:write","offers:read","offers:write","organization:close","organization:settings"],"timezone":"America/Sao_Paulo"}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","INTERNAL_ERROR","RATE_LIMITED"]}},"/v1/notifications":{"get":{"operationId":"listNotifications","tags":["Reports"],"summary":"Notificações ao vivo","description":"Eventos recentes da conta para os avisos ao vivo do app: Pix emitido, pagamento aprovado ou recusado, reembolso e saque (saques só para papéis com `finance:read`). Sem `since`: os mais recentes das últimas 24 h; com `since` (o `next_cursor` anterior): os eventos depois dele, em ordem. Pensado para polling a cada 15 s. **Nunca** traz nome, e-mail ou documento do comprador: só valor, método e uma referência curta.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","maxLength":512,"pattern":"^n1_[0-9a-f]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Notificações.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPage"},"example":{"data":[{"id":"evt_7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f","kind":"pix_issued","occurred_at":"2026-11-06T12:00:00.000000Z","amount_minor":"6873","currency":"BRL","resource_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","reference":"1B2C3D4E","payment_method":"pix","payout_origin":null},{"id":"evt_8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a","kind":"payment_approved","occurred_at":"2026-11-06T12:01:30.000000Z","amount_minor":"6873","currency":"BRL","resource_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","reference":"1B2C3D4E","payment_method":"pix","payout_origin":null}],"next_cursor":"n1_5b22323032362d31312d30365431323a30313a33302e3030303030305a222c226576745f3864396530663161326233633464356536663761386239633064316532663361225d","has_more":false}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/offers":{"get":{"operationId":"listOffers","tags":["Offers"],"summary":"Listar ofertas","description":"Sem parâmetros de consulta a resposta é a lista completa legada (`{data}`); com qualquer parâmetro ela é paginada por cursor (`{data, next_cursor}`). Parâmetro desconhecido → `400 VALIDATION_FAILED`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","active","archived"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048,"pattern":"^c1_[0-9a-f]+$"}},{"name":"product_id","in":"query","required":false,"schema":{"type":"string","maxLength":128,"pattern":"^prd_[A-Za-z0-9]+$"}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Ofertas.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OfferPage"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}}},"required":["data"]}]},"example":{"data":[{"id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","amount_minor":"9900","currency":"BRL","status":"active","created_at":"2026-11-06T12:00:00.000Z","accepted_methods":["pix","card"]}],"next_cursor":null}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]},"post":{"operationId":"createOffer","tags":["Offers"],"summary":"Criar oferta","description":"Cria uma oferta em `draft` para um produto do seller; ela aceita Pix e cartão de teste até `PATCH /v1/offers/{id}` mudar `accepted_methods`. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOfferRequest"},"example":{"product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","amount_minor":"9900","currency":"BRL"}}}},"responses":{"201":{"description":"Oferta criada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Offer"},"example":{"id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","amount_minor":"9900","currency":"BRL","status":"draft","created_at":"2026-11-06T12:00:00.000Z","accepted_methods":["pix","card"]}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read","offers:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/offers/{id}":{"get":{"operationId":"getOffer","tags":["Offers"],"summary":"Consultar oferta","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da oferta (`off_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Oferta.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Offer"},"example":{"id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","amount_minor":"9900","currency":"BRL","status":"active","created_at":"2026-11-06T12:00:00.000Z","accepted_methods":["pix","card"]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]},"patch":{"operationId":"updateOffer","tags":["Offers"],"summary":"Mudar os métodos aceitos da oferta","description":"`accepted_methods` define os métodos que o checkout da oferta oferece: `pix`, `card` (cartão de teste) ou ambos (padrão). O checkout mostra só esses métodos e pagar com outro → `409 PAYMENT_METHOD_NOT_ACCEPTED`. Repetir a lista atual não muda nada; toda mudança é auditada.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da oferta (`off_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOfferRequest"},"example":{"accepted_methods":["pix"]}}}},"responses":{"200":{"description":"Oferta atualizada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Offer"},"example":{"id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","amount_minor":"9900","currency":"BRL","status":"active","created_at":"2026-11-06T12:00:00.000Z","accepted_methods":["pix"]}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read","offers:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/offers/{id}/bumps":{"get":{"operationId":"listOfferBumps","tags":["Offers"],"summary":"Listar order bumps da oferta","description":"Order bumps da oferta principal, na ordem de `position`, com o preço atual da oferta de cada bump.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da oferta principal (`off_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Order bumps.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferBumpList"},"example":{"data":[{"id":"ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","bump_offer_id":"off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d","headline":"Adicionar à compra: Guia bônus","description":"Checklist em PDF com 40 poses para ensaios.","position":0,"status":"active","bump_offer":{"product_id":"prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f","amount_minor":"2700","currency":"BRL","status":"active"},"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z"}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]},"post":{"operationId":"createOfferBump","tags":["Offers"],"summary":"Criar order bump","description":"Oferece outra oferta do seller (`bump_offer_id`) como adicional no checkout desta oferta. Regras: mesma moeda; um bump `active` (padrão) exige a oferta do bump `active`; no máximo 3 bumps ativos por oferta e sem bump dentro de bump (`409 INVALID_STATE_TRANSITION`); a mesma oferta não entra duas vezes como bump (`400`). Auditado (`offer_bump.created`). Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da oferta principal (`off_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOfferBumpRequest"},"example":{"bump_offer_id":"off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d","headline":"Adicionar à compra: Guia bônus","description":"Checklist em PDF com 40 poses para ensaios.","position":0}}}},"responses":{"201":{"description":"Order bump criado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferBump"},"example":{"id":"ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","bump_offer_id":"off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d","headline":"Adicionar à compra: Guia bônus","description":"Checklist em PDF com 40 poses para ensaios.","position":0,"status":"active","bump_offer":{"product_id":"prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f","amount_minor":"2700","currency":"BRL","status":"active"},"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read","offers:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/offers/{id}/bumps/{bumpId}":{"patch":{"operationId":"updateOfferBump","tags":["Offers"],"summary":"Alterar order bump","description":"Muda `headline`, `description`, `position` e/ou `status` (`active` ↔ `inactive`; bumps nunca são apagados). Ativar respeita as mesmas regras da criação. Repetir os valores atuais não muda nada. Auditado (`offer_bump.updated`).","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da oferta principal (`off_...`).","schema":{"type":"string","minLength":1}},{"name":"bumpId","in":"path","required":true,"description":"Id do order bump (`ob_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOfferBumpRequest"},"example":{"status":"inactive"}}}},"responses":{"200":{"description":"Order bump atualizado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferBump"},"example":{"id":"ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","bump_offer_id":"off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d","headline":"Adicionar à compra: Guia bônus","description":"Checklist em PDF com 40 poses para ensaios.","position":0,"status":"inactive","bump_offer":{"product_id":"prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f","amount_minor":"2700","currency":"BRL","status":"active"},"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read","offers:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/offers/{id}/status":{"patch":{"operationId":"setOfferStatus","tags":["Offers"],"summary":"Mudar status da oferta","description":"Ativar uma oferta exige o produto `active` (`409 PRODUCT_NOT_ACTIVE`).","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da oferta (`off_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogStatusRequest"},"example":{"status":"active"}}}},"responses":{"200":{"description":"Oferta atualizada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Offer"},"example":{"id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","amount_minor":"9900","currency":"BRL","status":"active","created_at":"2026-11-06T12:00:00.000Z","accepted_methods":["pix","card"]}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`, `PRODUCT_NOT_ACTIVE`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read","offers:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","INVALID_STATE_TRANSITION","PRODUCT_NOT_ACTIVE","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/orders":{"get":{"operationId":"listOrders","tags":["Orders"],"summary":"Listar pedidos","description":"Sem parâmetros de consulta a resposta é a lista completa legada (`{data}`); com qualquer parâmetro ela é paginada por cursor (`{data, next_cursor}`). Parâmetro desconhecido → `400 VALIDATION_FAILED`. A página traz produto, método, comprador mascarado (`a***@gmail.com`, `Ana S.`), `display_status` (vocabulário do painel) e `counts` por status de exibição para os mesmos filtros, sem o `status`. `q` busca por id do pedido/pagamento, e-mail completo do comprador ou parte do nome (3+ caracteres); `from`/`to` são datas locais (inclusivas) no fuso da organização; `status` usa o vocabulário de exibição e ainda aceita `pending_payment` (status canônico do pedido).","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["pending","processing","paid","declined","refunded","partially_refunded","canceled","expired","disputed","chargeback","failed"]},{"type":"string","const":"pending_payment"}]}},{"name":"min_amount","in":"query","required":false,"schema":{"type":"string","pattern":"^[1-9][0-9]*$"}},{"name":"product_id","in":"query","required":false,"schema":{"type":"string","maxLength":128,"pattern":"^prd_[A-Za-z0-9]+$"}},{"name":"offer_id","in":"query","required":false,"schema":{"type":"string","maxLength":128,"pattern":"^off_[A-Za-z0-9]+$"}},{"name":"method","in":"query","required":false,"schema":{"type":"string","enum":["card","pix"]}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048,"pattern":"^o1_[0-9a-f]+$"}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Pedidos.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SellerOrderPage"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Order"}}},"required":["data"]}]},"example":{"data":[{"id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","checkout_session_id":null,"amount_minor":"9900","currency":"BRL","status":"paid","paid_payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","paid_charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z","paid_at":"2026-11-06T12:00:05.000Z","canceled_at":null,"expired_at":null,"items":[{"id":"oi_1f2e3d4c5b6a79808f7e6d5c4b3a2918","kind":"main","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","offer_bump_id":null,"amount_minor":"9900","currency":"BRL","position":0,"product_name":"Curso de fotografia"}],"product_name":"Curso de fotografia","offer_name":null,"payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","payment_method":"pix","buyer":{"name":"Ana C.","email":"a***@example.com","phone":"+55 11 9****-4321"},"display_status":"paid","refunded_minor":"0"}],"next_cursor":null,"counts":{"all":1,"pending":0,"processing":0,"paid":1,"declined":0,"refunded":0,"partially_refunded":0,"canceled":0,"expired":0,"disputed":0,"chargeback":0,"failed":0}}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["orders:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]},"post":{"operationId":"createOrder","tags":["Orders"],"summary":"Criar pedido","description":"Cria um pedido `pending_payment` de uma oferta `active`. `bump_ids` (opcional, até 3) acrescenta order bumps **ativos desta oferta**: o servidor valida e precifica cada um, e o `amount_minor` do pedido é a soma dos `items`. Bump de outra oferta, inativo, repetido ou desconhecido → `409 BUMP_NOT_AVAILABLE`, sem criar nada. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve o mesmo resultado, sem nova cobrança; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderRequest"},"example":{"offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","bump_ids":["ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a"]}}}},"responses":{"201":{"description":"Pedido criado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"},"example":{"id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","checkout_session_id":null,"amount_minor":"12600","currency":"BRL","status":"pending_payment","paid_payment_intent_id":null,"paid_charge_id":null,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z","paid_at":null,"canceled_at":null,"expired_at":null,"items":[{"id":"oi_1f2e3d4c5b6a79808f7e6d5c4b3a2918","kind":"main","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","offer_bump_id":null,"amount_minor":"9900","currency":"BRL","position":0},{"id":"oi_2a3b4c5d6e7f8091a2b3c4d5e6f70819","kind":"bump","offer_id":"off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d","product_id":"prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f","offer_bump_id":"ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a","amount_minor":"2700","currency":"BRL","position":1}]}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `BUMP_NOT_AVAILABLE`, `IDEMPOTENCY_CONFLICT`, `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["orders:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","BUMP_NOT_AVAILABLE","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/orders/{id}":{"get":{"operationId":"getOrder","tags":["Orders"],"summary":"Consultar pedido","description":"O pedido com a visão da listagem e o comprador completo em `buyer_details` (lido do pagamento do pedido).","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do pedido (`ord_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Pedido.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerOrderDetail"},"example":{"id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","checkout_session_id":null,"amount_minor":"9900","currency":"BRL","status":"paid","paid_payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","paid_charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z","paid_at":"2026-11-06T12:00:05.000Z","canceled_at":null,"expired_at":null,"items":[{"id":"oi_1f2e3d4c5b6a79808f7e6d5c4b3a2918","kind":"main","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","offer_bump_id":null,"amount_minor":"9900","currency":"BRL","position":0,"product_name":"Curso de fotografia"}],"product_name":"Curso de fotografia","offer_name":null,"payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","payment_method":"pix","buyer":{"name":"Ana C.","email":"a***@example.com","phone":"+55 11 9****-4321"},"display_status":"paid","refunded_minor":"0","buyer_details":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321"}}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["orders:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE","TENANT_SELECTION_REQUIRED"]}},"/v1/orders/{id}/cancel":{"post":{"operationId":"cancelOrder","tags":["Orders"],"summary":"Cancelar pedido","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do pedido (`ord_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Pedido cancelado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["orders:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/orders/{id}/expire":{"post":{"operationId":"expireOrder","tags":["Orders"],"summary":"Expirar pedido","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do pedido (`ord_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Pedido expirado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["orders:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/orders/{id}/payment-intents":{"post":{"operationId":"createOrderPaymentIntent","tags":["Orders"],"summary":"Criar PaymentIntent do pedido","description":"Cria um PaymentIntent com o valor e a moeda do pedido, ligado a ele (`order_id`). Um pedido tem no máximo um PaymentIntent vivo.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do pedido (`ord_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"201":{"description":"PaymentIntent criado para o pedido.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `INVALID_STATE_TRANSITION`, `PAYMENT_LIMIT_EXCEEDED`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated","payment_intent_create"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","PAYMENT_LIMIT_EXCEEDED","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/organization/closure-request":{"get":{"operationId":"getOrganizationClosureRequest","tags":["Organizations"],"summary":"Consultar pedido de encerramento","description":"Pedido de encerramento da organização atual, ou `data: null` se não houver.","security":[{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Pedido atual (ou `null`).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/OrganizationClosureRequest"},{"type":"null"}]}},"required":["data"]},"example":{"data":{"id":"ocr_2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a","organization_id":"org_6a5b4c3d2e1f00918273645546372819","reason":"Encerrando a operação de testes.","requested_at":"2026-11-06T12:00:00.000Z"}}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]},"post":{"operationId":"requestOrganizationClosure","tags":["Organizations"],"summary":"Pedir o encerramento da organização","description":"Só o OWNER, pela sessão do app. Registra o pedido para a operação da Wolf (nada é apagado; o ledger fica intacto). Repetir devolve o pedido existente com `200`.","security":[{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationClosureRequest"},"example":{"reason":"Encerrando a operação de testes."}}}},"responses":{"200":{"description":"Já existia um pedido; ele é devolvido sem mudança.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationClosureRequest"},"example":{"id":"ocr_2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a","organization_id":"org_6a5b4c3d2e1f00918273645546372819","reason":"Encerrando a operação de testes.","requested_at":"2026-11-06T12:00:00.000Z"}}}},"201":{"description":"Pedido registrado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationClosureRequest"},"example":{"id":"ocr_2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a","organization_id":"org_6a5b4c3d2e1f00918273645546372819","reason":"Encerrando a operação de testes.","requested_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/organizations":{"post":{"operationId":"createOrganization","tags":["Organizations"],"summary":"Criar organização","description":"Cria a organização do usuário da sessão. `display_name` é o nome público do checkout (2 a 80 caracteres; padrão: `legal_name`). Na edição de simulação, com a aprovação automática ligada, a organização já nasce ativa.","security":[{"sellerSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationRequest"},"example":{"legal_name":"Estúdio Exemplo Ltda","display_name":"Estúdio Exemplo"}}}},"responses":{"201":{"description":"Organização criada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"},"example":{"id":"org_6a5b4c3d2e1f00918273645546372819","seller_id":"sel_8f7e6d5c4b3a29180716253443526170","legal_name":"Estúdio Exemplo Ltda","display_name":"Estúdio Exemplo","status":"review","role":"OWNER","capabilities":["payments:read","payments:write","refunds:write","offers:read","offers:write","organization:close","organization:settings"],"timezone":"America/Sao_Paulo"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","VALIDATION_FAILED"]}},"/v1/organizations/current":{"patch":{"operationId":"updateCurrentOrganization","tags":["Organizations"],"summary":"Atualizar a organização atual","description":"Muda o fuso da organização (`timezone`), usado por todos os períodos do painel (\"hoje\" começa à meia-noite local). Só OWNER ou ADMIN, pela sessão do app. Auditado como `organization.timezone_changed` quando o valor muda; repetir o mesmo valor não muda nada. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCurrentOrganizationRequest"},"example":{"timezone":"America/Manaus"}}}},"responses":{"200":{"description":"Organização atualizada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"},"example":{"id":"org_6a5b4c3d2e1f00918273645546372819","seller_id":"sel_8f7e6d5c4b3a29180716253443526170","legal_name":"Estúdio Exemplo Ltda","display_name":"Estúdio Exemplo","status":"active","role":"OWNER","capabilities":["payments:read","payments:write","refunds:write","offers:read","offers:write","organization:close","organization:settings"],"timezone":"America/Manaus"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/payment-intents":{"post":{"operationId":"createPaymentIntent","tags":["PaymentIntents"],"summary":"Criar PaymentIntent","description":"Cria um PaymentIntent em `requires_payment_method`. `payment_method_types` define os métodos aceitos (padrão `[\"card\"]`); `payer` é opcional aqui e obrigatório no checkout hospedado. `pix` em `payment_method_types` com o Pix desligado no ambiente (kill switch `PIX_SIMULATION_ENABLED`) → `409 PAYMENT_METHOD_UNAVAILABLE`. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve o mesmo resultado, sem nova cobrança; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentIntentRequest"},"example":{"amount_minor":"9900","currency":"BRL","payment_method_types":["pix","card"],"payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"(11) 98765-4321","document":{"type":"cpf","number":"529.982.247-25"}},"description":"Curso de fotografia","metadata":{"pedido_interno":"A-1001"}}}}},"responses":{"201":{"description":"PaymentIntent criado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":null,"amount_minor":"9900","currency":"BRL","provider_id":"simulator","failure_code":null,"payment_method_types":["pix","card"],"description":"Curso de fotografia","metadata":{"pedido_interno":"A-1001"},"payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321","document":{"type":"cpf","last2":"25"}},"cancellation_reason":null,"status":"requires_payment_method","latest_provider_attempt_id":null,"payment_method_type":null,"next_action":null,"expires_at":null}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `PAYMENT_LIMIT_EXCEEDED`, `PAYMENT_METHOD_UNAVAILABLE`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated","payment_intent_create"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","PAYMENT_LIMIT_EXCEEDED","PAYMENT_METHOD_UNAVAILABLE","RATE_LIMITED","SERVICE_UNAVAILABLE","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/payment-intents/{id}":{"get":{"operationId":"getPaymentIntent","tags":["PaymentIntents"],"summary":"Consultar PaymentIntent","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do PaymentIntent (`pi_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"PaymentIntent.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":null,"amount_minor":"9900","currency":"BRL","provider_id":"simulator","failure_code":null,"payment_method_types":["pix","card"],"description":"Curso de fotografia","metadata":{"pedido_interno":"A-1001"},"payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321","document":{"type":"cpf","last2":"25"}},"cancellation_reason":null,"status":"succeeded","latest_provider_attempt_id":"pat_5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","payment_method_type":"pix","next_action":null,"expires_at":"2026-11-06T12:30:00.000Z"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/payment-intents/{id}/activity":{"get":{"operationId":"getPaymentIntentActivity","tags":["PaymentIntents"],"summary":"Linha do tempo do PaymentIntent","description":"Tentativas no provedor simulado, reembolsos e disputas do PaymentIntent (listas limitadas; `truncated` indica corte).","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do PaymentIntent (`pi_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Linha do tempo.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentActivity"},"example":{"payment_intent":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":null,"amount_minor":"9900","currency":"BRL","provider_id":"simulator","failure_code":null,"payment_method_types":["pix","card"],"description":"Curso de fotografia","metadata":{"pedido_interno":"A-1001"},"payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321","document":{"type":"cpf","last2":"25"}},"cancellation_reason":null,"status":"succeeded","latest_provider_attempt_id":"pat_5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","payment_method_type":"pix","next_action":null,"expires_at":"2026-11-06T12:30:00.000Z","created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z"},"attempts":[{"id":"pat_5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","state":"succeeded","provider_id":"simulator","external_id":"sim_pix_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","canonical_error_code":null,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z"}],"refunds":[{"id":"rfd_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d","payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","amount_minor":"4900","currency":"BRL","status":"succeeded","provider_id":"simulator","external_id":"sim_ref_4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c","failure_code":null,"created_at":"2026-11-06T12:00:05.000Z","updated_at":"2026-11-06T12:00:05.000Z"}],"disputes":[],"truncated":{"attempts":false,"refunds":false,"disputes":false}}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/payment-intents/{id}/confirm":{"post":{"operationId":"confirmPaymentIntent","tags":["PaymentIntents"],"summary":"Confirmar PaymentIntent","description":"Confirma com `{\"type\":\"pix\"}` (responde `202` com `status: \"processing\"` e `next_action.pix_qr` sintético) ou com um cartão de teste (`{\"type\":\"card\",\"test_card\":\"approved\"}`). O método precisa estar em `payment_method_types`. Cartão `unavailable_then_*` gera estado desconhecido no provedor: a resposta é `202 processing` e a reconciliação resolve depois. Recusa → `402 PAYMENT_DECLINED`. Com o Pix desligado no ambiente (kill switch `PIX_SIMULATION_ENABLED`) → `409 PAYMENT_METHOD_UNAVAILABLE`; cartão de teste não é afetado.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do PaymentIntent (`pi_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmPaymentIntentRequest"},"example":{"payment_method":{"type":"pix"}}}}},"responses":{"200":{"description":"Pagamento concluído (cartão de teste aprovado).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":null,"amount_minor":"9900","currency":"BRL","provider_id":"simulator","failure_code":null,"payment_method_types":["pix","card"],"description":"Curso de fotografia","metadata":{"pedido_interno":"A-1001"},"payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321","document":{"type":"cpf","last2":"25"}},"cancellation_reason":null,"status":"succeeded","latest_provider_attempt_id":"pat_5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","payment_method_type":"card","next_action":null,"expires_at":null}}}},"202":{"description":"Pagamento em processamento: Pix aguardando pagamento (com `next_action`) ou cartão em reconciliação.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":null,"amount_minor":"9900","currency":"BRL","provider_id":"simulator","failure_code":null,"payment_method_types":["pix","card"],"description":"Curso de fotografia","metadata":{"pedido_interno":"A-1001"},"payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321","document":{"type":"cpf","last2":"25"}},"cancellation_reason":null,"status":"processing","latest_provider_attempt_id":"pat_5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","payment_method_type":"pix","next_action":{"type":"pix_qr","qr_code_payload":"00020101021226780014br.gov.bcb.pix0120SIMULADO-NAO-PAGAVEL0232SIMULADO - NENHUMA COBRANCA REAL520400005303986540599.005802BR5921WOLF SANDBOX SIMULADO6009SAO PAULO62290525SIMULADO3b9f0c2d1e4a5b6c76304726B","expires_at":"2026-11-06T12:30:00.000Z"},"expires_at":"2026-11-06T12:30:00.000Z"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Erro: `PAYMENT_DECLINED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `INVALID_STATE_TRANSITION`, `PAYMENT_LIMIT_EXCEEDED`, `PAYMENT_METHOD_UNAVAILABLE`, `PROVIDER_STATE_UNKNOWN`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","PAYMENT_DECLINED","PAYMENT_LIMIT_EXCEEDED","PAYMENT_METHOD_UNAVAILABLE","PROVIDER_STATE_UNKNOWN","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/payment-intents/{id}/refunds":{"post":{"operationId":"createRefund","tags":["Refunds"],"summary":"Reembolsar PaymentIntent","description":"Cria um reembolso total ou parcial (`amount_minor`) de um PaymentIntent `succeeded`. A soma dos reembolsos nunca excede o capturado. `202` indica resultado desconhecido no provedor, resolvido por reconciliação. Pela sessão do app do seller exige reautenticação recente (até 10 minutos; senão `403 STEP_UP_REQUIRED`); API keys são autorizadas só pelo escopo `refunds:write`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do PaymentIntent (`pi_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRefundRequest"},"example":{"amount_minor":"4900"}}}},"responses":{"200":{"description":"Reembolso concluído.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"},"example":{"id":"rfd_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d","payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","amount_minor":"4900","currency":"BRL","status":"succeeded","provider_id":"simulator","external_id":"sim_ref_4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c","failure_code":null}}}},"202":{"description":"Reembolso com resultado desconhecido no provedor (em reconciliação).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`, `STEP_UP_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `INVALID_STATE_TRANSITION`, `REFUND_EXCEEDS_CAPTURED`, `REFUND_FAILED`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:read","refunds:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","REFUND_EXCEEDS_CAPTURED","REFUND_FAILED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE","STEP_UP_REQUIRED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/payment-links":{"get":{"operationId":"listPaymentLinks","tags":["Payment Links"],"summary":"Listar Payment Links","description":"Com os Payment Links desligados no ambiente (kill switch `PAYMENT_LINKS_ENABLED`) toda rota `/v1/payment-links*` responde `404 RESOURCE_NOT_FOUND`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"offer_id","in":"query","required":false,"schema":{"type":"string","maxLength":128,"pattern":"^off_[A-Za-z0-9]+$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","inactive"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Payment Links, mais recentes primeiro.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLinkList"},"example":{"data":[{"id":"plk_9f8e7d6c5b4a39281706f5e4d3c2b1a0","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","status":"active","session_count":12,"completed_session_count":7,"last_session_at":"2026-11-06T12:00:05.000Z","created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z"}]}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]},"post":{"operationId":"createPaymentLink","tags":["Payment Links"],"summary":"Criar Payment Link","description":"Cria um link `active` para uma oferta `active` do seller. A URL pública é `https://checkout.<domínio>/l/{id}`. Com os Payment Links desligados no ambiente (kill switch `PAYMENT_LINKS_ENABLED`) → `404 RESOURCE_NOT_FOUND`. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentLinkRequest"},"example":{"offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901"}}}},"responses":{"201":{"description":"Payment Link criado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"},"example":{"id":"plk_9f8e7d6c5b4a39281706f5e4d3c2b1a0","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","status":"active","session_count":0,"completed_session_count":0,"last_session_at":null,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read","offers:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/payment-links/{id}":{"get":{"operationId":"getPaymentLink","tags":["Payment Links"],"summary":"Consultar Payment Link","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do Payment Link (`plk_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Payment Link.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"},"example":{"id":"plk_9f8e7d6c5b4a39281706f5e4d3c2b1a0","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","status":"active","session_count":12,"completed_session_count":7,"last_session_at":"2026-11-06T12:00:05.000Z","created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/payment-links/{id}/status":{"patch":{"operationId":"setPaymentLinkStatus","tags":["Payment Links"],"summary":"Ativar ou desativar Payment Link","description":"Um link `inactive` não abre sessões. Repetir o estado atual não muda nada. Com os Payment Links desligados no ambiente (kill switch `PAYMENT_LINKS_ENABLED`) toda rota `/v1/payment-links*` responde `404 RESOURCE_NOT_FOUND`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do Payment Link (`plk_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLinkStatusRequest"},"example":{"status":"inactive"}}}},"responses":{"200":{"description":"Payment Link atualizado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"},"example":{"id":"plk_9f8e7d6c5b4a39281706f5e4d3c2b1a0","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","status":"inactive","session_count":12,"completed_session_count":7,"last_session_at":"2026-11-06T12:00:05.000Z","created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["offers:read","offers:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/payouts":{"get":{"operationId":"listPayouts","tags":["Payouts, Settlements & Disputes"],"summary":"Listar repasses sintéticos","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Repasses.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payout"}}},"required":["data"]},"example":{"data":[{"id":"pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","amount_minor":"150000","currency":"BRL","status":"paid","origin":"admin","provider_id":"simulator","provider_request_key":"payout:pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","external_id":"sim_pyo_1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a","destination_ref":"sim_conta_principal","provider_status":"paid","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z","resolved_at":"2026-11-06T12:00:05.000Z"}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]},"post":{"operationId":"createSellerPayout","tags":["Payouts, Settlements & Disputes"],"summary":"Solicitar saque sintético","description":"Saque **sintético** do saldo disponível (nenhum dinheiro real se move). Só pela sessão humana do app do seller, com papel que tenha `payouts:write` (OWNER ou ADMIN) e reautenticação recente (até 10 minutos; senão `403 STEP_UP_REQUIRED`); API keys recebem `403` nesta versão. Valor em unidades menores: mínimo `1000` (R$ 10,00, senão `409 PAYOUT_BELOW_MINIMUM`) e no máximo o saldo disponível (`409 PAYOUT_AMOUNT_EXCEEDS_AVAILABLE`). Dois pedidos simultâneos com saldo para um só: só um é aceito. O saque nasce `created` (em processamento) e é resolvido de forma sintética em cerca de 2 minutos (`paid`), ou marcado como falha pela operação da Wolf. Só existe com a flag `SELLER_PAYOUTS_ENABLED` ligada no ambiente (senão `404`). Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve o mesmo resultado, sem nova cobrança; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSellerPayoutRequest"},"example":{"amount_minor":"123456","currency":"BRL"}}}},"responses":{"200":{"description":"Replay da mesma `Idempotency-Key`: o mesmo saque, sem novo débito.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payout"},"example":{"id":"pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","amount_minor":"123456","currency":"BRL","status":"created","origin":"seller","provider_id":"simulator","provider_request_key":"payout:pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","external_id":null,"destination_ref":"sim_seller_default","provider_status":"created","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z","resolved_at":null}}}},"201":{"description":"Saque criado (em processamento).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payout"},"example":{"id":"pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","amount_minor":"123456","currency":"BRL","status":"created","origin":"seller","provider_id":"simulator","provider_request_key":"payout:pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","external_id":null,"destination_ref":"sim_seller_default","provider_status":"created","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:00.000Z","resolved_at":null}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`, `STEP_UP_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `PAYOUT_AMOUNT_EXCEEDS_AVAILABLE`, `PAYOUT_BELOW_MINIMUM`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","PAYOUT_AMOUNT_EXCEEDS_AVAILABLE","PAYOUT_BELOW_MINIMUM","RATE_LIMITED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE","STEP_UP_REQUIRED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/payouts/{id}":{"get":{"operationId":"getPayout","tags":["Payouts, Settlements & Disputes"],"summary":"Consultar repasse sintético","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do repasse (`pyo_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Repasse.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payout"},"example":{"id":"pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","amount_minor":"150000","currency":"BRL","status":"paid","origin":"admin","provider_id":"simulator","provider_request_key":"payout:pyo_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e","external_id":"sim_pyo_1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a","destination_ref":"sim_conta_principal","provider_status":"paid","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z","resolved_at":"2026-11-06T12:00:05.000Z"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/products":{"get":{"operationId":"listProducts","tags":["Products"],"summary":"Listar produtos","description":"Sem parâmetros de consulta a resposta é a lista completa legada (`{data}`); com qualquer parâmetro ela é paginada por cursor (`{data, next_cursor}`). Parâmetro desconhecido → `400 VALIDATION_FAILED`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","active","archived"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048,"pattern":"^c1_[0-9a-f]+$"}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Produtos. A página traz também `offers_count`, `links_count` (links ativos), `bumps_count` e `revenue_30d_minor` (bruto em BRL dos últimos 30 dias locais).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SellerProductPage"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}},"required":["data"]}]},"example":{"data":[{"id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","name":"Curso de fotografia","status":"active","created_at":"2026-11-06T12:00:00.000Z","description":"Do básico à edição: 40 aulas gravadas e exercícios práticos.","category":"design_fotografia","sales_page_url":"https://example.com/curso-de-fotografia","guarantee_days":7,"support_name":"Equipe Estúdio Exemplo","support_email":"suporte@example.com","support_whatsapp":"+5511912345678","statement_descriptor":"EXEMPLO FOTO","offer_count":1,"active_offer_count":1,"offers_count":1,"links_count":1,"bumps_count":0,"revenue_30d_minor":"29700"}],"next_cursor":null}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]},"post":{"operationId":"createProduct","tags":["Products"],"summary":"Criar produto","description":"Cria um produto em `draft`. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductRequest"},"example":{"name":"Curso de fotografia"}}}},"responses":{"201":{"description":"Produto criado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"},"example":{"id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","name":"Curso de fotografia","status":"draft","created_at":"2026-11-06T12:00:00.000Z","description":"Do básico à edição: 40 aulas gravadas e exercícios práticos.","category":"design_fotografia","sales_page_url":"https://example.com/curso-de-fotografia","guarantee_days":7,"support_name":"Equipe Estúdio Exemplo","support_email":"suporte@example.com","support_whatsapp":"+5511912345678","statement_descriptor":"EXEMPLO FOTO"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read","products:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/products/{id}":{"get":{"operationId":"getProduct","tags":["Products"],"summary":"Consultar produto","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do produto (`prd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Produto.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"},"example":{"id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","name":"Curso de fotografia","status":"active","created_at":"2026-11-06T12:00:00.000Z","description":"Do básico à edição: 40 aulas gravadas e exercícios práticos.","category":"design_fotografia","sales_page_url":"https://example.com/curso-de-fotografia","guarantee_days":7,"support_name":"Equipe Estúdio Exemplo","support_email":"suporte@example.com","support_whatsapp":"+5511912345678","statement_descriptor":"EXEMPLO FOTO"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]},"patch":{"operationId":"updateProduct","tags":["Products"],"summary":"Atualizar a ficha do produto","description":"Atualiza a ficha: `description` (texto simples, até 2.000 caracteres, sem HTML), `category` (lista fechada), `sales_page_url` (https), `guarantee_days` (garantia do produtor, 0 a 30 dias; não é garantia de pagamento), `support_name`, `support_email`, `support_whatsapp` (E.164, ex.: `+5511912345678`) e `statement_descriptor` (até 13 letras, números ou espaços; guardado, sem efeito no simulador). Envie só os campos a mudar; `null` limpa o campo. O checkout hospedado mostra descrição, suporte e garantia do produtor. Toda mudança é auditada.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do produto (`prd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductRequest"},"example":{"description":"Do básico à edição: 40 aulas gravadas e exercícios práticos.","category":"design_fotografia","guarantee_days":7,"support_email":"suporte@example.com","support_whatsapp":"+5511912345678","statement_descriptor":"EXEMPLO FOTO"}}}},"responses":{"200":{"description":"Produto com a ficha atualizada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"},"example":{"id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","name":"Curso de fotografia","status":"active","created_at":"2026-11-06T12:00:00.000Z","description":"Do básico à edição: 40 aulas gravadas e exercícios práticos.","category":"design_fotografia","sales_page_url":"https://example.com/curso-de-fotografia","guarantee_days":7,"support_name":"Equipe Estúdio Exemplo","support_email":"suporte@example.com","support_whatsapp":"+5511912345678","statement_descriptor":"EXEMPLO FOTO"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read","products:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/products/{id}/access-links":{"get":{"operationId":"listProductAccessLinks","tags":["Products"],"summary":"Listar links de acesso","description":"Links de entrega do produto (no máximo 5), na ordem do recibo. O comprador só os vê no recibo depois do pagamento aprovado.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do produto (`prd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Links de acesso.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductAccessLinkList"},"example":{"data":[{"id":"pal_4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","label":"Área de membros","url":"https://membros.example.com/curso-de-fotografia","host":"membros.example.com","position":0,"created_at":"2026-11-06T12:00:00.000Z"}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]},"post":{"operationId":"createProductAccessLink","tags":["Products"],"summary":"Adicionar link de acesso","description":"Adiciona um link https (rótulo de até 80 caracteres) ao fim da lista; no máximo 5 por produto (`409 PRODUCT_ACCESS_LINK_LIMIT_REACHED`). O link aparece no recibo do checkout só depois do pagamento aprovado, com o domínio visível e sem redirecionamento automático. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do produto (`prd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductAccessLinkRequest"},"example":{"label":"Área de membros","url":"https://membros.example.com/curso-de-fotografia"}}}},"responses":{"201":{"description":"Link criado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductAccessLink"},"example":{"id":"pal_4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","label":"Área de membros","url":"https://membros.example.com/curso-de-fotografia","host":"membros.example.com","position":0,"created_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `PRODUCT_ACCESS_LINK_LIMIT_REACHED`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read","products:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","PRODUCT_ACCESS_LINK_LIMIT_REACHED","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/products/{id}/access-links/{linkId}":{"delete":{"operationId":"deleteProductAccessLink","tags":["Products"],"summary":"Remover link de acesso","description":"Remove o link da entrega (auditado); depois disso ele responde `404`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do produto (`prd_...`).","schema":{"type":"string","minLength":1}},{"name":"linkId","in":"path","required":true,"description":"Id do link de acesso (`pal_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Link removido.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductAccessLink"},"example":{"id":"pal_4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","label":"Área de membros","url":"https://membros.example.com/curso-de-fotografia","host":"membros.example.com","position":0,"created_at":"2026-11-06T12:00:00.000Z"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read","products:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/products/{id}/status":{"patch":{"operationId":"setProductStatus","tags":["Products"],"summary":"Mudar status do produto","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do produto (`prd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogStatusRequest"},"example":{"status":"active"}}}},"responses":{"200":{"description":"Produto atualizado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"},"example":{"id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","name":"Curso de fotografia","status":"active","created_at":"2026-11-06T12:00:00.000Z","description":"Do básico à edição: 40 aulas gravadas e exercícios práticos.","category":"design_fotografia","sales_page_url":"https://example.com/curso-de-fotografia","guarantee_days":7,"support_name":"Equipe Estúdio Exemplo","support_email":"suporte@example.com","support_whatsapp":"+5511912345678","statement_descriptor":"EXEMPLO FOTO"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["products:read","products:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/public/checkout-sessions/{id}":{"get":{"operationId":"getPublicCheckoutSession","tags":["Public Checkout"],"summary":"Ler sessão pública (polling)","description":"Visão do comprador: nome público do seller, produto e descrição, suporte e garantia do produtor (`guarantee_days`), métodos aceitos pela oferta, valor, estado da sessão e do pagamento atual. `access_links` (links de entrega com o domínio) vem preenchido só depois do pagamento aprovado; antes é `null`. `bumps` lista os order bumps ativos da oferta (vazio com `CHECKOUT_BUMPS_ENABLED` desligado) e, depois da primeira tentativa de pagamento, `order` traz o pedido com seus itens e `selected_bump_ids` a seleção fixada. Nunca o id do seller. Sessão vencida responde `200` com `status: \"expired\"`; segredo errado → `404`.","security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da sessão (`cs_...`).","schema":{"type":"string","minLength":1}},{"name":"x-checkout-secret","in":"header","required":true,"description":"`client_secret` (`csec_...`) da sessão. O checkout hospedado o guarda em cookie httpOnly e o envia pelo servidor.","schema":{"type":"string","pattern":"^csec_.*"}}],"responses":{"200":{"description":"Sessão.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCheckoutSession"},"example":{"id":"cs_2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","amount_minor":"9900","currency":"BRL","status":"open","payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","expires_at":"2026-11-06T12:30:00.000Z","seller":{"display_name":"Estúdio Exemplo"},"product":{"name":"Curso de fotografia","description":"Do básico à edição: 40 aulas gravadas e exercícios práticos."},"support":{"name":"Equipe Estúdio Exemplo","email":"suporte@example.com","whatsapp":"+5511912345678"},"guarantee_days":7,"accepted_methods":["pix","card"],"access_links":null,"payment":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","status":"processing","amount_minor":"12600","currency":"BRL","failure_code":null,"next_action":{"type":"pix_qr","qr_code_payload":"00020101021226780014br.gov.bcb.pix0120SIMULADO-NAO-PAGAVEL0232SIMULADO - NENHUMA COBRANCA REAL520400005303986540599.005802BR5921WOLF SANDBOX SIMULADO6009SAO PAULO62290525SIMULADO3b9f0c2d1e4a5b6c76304726B","expires_at":"2026-11-06T12:30:00.000Z"},"cancellation_reason":null},"bumps":[{"id":"ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a","headline":"Adicionar à compra: Guia bônus","description":"Checklist em PDF com 40 poses para ensaios.","product_name":"Guia bônus de poses","amount_minor":"2700","currency":"BRL"}],"order":{"id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","amount_minor":"12600","currency":"BRL","items":[{"kind":"main","bump_id":null,"product_name":"Curso de fotografia","amount_minor":"9900","currency":"BRL"},{"kind":"bump","bump_id":"ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a","product_name":"Guia bônus de poses","amount_minor":"2700","currency":"BRL"}]},"selected_bump_ids":["ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a"]}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-error-codes":["INTERNAL_ERROR","RESOURCE_NOT_FOUND","VALIDATION_FAILED"]}},"/v1/public/checkout-sessions/{id}/lead":{"post":{"operationId":"captureCheckoutLead","tags":["Public Checkout"],"summary":"Registrar os dados do comprador (etapa 1)","description":"Chamado pelo **servidor** do checkout hospedado quando o comprador conclui a etapa 1 (dados), que mostra o aviso \"Usaremos seu e-mail e telefone para te ajudar a concluir a compra.\". Um registro por sessão: repetir atualiza os dados. Só uma sessão aberta aceita (concluída → `409 INVALID_STATE_TRANSITION`; expirada → `400`). O telefone é opcional e só do Brasil (DDD + número); é guardado em E.164. A resposta nunca devolve os dados. Limitado pelo escopo `checkout_pay` (sessão + IP); não exige o Turnstile, que continua no pagamento. Os dados valem para a recuperação da venda por 30 dias e depois são anonimizados; nunca vão para webhooks.","security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da sessão (`cs_...`).","schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureCheckoutLeadRequest"},"example":{"client_secret":"csec_EXEMPLO_segredo_de_uso_unico_da_sessao","name":"Ana Compradora","email":"ana@example.com","phone":"(11) 98765-4321"}}}},"responses":{"200":{"description":"Dados registrados.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturedCheckoutLead"},"example":{"checkout_session_id":"cs_2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f","captured":true}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["checkout_pay"],"x-wolf-error-codes":["INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","VALIDATION_FAILED"]}},"/v1/public/checkout-sessions/{id}/pay":{"post":{"operationId":"payCheckoutSession","tags":["Public Checkout"],"summary":"Pagar sessão de checkout","description":"Cria o pedido da oferta (uma vez por sessão) e o PaymentIntent com o pagador e confirma com o método escolhido. Pix responde `202` com o QR sintético; cartão de teste aprovado responde `200`; recusa → `402`. A resposta é a visão do comprador (sem pagador nem ids do provedor). Método fora dos `accepted_methods` da oferta → `409 PAYMENT_METHOD_NOT_ACCEPTED`, antes de criar pedido ou pagamento. Com o Pix desligado no ambiente (kill switch `PIX_SIMULATION_ENABLED`) → `409 PAYMENT_METHOD_UNAVAILABLE`; cartão de teste não é afetado. `bump_ids` (opcional) são order bumps da sessão (`bumps` da leitura pública): o servidor valida e precifica, e o PaymentIntent tem o valor total do pedido. Bump inválido, inativo, repetido ou de outra oferta → `409 BUMP_NOT_AVAILABLE`, sem cobrança. A primeira tentativa fixa os itens do pedido: tentativas seguintes repetem a mesma seleção (`selected_bump_ids`); outra seleção → `409 IDEMPOTENCY_CONFLICT`, sem cobrança.","security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da sessão (`cs_...`).","schema":{"type":"string","minLength":1}},{"name":"wolf-turnstile-token","in":"header","required":false,"description":"Token do Cloudflare Turnstile (verificação humana) obtido pelo checkout hospedado. Obrigatório quando o ambiente tem o widget configurado; ausente ou inválido → `403 CAPTCHA_REQUIRED`. Cada token vale uma única vez, por até 300 s.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayCheckoutSessionRequest"},"example":{"client_secret":"csec_EXEMPLO_segredo_de_uso_unico_da_sessao","payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"(11) 98765-4321","document":{"type":"cpf","number":"529.982.247-25"}},"payment_method":{"type":"pix"},"bump_ids":["ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a"]}}}},"responses":{"200":{"description":"Pagamento concluído.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutPayment"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","status":"succeeded","amount_minor":"9900","currency":"BRL","failure_code":null,"next_action":null,"cancellation_reason":null}}}},"202":{"description":"Pagamento em processamento (Pix aguardando ou cartão em reconciliação).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutPayment"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","status":"processing","amount_minor":"9900","currency":"BRL","failure_code":null,"next_action":{"type":"pix_qr","qr_code_payload":"00020101021226780014br.gov.bcb.pix0120SIMULADO-NAO-PAGAVEL0232SIMULADO - NENHUMA COBRANCA REAL520400005303986540599.005802BR5921WOLF SANDBOX SIMULADO6009SAO PAULO62290525SIMULADO3b9f0c2d1e4a5b6c76304726B","expires_at":"2026-11-06T12:30:00.000Z"},"cancellation_reason":null}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Erro: `PAYMENT_DECLINED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `CAPTCHA_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `BUMP_NOT_AVAILABLE`, `IDEMPOTENCY_CONFLICT`, `INVALID_STATE_TRANSITION`, `PAYMENT_LIMIT_EXCEEDED`, `PAYMENT_METHOD_NOT_ACCEPTED`, `PAYMENT_METHOD_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-idempotency":"required","x-wolf-rate-limits":["checkout_pay"],"x-wolf-error-codes":["BUMP_NOT_AVAILABLE","CAPTCHA_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","PAYMENT_DECLINED","PAYMENT_LIMIT_EXCEEDED","PAYMENT_METHOD_NOT_ACCEPTED","PAYMENT_METHOD_UNAVAILABLE","RATE_LIMITED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE","VALIDATION_FAILED"]}},"/v1/public/checkout-sessions/{id}/pix/simulate-payment":{"post":{"operationId":"simulateCheckoutPixPayment","tags":["Public Checkout"],"summary":"Simular pagamento do Pix da sessão","description":"Botão \"Simular pagamento\" do checkout: age só sobre o PaymentIntent da própria sessão. Repetir não faz nada. Só existe na edição de simulação. Com o Pix desligado no ambiente (kill switch `PIX_SIMULATION_ENABLED`) → `409 PAYMENT_METHOD_UNAVAILABLE`, antes da verificação do Turnstile.","security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da sessão (`cs_...`).","schema":{"type":"string","minLength":1}},{"name":"wolf-turnstile-token","in":"header","required":false,"description":"Token do Cloudflare Turnstile (verificação humana) obtido pelo checkout hospedado. Obrigatório quando o ambiente tem o widget configurado; ausente ou inválido → `403 CAPTCHA_REQUIRED`. Cada token vale uma única vez, por até 300 s.","schema":{"type":"string","minLength":1,"maxLength":2048}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutSessionSecretRequest"},"example":{"client_secret":"csec_EXEMPLO_segredo_de_uso_unico_da_sessao"}}}},"responses":{"200":{"description":"Pagamento após a simulação.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutPayment"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":"ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0","status":"succeeded","amount_minor":"9900","currency":"BRL","failure_code":null,"next_action":null,"cancellation_reason":null}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `CAPTCHA_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`, `PAYMENT_METHOD_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["checkout_pay"],"x-wolf-edition":"production-simulation","x-wolf-error-codes":["CAPTCHA_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","PAYMENT_METHOD_UNAVAILABLE","RATE_LIMITED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE","VALIDATION_FAILED"]}},"/v1/public/checkout-sessions/{id}/reconcile":{"post":{"operationId":"reconcileCheckoutSession","tags":["Public Checkout"],"summary":"Reconciliar pagamento da sessão","description":"Consulta o provedor simulado pelo pagamento da sessão em estado desconhecido. Só existe na edição de simulação.","security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da sessão (`cs_...`).","schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutSessionSecretRequest"},"example":{"client_secret":"csec_EXEMPLO_segredo_de_uso_unico_da_sessao"}}}},"responses":{"200":{"description":"Resultado definitivo.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutPayment"}}}},"202":{"description":"Ainda sem resultado definitivo.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutPayment"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Erro: `PAYMENT_DECLINED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["checkout_pay"],"x-wolf-edition":"production-simulation","x-wolf-error-codes":["INTERNAL_ERROR","PAYMENT_DECLINED","RATE_LIMITED","RESOURCE_NOT_FOUND","VALIDATION_FAILED"]}},"/v1/public/payment-links/{id}/session":{"get":{"operationId":"openPaymentLinkSession","tags":["Public Checkout"],"summary":"Abrir sessão de um Payment Link","description":"Chamado pelo **servidor** do checkout hospedado: cria uma sessão para um link `active` de seller e oferta ativos e devolve o segredo de uso único da sessão. Link inexistente, inativo ou de seller/oferta inativos → `404` (sem dizer qual). Limitado por IP e verificado pelo Turnstile (quando o ambiente tem o widget) antes de qualquer consulta. Com os Payment Links desligados no ambiente (kill switch `PAYMENT_LINKS_ENABLED`) → `404`, antes de qualquer outra verificação.","security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do Payment Link (`plk_...`).","schema":{"type":"string","minLength":1}},{"name":"wolf-turnstile-token","in":"header","required":false,"description":"Token do Cloudflare Turnstile (verificação humana) obtido pelo checkout hospedado. Obrigatório quando o ambiente tem o widget configurado; ausente ou inválido → `403 CAPTCHA_REQUIRED`. Cada token vale uma única vez, por até 300 s.","schema":{"type":"string","minLength":1,"maxLength":2048}}],"responses":{"201":{"description":"Sessão aberta.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenedPaymentLinkSession"},"example":{"checkout_session_id":"cs_2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f","client_secret":"csec_EXEMPLO_segredo_de_uso_unico_da_sessao","expires_at":"2026-11-06T13:00:00.000Z"}}}},"403":{"description":"Erro: `CAPTCHA_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-rate-limits":["payment_link_open"],"x-wolf-error-codes":["CAPTCHA_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE"]}},"/v1/refunds/{id}":{"get":{"operationId":"getRefund","tags":["Refunds"],"summary":"Consultar reembolso","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do reembolso (`rfd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Reembolso.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"},"example":{"id":"rfd_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d","payment_intent_id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","amount_minor":"4900","currency":"BRL","status":"succeeded","provider_id":"simulator","external_id":"sim_ref_4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c","failure_code":null}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/reports/abandoned-checkouts":{"get":{"operationId":"listAbandonedCheckouts","tags":["Reports"],"summary":"Checkouts abandonados","description":"Compradores que concluíram a etapa 1 do checkout e não pagaram: a sessão expirou ou passaram 30 minutos sem pagamento aprovado (um Pix emitido ou um cartão em processamento ainda não conta). Mais recentes primeiro, um por oferta e e-mail; some quando o mesmo e-mail compra a mesma oferta depois. `from`/`to` são dias no fuso da organização (`timezone`). Nome, e-mail e telefone vêm completos só para quem lê vendas (`orders:read`); para os demais, mascarados. Os dados ficam 30 dias. Sem exportação.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"product_id","in":"query","required":false,"schema":{"type":"string","maxLength":128,"pattern":"^prd_[A-Za-z0-9]+$"}},{"name":"offer_id","in":"query","required":false,"schema":{"type":"string","maxLength":128,"pattern":"^off_[A-Za-z0-9]+$"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048,"pattern":"^a1_[0-9a-f]+$"}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Página de checkouts abandonados.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbandonedCheckoutPage"},"example":{"data":[{"id":"lead_5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e","checkout_session_id":"cs_2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","product_id":"prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e","product_name":"Curso de fotografia","amount_minor":"9900","currency":"BRL","customer":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321","visibility":"full"},"captured_at":"2026-11-06T12:00:00.000Z","reason":"expired"}],"next_cursor":null,"timezone":"America/Sao_Paulo"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["reports:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/reports/abandoned-checkouts/{leadId}/recovery-link":{"post":{"operationId":"createCheckoutRecoveryLink","tags":["Reports"],"summary":"Gerar link de recuperação","description":"Cria uma **nova** sessão de checkout para a oferta do abandono, válida por 24 horas, com o seu próprio `client_secret` (nunca o da sessão abandonada). A URL do comprador é `https://checkout.<domínio>/{id}?secret={client_secret}`, sem nenhum dado do comprador. Oferta inativa → `400`; comprador que já pagou → `409 INVALID_STATE_TRANSITION`. Auditado. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`. Um replay devolve a sessão sem o segredo (`secret_already_revealed: true`).","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"leadId","in":"path","required":true,"description":"Id do checkout abandonado (`lead_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyRequest"},"example":{}}}},"responses":{"201":{"description":"Sessão de recuperação criada (ou replay sem o segredo).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreatedCheckoutRecoveryLink"},{"$ref":"#/components/schemas/ReplayedCheckoutRecoveryLink"}]},"example":{"id":"cs_8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b","offer_id":"off_1b2c3d4e5f60718293a4b5c6d7e8f901","amount_minor":"9900","currency":"BRL","status":"open","payment_intent_id":null,"expires_at":"2026-11-07T12:00:00.000Z","client_secret":"csec_EXEMPLO_segredo_novo_de_uso_unico","lead_id":"lead_5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["orders:read","offers:read"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/settlements":{"get":{"operationId":"listSettlements","tags":["Payouts, Settlements & Disputes"],"summary":"Listar liquidações sintéticas","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Lotes de liquidação.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SettlementBatch"}}},"required":["data"]},"example":{"data":[{"id":"stb_4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f","provider_id":"simulator","external_id":"sim_lote_2026_11_06","window_start":"2026-11-05T00:00:00.000Z","window_end":"2026-11-06T00:00:00.000Z","status":"completed","origin":"admin","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z","finalized_at":"2026-11-06T12:00:05.000Z","lines":[{"id":"stl_6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b","charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","amount_minor":"9900","fee_minor":"396","currency":"BRL","status":"available","available_minor":"9504","reserve_minor":"0","reconciliation_case_id":null}]}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]}},"/v1/settlements/{id}":{"get":{"operationId":"getSettlement","tags":["Payouts, Settlements & Disputes"],"summary":"Consultar liquidação sintética","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do lote (`stb_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Lote de liquidação.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementBatch"},"example":{"id":"stb_4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f","provider_id":"simulator","external_id":"sim_lote_2026_11_06","window_start":"2026-11-05T00:00:00.000Z","window_end":"2026-11-06T00:00:00.000Z","status":"completed","origin":"admin","synthetic_obligation":true,"created_at":"2026-11-06T12:00:00.000Z","updated_at":"2026-11-06T12:00:05.000Z","finalized_at":"2026-11-06T12:00:05.000Z","lines":[{"id":"stl_6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b","charge_id":"chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d","amount_minor":"9900","fee_minor":"396","currency":"BRL","status":"available","available_minor":"9504","reserve_minor":"0","reconciliation_case_id":null}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["finance:read"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/simulator/payment-intents/{id}/pix/pay":{"post":{"operationId":"simulatePixPayment","tags":["Simulator"],"summary":"Simular o pagamento de um Pix","description":"Gera o evento de provedor `pix.paid` do PaymentIntent confirmado com Pix: o pagamento vira `succeeded` (Charge, ledger e webhooks `payment.*` na mesma transação). Repetir não faz nada. Só existe na edição de simulação. Com o Pix desligado no ambiente (kill switch `PIX_SIMULATION_ENABLED`) → `409 PAYMENT_METHOD_UNAVAILABLE`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do PaymentIntent (`pi_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"PaymentIntent após o pagamento simulado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"},"example":{"id":"pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e","order_id":null,"amount_minor":"9900","currency":"BRL","provider_id":"simulator","failure_code":null,"payment_method_types":["pix","card"],"description":"Curso de fotografia","metadata":{"pedido_interno":"A-1001"},"payer":{"name":"Ana Compradora","email":"ana@example.com","phone":"+5511987654321","document":{"type":"cpf","last2":"25"}},"cancellation_reason":null,"status":"succeeded","latest_provider_attempt_id":"pat_5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","payment_method_type":"pix","next_action":null,"expires_at":"2026-11-06T12:30:00.000Z"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`, `PAYMENT_METHOD_UNAVAILABLE`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-edition":"production-simulation","x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","INVALID_STATE_TRANSITION","PAYMENT_METHOD_UNAVAILABLE","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/simulator/payment-intents/{id}/reconcile":{"post":{"operationId":"reconcilePaymentIntent","tags":["Simulator"],"summary":"Reconciliar PaymentIntent agora","description":"Consulta o provedor simulado pela tentativa em estado desconhecido e aplica o resultado, sem esperar o ciclo automático de reconciliação.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do PaymentIntent (`pi_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Resultado definitivo aplicado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"}}}},"202":{"description":"O provedor ainda não tem resultado definitivo.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Erro: `PAYMENT_DECLINED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-edition":"production-simulation","x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","PAYMENT_DECLINED","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/simulator/refunds/{id}/reconcile":{"post":{"operationId":"reconcileRefund","tags":["Simulator"],"summary":"Reconciliar reembolso agora","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do reembolso (`rfd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Resultado definitivo aplicado.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"}}}},"202":{"description":"O provedor ainda não tem resultado definitivo.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `REFUND_FAILED`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["payments:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-edition":"production-simulation","x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","REFUND_FAILED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/webhooks/deliveries":{"get":{"operationId":"listWebhookDeliveries","tags":["Webhooks"],"summary":"Listar entregas recentes","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Entregas, mais recentes primeiro.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}}},"required":["data"]},"example":{"data":[{"id":"whd_5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c","endpoint_id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","event_id":"evt_7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e","event_type":"webhook.test","attempt":1,"status":"pending","response_status":null,"latency_ms":null,"created_at":"2026-11-06T12:00:00.000Z"}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]}},"/v1/webhooks/deliveries/{id}/replay":{"post":{"operationId":"replayWebhookDelivery","tags":["Webhooks"],"summary":"Reenviar entrega (replay)","description":"Nova tentativa do mesmo evento (mesmo `event_id`, `attempt` maior) para o mesmo endpoint. Endpoint desativado → `409 WEBHOOK_ENDPOINT_DISABLED`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da entrega de origem (`whd_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyRequest"},"example":{}}}},"responses":{"202":{"description":"Nova entrega criada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"},"example":{"id":"whd_5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c","endpoint_id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","event_id":"evt_7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e","event_type":"payment.paid","attempt":2,"status":"pending","response_status":null,"latency_ms":null,"created_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`, `WEBHOOK_ENDPOINT_DISABLED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED","WEBHOOK_ENDPOINT_DISABLED"]}},"/v1/webhooks/endpoints":{"get":{"operationId":"listWebhookEndpoints","tags":["Webhooks"],"summary":"Listar endpoints","description":"Lista os endpoints do seller, sem os excluídos.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Endpoints.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"required":["data"]},"example":{"data":[{"id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","url":"https://example.com/wolf/webhooks","enabled":true,"status":"active","disabled_reason":null,"consecutive_failures":0,"selected_events":["payment.paid","payment.canceled"],"product_ids":[],"payment_methods":[],"delivery_mode":"live","secret_rotated_at":null,"deleted_at":null,"created_at":"2026-11-06T12:00:00.000Z"}]}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","RATE_LIMITED","TENANT_SELECTION_REQUIRED"]},"post":{"operationId":"createWebhookEndpoint","tags":["Webhooks"],"summary":"Criar endpoint","description":"Cadastra uma URL HTTPS. `live` (padrão recomendado) exige sessão humana do seller e devolve o `signing_secret` uma única vez; em produção `simulated` é recusado (`400`). URLs da própria Wolf e destinos privados são recusados. Repetir a requisição com a mesma `Idempotency-Key` e o mesmo corpo devolve a mesma resposta com `idempotent-replayed: true`; corpo diferente → `409 IDEMPOTENCY_CONFLICT`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookEndpointRequest"},"example":{"url":"https://example.com/wolf/webhooks","selected_events":["payment.paid","payment.canceled"],"delivery_mode":"live"}}}},"responses":{"201":{"description":"Endpoint criado (`live` com o segredo, replay sem ele, ou `simulated`).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/CreatedLiveWebhookEndpoint"},{"$ref":"#/components/schemas/ReplayedLiveWebhookEndpoint"}]},{"$ref":"#/components/schemas/WebhookEndpoint"}]},"example":{"id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","url":"https://example.com/wolf/webhooks","enabled":true,"status":"active","disabled_reason":null,"consecutive_failures":0,"selected_events":["payment.paid","payment.canceled"],"product_ids":[],"payment_methods":[],"delivery_mode":"live","secret_rotated_at":null,"deleted_at":null,"created_at":"2026-11-06T12:00:00.000Z","signing_secret":"whsec_live_EXEMPLO_nao_use_em_producao"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","SERVICE_UNAVAILABLE","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/webhooks/endpoints/{id}":{"patch":{"operationId":"updateWebhookEndpoint","tags":["Webhooks"],"summary":"Atualizar endpoint (status e filtros)","description":"`status`: `disabled` grava `disabled_reason: \"manual\"`; `active` limpa o motivo e zera `consecutive_failures`. `product_ids` (produtos da própria conta) e `payment_methods` (`card`, `pix`) substituem os filtros de entrega; lista vazia = todos. A entrega respeita os três filtros (eventos, produtos e métodos). Eventos de uma venda (`payment.*`, `refund.*`, `dispute.*`, `order.*`, `checkout.session.*`) só passam por um filtro não vazio quando o produto ou o método é conhecido e está na lista; eventos da conta (`payout.*`, `settlement.*`, …) ignoram os filtros de produto e método. Informe ao menos um campo; repetir os valores atuais não muda nada.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do endpoint (`whe_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookEndpointRequest"},"example":{"product_ids":["prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e"],"payment_methods":["pix"]}}}},"responses":{"200":{"description":"Endpoint.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"},"example":{"id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","url":"https://example.com/wolf/webhooks","enabled":true,"status":"active","disabled_reason":null,"consecutive_failures":0,"selected_events":["payment.paid","payment.canceled"],"product_ids":["prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e"],"payment_methods":["pix"],"delivery_mode":"live","secret_rotated_at":null,"deleted_at":null,"created_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]},"delete":{"operationId":"deleteWebhookEndpoint","tags":["Webhooks"],"summary":"Excluir endpoint","description":"Exclusão lógica e terminal: o endpoint some da listagem e responde `404` depois.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do endpoint (`whe_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"200":{"description":"Endpoint excluído.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"},"example":{"id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","url":"https://example.com/wolf/webhooks","enabled":false,"status":"deleted","disabled_reason":null,"consecutive_failures":0,"selected_events":["payment.paid","payment.canceled"],"product_ids":[],"payment_methods":[],"delivery_mode":"live","secret_rotated_at":null,"deleted_at":"2026-11-06T12:10:00.000Z","created_at":"2026-11-06T12:00:00.000Z"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED"]}},"/v1/webhooks/endpoints/{id}/rotate-secret":{"post":{"operationId":"rotateWebhookEndpointSecret","tags":["Webhooks"],"summary":"Rotacionar signing secret","description":"Só endpoint `live` e só sessão humana do seller (API key → `403`). O segredo novo vale na hora e é exibido uma única vez; um replay devolve `secret_already_revealed: true`.","security":[{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do endpoint (`whe_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyRequest"},"example":{}}}},"responses":{"200":{"description":"Endpoint com o novo segredo (ou replay sem ele).","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RotatedWebhookEndpointSecret"},{"$ref":"#/components/schemas/ReplayedRotatedWebhookEndpointSecret"}]},"example":{"id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","url":"https://example.com/wolf/webhooks","enabled":true,"status":"active","disabled_reason":null,"consecutive_failures":0,"selected_events":["payment.paid","payment.canceled"],"product_ids":[],"payment_methods":[],"delivery_mode":"live","secret_rotated_at":"2026-11-06T12:05:00.000Z","deleted_at":null,"created_at":"2026-11-06T12:00:00.000Z","signing_secret":"whsec_live_EXEMPLO_novo_segredo"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `INVALID_STATE_TRANSITION`, `TENANT_SELECTION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro: `SERVICE_UNAVAILABLE`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","INVALID_STATE_TRANSITION","RATE_LIMITED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED"]}},"/v1/webhooks/endpoints/{id}/test":{"post":{"operationId":"testWebhookEndpoint","tags":["Webhooks"],"summary":"Enviar evento de teste","description":"Enfileira um evento `webhook.test` (uma tentativa, assinada como os eventos de domínio). Endpoint desativado → `409 WEBHOOK_ENDPOINT_DISABLED`.","security":[{"apiKey":[]},{"sellerSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do endpoint (`whe_...`).","schema":{"type":"string","minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyRequest"},"example":{}}}},"responses":{"202":{"description":"Entrega de teste criada.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"idempotent-replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"},"example":{"id":"whd_5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c","endpoint_id":"whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a","event_id":"evt_7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e","event_type":"webhook.test","attempt":1,"status":"pending","response_status":null,"latency_ms":null,"created_at":"2026-11-06T12:00:00.000Z"}}}},"400":{"description":"Erro: `IDEMPOTENCY_KEY_REQUIRED`, `VALIDATION_FAILED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro: `AUTHENTICATION_REQUIRED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro: `FORBIDDEN`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro: `RESOURCE_NOT_FOUND`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro: `IDEMPOTENCY_CONFLICT`, `IDEMPOTENCY_IN_PROGRESS`, `TENANT_SELECTION_REQUIRED`, `WEBHOOK_ENDPOINT_DISABLED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro: `RATE_LIMITED`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"},"retry-after":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro: `INTERNAL_ERROR`.","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-wolf-scopes":["webhooks:write"],"x-wolf-idempotency":"required","x-wolf-rate-limits":["api_authenticated"],"x-wolf-error-codes":["AUTHENTICATION_REQUIRED","FORBIDDEN","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_IN_PROGRESS","IDEMPOTENCY_KEY_REQUIRED","INTERNAL_ERROR","RATE_LIMITED","RESOURCE_NOT_FOUND","TENANT_SELECTION_REQUIRED","VALIDATION_FAILED","WEBHOOK_ENDPOINT_DISABLED"]}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"details":{}},"required":["code","message","request_id"]}},"required":["error"]},"PaymentNextAction":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"pix_qr"},"qr_code_payload":{"type":"string","minLength":1},"expires_at":{"type":"string"}},"required":["type","qr_code_payload","expires_at"]}]},"PayerView":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"document":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["cpf","cnpj"]},"last2":{"type":"string","pattern":"^[0-9]{2}$"}},"required":["type","last2"]},{"type":"null"}]}},"required":["name","email","phone","document"]},"PaymentIntent":{"type":"object","properties":{"id":{"type":"string","pattern":"^pi_.*"},"order_id":{"anyOf":[{"type":"string","pattern":"^ord_.*"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["requires_payment_method","requires_action","processing","succeeded","failed","canceled"]},"provider_id":{"type":"string"},"latest_provider_attempt_id":{"anyOf":[{"type":"string","pattern":"^pat_.*"},{"type":"null"}]},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_method_types":{"minItems":1,"type":"array","items":{"type":"string","enum":["card","pix"]}},"payment_method_type":{"anyOf":[{"type":"string","enum":["card","pix"]},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"payer":{"anyOf":[{"$ref":"#/components/schemas/PayerView"},{"type":"null"}]},"next_action":{"anyOf":[{"$ref":"#/components/schemas/PaymentNextAction"},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancellation_reason":{"anyOf":[{"type":"string","enum":["expired"]},{"type":"null"}]}},"required":["id","order_id","amount_minor","currency","status","provider_id","latest_provider_attempt_id","failure_code","payment_method_types","payment_method_type","description","metadata","payer","next_action","expires_at","cancellation_reason"]},"PaymentActivity":{"type":"object","properties":{"payment_intent":{"type":"object","properties":{"id":{"type":"string","pattern":"^pi_.*"},"order_id":{"anyOf":[{"type":"string","pattern":"^ord_.*"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["requires_payment_method","requires_action","processing","succeeded","failed","canceled"]},"provider_id":{"type":"string"},"latest_provider_attempt_id":{"anyOf":[{"type":"string","pattern":"^pat_.*"},{"type":"null"}]},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_method_types":{"minItems":1,"type":"array","items":{"type":"string","enum":["card","pix"]}},"payment_method_type":{"anyOf":[{"type":"string","enum":["card","pix"]},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"payer":{"anyOf":[{"$ref":"#/components/schemas/PayerView"},{"type":"null"}]},"next_action":{"anyOf":[{"$ref":"#/components/schemas/PaymentNextAction"},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancellation_reason":{"anyOf":[{"type":"string","enum":["expired"]},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","order_id","amount_minor","currency","status","provider_id","latest_provider_attempt_id","failure_code","payment_method_types","payment_method_type","description","metadata","payer","next_action","expires_at","cancellation_reason","created_at","updated_at"]},"attempts":{"maxItems":25,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^pat_.*"},"state":{"type":"string","enum":["created","submitted","succeeded","failed","unknown","reconciled_succeeded","reconciled_failed"]},"provider_id":{"type":"string"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_error_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","state","provider_id","external_id","canonical_error_code","created_at","updated_at"]}},"refunds":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^rfd_.*"},"payment_intent_id":{"type":"string","pattern":"^pi_.*"},"charge_id":{"type":"string","pattern":"^chg_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["created","processing","succeeded","failed","unknown"]},"provider_id":{"type":"string"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","payment_intent_id","charge_id","amount_minor","currency","status","provider_id","external_id","failure_code","created_at","updated_at"]}},"disputes":{"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/Dispute"}},"truncated":{"type":"object","properties":{"attempts":{"type":"boolean"},"refunds":{"type":"boolean"},"disputes":{"type":"boolean"}},"required":["attempts","refunds","disputes"]}},"required":["payment_intent","attempts","refunds","disputes","truncated"]},"Refund":{"type":"object","properties":{"id":{"type":"string","pattern":"^rfd_.*"},"payment_intent_id":{"type":"string","pattern":"^pi_.*"},"charge_id":{"type":"string","pattern":"^chg_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["created","processing","succeeded","failed","unknown"]},"provider_id":{"type":"string"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","payment_intent_id","charge_id","amount_minor","currency","status","provider_id","external_id","failure_code"]},"Dispute":{"type":"object","properties":{"id":{"type":"string","pattern":"^dsp_.*"},"payment_intent_id":{"type":"string","pattern":"^pi_.*"},"charge_id":{"type":"string","pattern":"^chg_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["created","won","lost"]},"reason_code":{"type":"string","enum":["fraudulent","product_not_received","not_as_described","duplicate","other"]},"provider_id":{"type":"string"},"external_id":{"type":"string"},"provider_status":{"type":"string"},"synthetic_obligation":{"type":"boolean","const":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","payment_intent_id","charge_id","amount_minor","currency","status","reason_code","provider_id","external_id","provider_status","synthetic_obligation","created_at","updated_at","resolved_at"]},"Payout":{"type":"object","properties":{"id":{"type":"string","pattern":"^pyo_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["created","paid","failed"]},"origin":{"type":"string","enum":["admin","seller"]},"provider_id":{"type":"string"},"provider_request_key":{"type":"string"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"destination_ref":{"type":"string","pattern":"^sim_[A-Za-z0-9_-]{3,120}$"},"provider_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"synthetic_obligation":{"type":"boolean","const":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","amount_minor","currency","status","origin","provider_id","provider_request_key","external_id","destination_ref","provider_status","synthetic_obligation","created_at","updated_at","resolved_at"]},"FinancePayout":{"type":"object","properties":{"id":{"type":"string","pattern":"^pyo_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["created","paid","failed"]},"origin":{"type":"string","enum":["admin","seller"]},"destination_ref":{"type":"string","pattern":"^sim_[A-Za-z0-9_-]{3,120}$"},"synthetic_obligation":{"type":"boolean","const":true},"created_at":{"type":"string"},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","amount_minor","currency","status","origin","destination_ref","synthetic_obligation","created_at","resolved_at"]},"FinancePayoutList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FinancePayout"}}},"required":["data"]},"Notification":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"kind":{"type":"string","enum":["pix_issued","payment_approved","payment_declined","refund_completed","payout_requested","payout_paid","payout_failed"]},"occurred_at":{"type":"string"},"amount_minor":{"type":"string","pattern":"^[0-9]+$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"resource_id":{"type":"string","minLength":1,"maxLength":128},"reference":{"type":"string","pattern":"^[A-Z0-9]{1,8}$"},"payment_method":{"anyOf":[{"type":"string","enum":["card","pix"]},{"type":"null"}]},"payout_origin":{"anyOf":[{"type":"string","enum":["admin","seller"]},{"type":"null"}]}},"required":["id","kind","occurred_at","amount_minor","currency","resource_id","reference","payment_method","payout_origin"]},"NotificationPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Notification"}},"next_cursor":{"type":"string","maxLength":512,"pattern":"^n1_[0-9a-f]+$"},"has_more":{"type":"boolean"}},"required":["data","next_cursor","has_more"]},"SettlementBatch":{"type":"object","properties":{"id":{"type":"string","pattern":"^stb_.*"},"provider_id":{"type":"string"},"external_id":{"type":"string"},"window_start":{"type":"string"},"window_end":{"type":"string"},"status":{"type":"string","enum":["created","processing","completed","requires_review"]},"origin":{"type":"string","enum":["admin","auto"]},"synthetic_obligation":{"type":"boolean","const":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"finalized_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^stl_.*"},"charge_id":{"type":"string","pattern":"^chg_.*"},"amount_minor":{"type":"string"},"fee_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["pending","available","mismatch"]},"available_minor":{"anyOf":[{"type":"string"},{"type":"null"}]},"reserve_minor":{"anyOf":[{"type":"string"},{"type":"null"}]},"reconciliation_case_id":{"anyOf":[{"type":"string","pattern":"^rcc_.*"},{"type":"null"}]}},"required":["id","charge_id","amount_minor","fee_minor","currency","status","available_minor","reserve_minor","reconciliation_case_id"]}}},"required":["id","provider_id","external_id","window_start","window_end","status","origin","synthetic_obligation","created_at","updated_at","finalized_at","lines"]},"Order":{"type":"object","properties":{"id":{"type":"string","pattern":"^ord_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"product_id":{"type":"string","pattern":"^prd_.*"},"checkout_session_id":{"anyOf":[{"type":"string","pattern":"^cs_.*"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["pending_payment","paid","canceled","expired"]},"paid_payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"paid_charge_id":{"anyOf":[{"type":"string","pattern":"^chg_.*"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"paid_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"canceled_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"expired_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^oi_.*"},"kind":{"type":"string","enum":["main","bump"]},"offer_id":{"type":"string","pattern":"^off_.*"},"product_id":{"type":"string","pattern":"^prd_.*"},"offer_bump_id":{"anyOf":[{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"position":{"type":"integer","minimum":0,"maximum":3}},"required":["id","kind","offer_id","product_id","offer_bump_id","amount_minor","currency","position"]}}},"required":["id","offer_id","product_id","checkout_session_id","amount_minor","currency","status","paid_payment_intent_id","paid_charge_id","created_at","updated_at","paid_at","canceled_at","expired_at","items"]},"OrderPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"next_cursor":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^o1_[0-9a-f]+$"},{"type":"null"}]}},"required":["data","next_cursor"]},"Product":{"type":"object","properties":{"id":{"type":"string","pattern":"^prd_.*"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"created_at":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string","enum":["negocios_empreendedorismo","marketing_vendas","financas_investimentos","saude_bem_estar","desenvolvimento_pessoal","educacao_concursos","idiomas","tecnologia_programacao","design_fotografia","culinaria_gastronomia","outros"]},{"type":"null"}]},"sales_page_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"guarantee_days":{"type":"integer","minimum":0,"maximum":30},"support_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"support_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"support_whatsapp":{"anyOf":[{"type":"string"},{"type":"null"}]},"statement_descriptor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","status","created_at","description","category","sales_page_url","guarantee_days","support_name","support_email","support_whatsapp","statement_descriptor"]},"ProductAccessLink":{"type":"object","properties":{"id":{"type":"string","pattern":"^pal_[A-Za-z0-9]{1,64}$"},"product_id":{"type":"string","pattern":"^prd_.*"},"label":{"type":"string"},"url":{"type":"string"},"host":{"type":"string"},"position":{"type":"integer","minimum":0,"maximum":9007199254740991},"created_at":{"type":"string"}},"required":["id","product_id","label","url","host","position","created_at"]},"ProductAccessLinkList":{"type":"object","properties":{"data":{"maxItems":5,"type":"array","items":{"$ref":"#/components/schemas/ProductAccessLink"}}},"required":["data"]},"ProductListItem":{"type":"object","properties":{"id":{"type":"string","pattern":"^prd_.*"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"created_at":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string","enum":["negocios_empreendedorismo","marketing_vendas","financas_investimentos","saude_bem_estar","desenvolvimento_pessoal","educacao_concursos","idiomas","tecnologia_programacao","design_fotografia","culinaria_gastronomia","outros"]},{"type":"null"}]},"sales_page_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"guarantee_days":{"type":"integer","minimum":0,"maximum":30},"support_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"support_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"support_whatsapp":{"anyOf":[{"type":"string"},{"type":"null"}]},"statement_descriptor":{"anyOf":[{"type":"string"},{"type":"null"}]},"offer_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"active_offer_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","name","status","created_at","description","category","sales_page_url","guarantee_days","support_name","support_email","support_whatsapp","statement_descriptor","offer_count","active_offer_count"]},"ProductPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductListItem"}},"next_cursor":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^c1_[0-9a-f]+$"},{"type":"null"}]}},"required":["data","next_cursor"]},"Offer":{"type":"object","properties":{"id":{"type":"string","pattern":"^off_.*"},"product_id":{"type":"string","pattern":"^prd_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["draft","active","archived"]},"created_at":{"type":"string"},"accepted_methods":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["pix","card"]}}},"required":["id","product_id","amount_minor","currency","status","created_at","accepted_methods"]},"OfferPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"next_cursor":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^c1_[0-9a-f]+$"},{"type":"null"}]}},"required":["data","next_cursor"]},"OfferBump":{"type":"object","properties":{"id":{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"},"offer_id":{"type":"string","pattern":"^off_.*"},"bump_offer_id":{"type":"string","pattern":"^off_.*"},"headline":{"type":"string"},"description":{"type":"string"},"position":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["active","inactive"]},"bump_offer":{"type":"object","properties":{"product_id":{"type":"string","pattern":"^prd_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["draft","active","archived"]}},"required":["product_id","amount_minor","currency","status"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","offer_id","bump_offer_id","headline","description","position","status","bump_offer","created_at","updated_at"]},"OfferBumpList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OfferBump"}}},"required":["data"]},"CheckoutSession":{"type":"object","properties":{"id":{"type":"string","pattern":"^cs_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["open","completed","expired"]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"expires_at":{"type":"string"}},"required":["id","offer_id","amount_minor","currency","status","payment_intent_id","expires_at"]},"CreatedCheckoutSession":{"type":"object","properties":{"id":{"type":"string","pattern":"^cs_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["open","completed","expired"]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"expires_at":{"type":"string"},"client_secret":{"type":"string","pattern":"^csec_.*"}},"required":["id","offer_id","amount_minor","currency","status","payment_intent_id","expires_at","client_secret"]},"ReplayedCheckoutSession":{"type":"object","properties":{"id":{"type":"string","pattern":"^cs_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["open","completed","expired"]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"expires_at":{"type":"string"},"secret_already_revealed":{"type":"boolean","const":true}},"required":["id","offer_id","amount_minor","currency","status","payment_intent_id","expires_at","secret_already_revealed"]},"CheckoutPayment":{"type":"object","properties":{"id":{"type":"string","pattern":"^pi_.*"},"order_id":{"anyOf":[{"type":"string","pattern":"^ord_.*"},{"type":"null"}]},"status":{"type":"string","enum":["requires_payment_method","requires_action","processing","succeeded","failed","canceled"]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_action":{"anyOf":[{"$ref":"#/components/schemas/PaymentNextAction"},{"type":"null"}]},"cancellation_reason":{"anyOf":[{"type":"string","enum":["expired"]},{"type":"null"}]}},"required":["id","order_id","status","amount_minor","currency","failure_code","next_action","cancellation_reason"]},"CapturedCheckoutLead":{"type":"object","properties":{"checkout_session_id":{"type":"string","pattern":"^cs_.*"},"captured":{"type":"boolean","const":true}},"required":["checkout_session_id","captured"]},"PublicCheckoutSession":{"type":"object","properties":{"id":{"type":"string","pattern":"^cs_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["open","completed","expired"]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"expires_at":{"type":"string"},"seller":{"type":"object","properties":{"display_name":{"type":"string","minLength":1}},"required":["display_name"]},"product":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","description"]},"support":{"anyOf":[{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"whatsapp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","email","whatsapp"]},{"type":"null"}]},"guarantee_days":{"type":"integer","minimum":0,"maximum":30},"accepted_methods":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["pix","card"]}},"access_links":{"anyOf":[{"maxItems":5,"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"},"host":{"type":"string"}},"required":["label","url","host"]}},{"type":"null"}]},"payment":{"anyOf":[{"$ref":"#/components/schemas/CheckoutPayment"},{"type":"null"}]},"bumps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"},"headline":{"type":"string"},"description":{"type":"string"},"product_name":{"type":"string"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["id","headline","description","product_name","amount_minor","currency"]}},"order":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^ord_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["main","bump"]},"bump_id":{"anyOf":[{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"},{"type":"null"}]},"product_name":{"type":"string"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["kind","bump_id","product_name","amount_minor","currency"]}}},"required":["id","amount_minor","currency","items"]},{"type":"null"}]},"selected_bump_ids":{"type":"array","items":{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"}}},"required":["id","offer_id","amount_minor","currency","status","payment_intent_id","expires_at","seller","product","support","guarantee_days","accepted_methods","access_links","payment","bumps","order","selected_bump_ids"]},"PaymentLink":{"type":"object","properties":{"id":{"type":"string","pattern":"^plk_[A-Za-z0-9]{1,64}$"},"offer_id":{"type":"string","pattern":"^off_.*"},"status":{"type":"string","enum":["active","inactive"]},"session_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"completed_session_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"last_session_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","offer_id","status","session_count","completed_session_count","last_session_at","created_at","updated_at"]},"PaymentLinkList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PaymentLink"}}},"required":["data"]},"OpenedPaymentLinkSession":{"type":"object","properties":{"checkout_session_id":{"type":"string","pattern":"^cs_.*"},"client_secret":{"type":"string","pattern":"^csec_.*"},"expires_at":{"type":"string"}},"required":["checkout_session_id","client_secret","expires_at"]},"WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string","pattern":"^whe_.*"},"url":{"type":"string","format":"uri"},"enabled":{"type":"boolean"},"status":{"type":"string","enum":["active","disabled","deleted"]},"disabled_reason":{"anyOf":[{"type":"string","enum":["manual","consecutive_failures"]},{"type":"null"}]},"consecutive_failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"selected_events":{"type":"array","items":{"type":"string"}},"product_ids":{"type":"array","items":{"type":"string","pattern":"^prd_.*"}},"payment_methods":{"type":"array","items":{"type":"string","enum":["card","pix"]}},"delivery_mode":{"type":"string","enum":["simulated","live"]},"secret_rotated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","url","enabled","status","disabled_reason","consecutive_failures","selected_events","product_ids","payment_methods","delivery_mode","secret_rotated_at","deleted_at","created_at"]},"CreatedLiveWebhookEndpoint":{"type":"object","properties":{"id":{"type":"string","pattern":"^whe_.*"},"url":{"type":"string","format":"uri"},"enabled":{"type":"boolean"},"status":{"type":"string","enum":["active","disabled","deleted"]},"disabled_reason":{"anyOf":[{"type":"string","enum":["manual","consecutive_failures"]},{"type":"null"}]},"consecutive_failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"selected_events":{"type":"array","items":{"type":"string"}},"product_ids":{"type":"array","items":{"type":"string","pattern":"^prd_.*"}},"payment_methods":{"type":"array","items":{"type":"string","enum":["card","pix"]}},"delivery_mode":{"type":"string","enum":["simulated","live"]},"secret_rotated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"signing_secret":{"type":"string","pattern":"^whsec_live_[A-Za-z0-9_-]+$"}},"required":["id","url","enabled","status","disabled_reason","consecutive_failures","selected_events","product_ids","payment_methods","delivery_mode","secret_rotated_at","deleted_at","created_at","signing_secret"]},"ReplayedLiveWebhookEndpoint":{"type":"object","properties":{"id":{"type":"string","pattern":"^whe_.*"},"url":{"type":"string","format":"uri"},"enabled":{"type":"boolean"},"status":{"type":"string","enum":["active","disabled","deleted"]},"disabled_reason":{"anyOf":[{"type":"string","enum":["manual","consecutive_failures"]},{"type":"null"}]},"consecutive_failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"selected_events":{"type":"array","items":{"type":"string"}},"product_ids":{"type":"array","items":{"type":"string","pattern":"^prd_.*"}},"payment_methods":{"type":"array","items":{"type":"string","enum":["card","pix"]}},"delivery_mode":{"type":"string","const":"live"},"secret_rotated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"secret_already_revealed":{"type":"boolean","const":true}},"required":["id","url","enabled","status","disabled_reason","consecutive_failures","selected_events","product_ids","payment_methods","delivery_mode","secret_rotated_at","deleted_at","created_at","secret_already_revealed"]},"RotatedWebhookEndpointSecret":{"type":"object","properties":{"id":{"type":"string","pattern":"^whe_.*"},"url":{"type":"string","format":"uri"},"enabled":{"type":"boolean"},"status":{"type":"string","enum":["active","disabled","deleted"]},"disabled_reason":{"anyOf":[{"type":"string","enum":["manual","consecutive_failures"]},{"type":"null"}]},"consecutive_failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"selected_events":{"type":"array","items":{"type":"string"}},"product_ids":{"type":"array","items":{"type":"string","pattern":"^prd_.*"}},"payment_methods":{"type":"array","items":{"type":"string","enum":["card","pix"]}},"delivery_mode":{"type":"string","const":"live"},"secret_rotated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"signing_secret":{"type":"string","pattern":"^whsec_live_[A-Za-z0-9_-]+$"}},"required":["id","url","enabled","status","disabled_reason","consecutive_failures","selected_events","product_ids","payment_methods","delivery_mode","secret_rotated_at","deleted_at","created_at","signing_secret"]},"ReplayedRotatedWebhookEndpointSecret":{"type":"object","properties":{"id":{"type":"string","pattern":"^whe_.*"},"url":{"type":"string","format":"uri"},"enabled":{"type":"boolean"},"status":{"type":"string","enum":["active","disabled","deleted"]},"disabled_reason":{"anyOf":[{"type":"string","enum":["manual","consecutive_failures"]},{"type":"null"}]},"consecutive_failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"selected_events":{"type":"array","items":{"type":"string"}},"product_ids":{"type":"array","items":{"type":"string","pattern":"^prd_.*"}},"payment_methods":{"type":"array","items":{"type":"string","enum":["card","pix"]}},"delivery_mode":{"type":"string","const":"live"},"secret_rotated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"secret_already_revealed":{"type":"boolean","const":true}},"required":["id","url","enabled","status","disabled_reason","consecutive_failures","selected_events","product_ids","payment_methods","delivery_mode","secret_rotated_at","deleted_at","created_at","secret_already_revealed"]},"WebhookDelivery":{"type":"object","properties":{"id":{"type":"string","pattern":"^whd_.*"},"endpoint_id":{"type":"string","pattern":"^whe_.*"},"event_id":{"type":"string","pattern":"^evt_.*"},"event_type":{"type":"string"},"attempt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","delivering","succeeded","failed","dead_letter"]},"response_status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"latency_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","endpoint_id","event_id","event_type","attempt","status","response_status","latency_ms","created_at"]},"ApiCredential":{"type":"object","properties":{"id":{"type":"string","pattern":"^key_.*"},"name":{"type":"string"},"key_prefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["payments:read","payments:write","refunds:write","products:read","products:write","offers:read","offers:write","orders:read","orders:write","reports:read","finance:read","webhooks:write","api-keys:write","checkout.exports:create","checkout.exports:read"]}},"status":{"type":"string","enum":["active","revoked","expired"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","key_prefix","scopes","status","expires_at","last_used_at","created_at","revoked_at"]},"CreatedApiCredential":{"type":"object","properties":{"credential":{"$ref":"#/components/schemas/ApiCredential"},"secret":{"type":"string","pattern":"^sk_(test|live)_[A-Za-z0-9_-]+$"}},"required":["credential","secret"]},"ReplayedApiCredential":{"type":"object","properties":{"credential":{"$ref":"#/components/schemas/ApiCredential"},"secret_already_revealed":{"type":"boolean","const":true}},"required":["credential","secret_already_revealed"]},"Organization":{"type":"object","properties":{"id":{"type":"string","pattern":"^org_.*"},"seller_id":{"type":"string","pattern":"^sel_.*"},"legal_name":{"type":"string"},"display_name":{"type":"string"},"status":{"type":"string"},"role":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"timezone":{"type":"string","enum":["America/Sao_Paulo","America/Araguaina","America/Bahia","America/Belem","America/Boa_Vista","America/Campo_Grande","America/Cuiaba","America/Eirunepe","America/Fortaleza","America/Maceio","America/Manaus","America/Noronha","America/Porto_Velho","America/Recife","America/Rio_Branco","America/Santarem","UTC"]}},"required":["id","seller_id","legal_name","display_name","status","role","capabilities","timezone"]},"OrganizationClosureRequest":{"type":"object","properties":{"id":{"type":"string","pattern":"^ocr_.*"},"organization_id":{"type":"string","pattern":"^org_.*"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_at":{"type":"string"}},"required":["id","organization_id","reason","requested_at"]},"Dashboard":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"total_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"succeeded_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"processing_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"gross_volume_minor":{"type":"string"},"recent_payments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"created_at":{"type":"string"}},"required":["id","status","amount_minor","currency","created_at"]}}},"required":["currency","total_payments","succeeded_payments","failed_payments","processing_payments","gross_volume_minor","recent_payments"]},"DashboardPeriod":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"timezone":{"type":"string","const":"UTC"},"generated_at":{"type":"string"},"initiated_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"succeeded_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"processing_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"canceled_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"gross_volume_minor":{"type":"string","pattern":"^[0-9]+$"},"succeeded_refunds":{"type":"integer","minimum":0,"maximum":9007199254740991},"refunded_volume_minor":{"type":"string","pattern":"^[0-9]+$"},"recent_payments":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^pi_.*"},"status":{"type":"string","enum":["requires_payment_method","requires_action","processing","succeeded","failed","canceled"]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"created_at":{"type":"string"}},"required":["id","status","amount_minor","currency","created_at"]}}},"required":["currency","from","to","timezone","generated_at","initiated_payments","succeeded_payments","failed_payments","processing_payments","canceled_payments","gross_volume_minor","succeeded_refunds","refunded_volume_minor","recent_payments"]},"AbandonedCheckout":{"type":"object","properties":{"id":{"type":"string","pattern":"^lead_[A-Za-z0-9]{1,64}$"},"checkout_session_id":{"type":"string","pattern":"^cs_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"product_id":{"type":"string","pattern":"^prd_.*"},"product_name":{"type":"string"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"customer":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"type":"string","enum":["full","masked"]}},"required":["name","email","phone","visibility"]},"captured_at":{"type":"string"},"reason":{"type":"string","enum":["expired","inactive"]}},"required":["id","checkout_session_id","offer_id","product_id","product_name","amount_minor","currency","customer","captured_at","reason"]},"AbandonedCheckoutPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AbandonedCheckout"}},"next_cursor":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^a1_[0-9a-f]+$"},{"type":"null"}]},"timezone":{"type":"string"}},"required":["data","next_cursor","timezone"]},"CreatedCheckoutRecoveryLink":{"type":"object","properties":{"id":{"type":"string","pattern":"^cs_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["open","completed","expired"]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"expires_at":{"type":"string"},"client_secret":{"type":"string","pattern":"^csec_.*"},"lead_id":{"type":"string","pattern":"^lead_[A-Za-z0-9]{1,64}$"}},"required":["id","offer_id","amount_minor","currency","status","payment_intent_id","expires_at","client_secret","lead_id"]},"ReplayedCheckoutRecoveryLink":{"type":"object","properties":{"id":{"type":"string","pattern":"^cs_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["open","completed","expired"]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"expires_at":{"type":"string"},"secret_already_revealed":{"type":"boolean","const":true},"lead_id":{"type":"string","pattern":"^lead_[A-Za-z0-9]{1,64}$"}},"required":["id","offer_id","amount_minor","currency","status","payment_intent_id","expires_at","secret_already_revealed","lead_id"]},"FinanceSnapshot":{"type":"object","properties":{"balances":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"balance_minor":{"type":"string"}},"required":["code","currency","balance_minor"]}},"journals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^jrn_.*"},"source_type":{"type":"string"},"source_id":{"type":"string"},"operation_key":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"debit_minor":{"type":"string"},"credit_minor":{"type":"string"},"created_at":{"type":"string"}},"required":["id","source_type","source_id","operation_key","currency","debit_minor","credit_minor","created_at"]}}},"required":["balances","journals"]},"SellerDashboard":{"type":"object","properties":{"period":{"type":"string","enum":["today","7d","30d"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"timezone":{"type":"string","enum":["America/Sao_Paulo","America/Araguaina","America/Bahia","America/Belem","America/Boa_Vista","America/Campo_Grande","America/Cuiaba","America/Eirunepe","America/Fortaleza","America/Maceio","America/Manaus","America/Noronha","America/Porto_Velho","America/Recife","America/Rio_Branco","America/Santarem","UTC"]},"from":{"type":"string"},"to":{"type":"string"},"previous_from":{"type":"string"},"previous_to":{"type":"string"},"generated_at":{"type":"string"},"kpis":{"type":"object","properties":{"gross":{"type":"object","properties":{"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"previous":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"delta":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"}},"required":["value","previous","delta"]},"paid":{"type":"object","properties":{"value":{"type":"integer","minimum":0,"maximum":9007199254740991},"previous":{"type":"integer","minimum":0,"maximum":9007199254740991},"delta":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["value","previous","delta"]},"pix_conversion":{"type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"previous":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"delta":{"anyOf":[{"type":"integer","minimum":-10000,"maximum":10000},{"type":"null"}]},"numerator":{"type":"integer","minimum":0,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":0,"maximum":9007199254740991},"previous_numerator":{"type":"integer","minimum":0,"maximum":9007199254740991},"previous_denominator":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["value","previous","delta","numerator","denominator","previous_numerator","previous_denominator"]},"card_approval":{"type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"previous":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"delta":{"anyOf":[{"type":"integer","minimum":-10000,"maximum":10000},{"type":"null"}]},"numerator":{"type":"integer","minimum":0,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":0,"maximum":9007199254740991},"previous_numerator":{"type":"integer","minimum":0,"maximum":9007199254740991},"previous_denominator":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["value","previous","delta","numerator","denominator","previous_numerator","previous_denominator"]}},"required":["gross","paid","pix_conversion","card_approval"]},"series":{"type":"object","properties":{"granularity":{"type":"string","enum":["hour","day"]},"buckets":{"maxItems":31,"type":"array","items":{"type":"object","properties":{"start":{"type":"string"},"label":{"type":"string"},"gross_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"pix_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"card_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"paid_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["start","label","gross_minor","pix_minor","card_minor","paid_count"]}}},"required":["granularity","buckets"]},"methods":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["card","pix"]},"paid_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"gross_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["method","paid_count","gross_minor"]}},"pix":{"type":"object","properties":{"emitted_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"paid_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"pending_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"expired_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"emitted_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"paid_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["emitted_count","paid_count","pending_count","expired_count","emitted_minor","paid_minor"]},"balances":{"type":"object","properties":{"available_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"pending_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"reserved_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"dispute_hold_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"payout_pending_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"paid_out_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["available_minor","pending_minor","reserved_minor","dispute_hold_minor","payout_pending_minor","paid_out_minor"]},"waterfall":{"type":"object","properties":{"gross_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"refunds_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"disputes_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"fees_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"net_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"fees_settled_payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"succeeded_payments":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["gross_minor","refunds_minor","disputes_minor","fees_minor","net_minor","fees_settled_payments","succeeded_payments"]},"rhythm":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"ok"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"current_hour":{"type":"integer","minimum":0,"maximum":23},"today":{"minItems":24,"maxItems":24,"type":"array","items":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]}},"baseline":{"minItems":24,"maxItems":24,"type":"array","items":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"today_so_far_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"baseline_so_far_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"baseline_day_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"projection_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["status","date","current_hour","today","baseline","today_so_far_minor","baseline_so_far_minor","baseline_day_minor","projection_minor"]},{"type":"object","properties":{"status":{"type":"string","const":"insufficient_history"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"current_hour":{"type":"integer","minimum":0,"maximum":23},"reason":{"type":"string","enum":["history_shorter_than_4_weeks","no_baseline_so_far"]}},"required":["status","date","current_hour","reason"]}]},"recent_sales":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"payment_intent_id":{"type":"string","pattern":"^pi_.*"},"order_id":{"anyOf":[{"type":"string","pattern":"^ord_.*"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["requires_payment_method","requires_action","processing","succeeded","failed","canceled"]},"display_status":{"type":"string","enum":["pending","processing","paid","declined","refunded","partially_refunded","canceled","expired","disputed","chargeback","failed"]},"payment_method":{"anyOf":[{"type":"string","enum":["card","pix"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["payment_intent_id","order_id","amount_minor","currency","status","display_status","payment_method","created_at"]}}},"required":["period","currency","timezone","from","to","previous_from","previous_to","generated_at","kpis","series","methods","pix","balances","waterfall","rhythm","recent_sales"]},"SellerOrderItem":{"type":"object","properties":{"id":{"type":"string","pattern":"^oi_.*"},"kind":{"type":"string","enum":["main","bump"]},"offer_id":{"type":"string","pattern":"^off_.*"},"product_id":{"type":"string","pattern":"^prd_.*"},"offer_bump_id":{"anyOf":[{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"position":{"type":"integer","minimum":0,"maximum":3},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","kind","offer_id","product_id","offer_bump_id","amount_minor","currency","position","product_name"]},"SellerOrder":{"type":"object","properties":{"id":{"type":"string","pattern":"^ord_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"product_id":{"type":"string","pattern":"^prd_.*"},"checkout_session_id":{"anyOf":[{"type":"string","pattern":"^cs_.*"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["pending_payment","paid","canceled","expired"]},"paid_payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"paid_charge_id":{"anyOf":[{"type":"string","pattern":"^chg_.*"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"paid_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"canceled_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"expired_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"$ref":"#/components/schemas/SellerOrderItem"}},"product_name":{"type":"string"},"offer_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"payment_method":{"anyOf":[{"type":"string","enum":["card","pix"]},{"type":"null"}]},"buyer":{"anyOf":[{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","email","phone"]},{"type":"null"}]},"display_status":{"type":"string","enum":["pending","processing","paid","declined","refunded","partially_refunded","canceled","expired","disputed","chargeback","failed"]},"refunded_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["id","offer_id","product_id","checkout_session_id","amount_minor","currency","status","paid_payment_intent_id","paid_charge_id","created_at","updated_at","paid_at","canceled_at","expired_at","items","product_name","offer_name","payment_intent_id","payment_method","buyer","display_status","refunded_minor"]},"SellerOrderPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SellerOrder"}},"next_cursor":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^o1_[0-9a-f]+$"},{"type":"null"}]},"counts":{"type":"object","properties":{"all":{"type":"integer","minimum":0,"maximum":9007199254740991},"pending":{"type":"integer","minimum":0,"maximum":9007199254740991},"processing":{"type":"integer","minimum":0,"maximum":9007199254740991},"paid":{"type":"integer","minimum":0,"maximum":9007199254740991},"declined":{"type":"integer","minimum":0,"maximum":9007199254740991},"refunded":{"type":"integer","minimum":0,"maximum":9007199254740991},"partially_refunded":{"type":"integer","minimum":0,"maximum":9007199254740991},"canceled":{"type":"integer","minimum":0,"maximum":9007199254740991},"expired":{"type":"integer","minimum":0,"maximum":9007199254740991},"disputed":{"type":"integer","minimum":0,"maximum":9007199254740991},"chargeback":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["all","pending","processing","paid","declined","refunded","partially_refunded","canceled","expired","disputed","chargeback","failed"]}},"required":["data","next_cursor","counts"]},"SellerOrderDetail":{"type":"object","properties":{"id":{"type":"string","pattern":"^ord_.*"},"offer_id":{"type":"string","pattern":"^off_.*"},"product_id":{"type":"string","pattern":"^prd_.*"},"checkout_session_id":{"anyOf":[{"type":"string","pattern":"^cs_.*"},{"type":"null"}]},"amount_minor":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"status":{"type":"string","enum":["pending_payment","paid","canceled","expired"]},"paid_payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"paid_charge_id":{"anyOf":[{"type":"string","pattern":"^chg_.*"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"paid_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"canceled_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"expired_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"$ref":"#/components/schemas/SellerOrderItem"}},"product_name":{"type":"string"},"offer_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"payment_method":{"anyOf":[{"type":"string","enum":["card","pix"]},{"type":"null"}]},"buyer":{"anyOf":[{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","email","phone"]},{"type":"null"}]},"display_status":{"type":"string","enum":["pending","processing","paid","declined","refunded","partially_refunded","canceled","expired","disputed","chargeback","failed"]},"refunded_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"buyer_details":{"anyOf":[{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","email","phone"]},{"type":"null"}]}},"required":["id","offer_id","product_id","checkout_session_id","amount_minor","currency","status","paid_payment_intent_id","paid_charge_id","created_at","updated_at","paid_at","canceled_at","expired_at","items","product_name","offer_name","payment_intent_id","payment_method","buyer","display_status","refunded_minor","buyer_details"]},"SellerProductListItem":{"type":"object","properties":{"id":{"type":"string","pattern":"^prd_.*"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"created_at":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string","enum":["negocios_empreendedorismo","marketing_vendas","financas_investimentos","saude_bem_estar","desenvolvimento_pessoal","educacao_concursos","idiomas","tecnologia_programacao","design_fotografia","culinaria_gastronomia","outros"]},{"type":"null"}]},"sales_page_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"guarantee_days":{"type":"integer","minimum":0,"maximum":30},"support_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"support_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"support_whatsapp":{"anyOf":[{"type":"string"},{"type":"null"}]},"statement_descriptor":{"anyOf":[{"type":"string"},{"type":"null"}]},"offer_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"active_offer_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"offers_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"links_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"bumps_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"revenue_30d_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["id","name","status","created_at","description","category","sales_page_url","guarantee_days","support_name","support_email","support_whatsapp","statement_descriptor","offer_count","active_offer_count","offers_count","links_count","bumps_count","revenue_30d_minor"]},"SellerProductPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SellerProductListItem"}},"next_cursor":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^c1_[0-9a-f]+$"},{"type":"null"}]}},"required":["data","next_cursor"]},"FinanceStatement":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"account":{"type":"string","const":"seller_available"},"balance_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^pst_.*"},"journal_id":{"type":"string","pattern":"^jrn_.*"},"source_type":{"type":"string"},"source_id":{"type":"string"},"payment_intent_id":{"anyOf":[{"type":"string","pattern":"^pi_.*"},{"type":"null"}]},"amount_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"balance_after_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"created_at":{"type":"string"}},"required":["id","journal_id","source_type","source_id","payment_intent_id","amount_minor","balance_after_minor","created_at"]}},"next_cursor":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^s1_[0-9a-f]+$"},{"type":"null"}]}},"required":["currency","account","balance_minor","data","next_cursor"]},"FinanceFees":{"type":"object","properties":{"overrides":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","enum":["global","seller","product","offer"]},"scope_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_id":{"type":"string"},"fee_basis_points":{"type":"integer","minimum":0,"maximum":10000},"reserve_basis_points":{"type":"integer","minimum":0,"maximum":10000},"max_installments":{"type":"integer","minimum":1,"maximum":24},"version":{"type":"string"}},"required":["scope","scope_id","provider_id","fee_basis_points","reserve_basis_points","max_installments","version"]}}},"required":["default","overrides"]},"FinanceForecast":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"pending_minor":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$"},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"amount_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"gross_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"fee_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"reserve_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"methods":{"type":"array","items":{"type":"object","properties":{"payment_method_type":{"type":"string","enum":["card","pix"]},"amount_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"gross_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"payments":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["payment_method_type","amount_minor","gross_minor","payments"]}}},"required":["date","amount_minor","methods"]}},"reason":{"anyOf":[{"type":"string","enum":["no_canonical_settlement_schedule"]},{"type":"null"}]},"terms":{"type":"array","items":{"type":"object","properties":{"payment_method_type":{"type":"string","enum":["card","pix"]},"days":{"type":"integer","minimum":0,"maximum":60},"source":{"type":"string","enum":["platform_default","seller_override"]}},"required":["payment_method_type","days","source"]}},"held":{"type":"object","properties":{"gross_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"payments":{"type":"integer","minimum":0,"maximum":9007199254740991},"reasons":{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string","enum":["dispute_open","refund_in_progress","settlement_in_progress","settlement_mismatch","seller_under_review","seller_suspended"]},"gross_minor":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"payments":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["reason","gross_minor","payments"]}}},"required":["gross_minor","payments","reasons"]}},"required":["currency","pending_minor","data","reason","terms","held"]},"PayerInput":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":160},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string","minLength":8,"maxLength":32,"pattern":"^[0-9()+\\-.\\s]+$"},"document":{"type":"object","properties":{"type":{"type":"string","enum":["cpf","cnpj"]},"number":{"type":"string","minLength":11,"maxLength":18,"pattern":"^[0-9A-Za-z./ -]+$"}},"required":["type","number"],"additionalProperties":false}},"required":["name","email"],"additionalProperties":false},"PaymentMethod":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"card"},"test_card":{"type":"string","enum":["approved","declined_insufficient_funds","declined_generic","unavailable_then_approved","unavailable_then_declined"]}},"required":["type","test_card"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"pix"}},"required":["type"],"additionalProperties":false}]},"CreatePaymentIntentRequest":{"type":"object","properties":{"amount_minor":{"type":"string","pattern":"^[1-9][0-9]*$"},"currency":{"default":"BRL","type":"string","pattern":"^[A-Z]{3}$"},"payment_method_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["card","pix"]}},"payer":{"$ref":"#/components/schemas/PayerInput"},"description":{"type":"string","minLength":1,"maxLength":500},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500}}},"required":["amount_minor"]},"ConfirmPaymentIntentRequest":{"type":"object","properties":{"payment_method":{"$ref":"#/components/schemas/PaymentMethod"}},"required":["payment_method"],"additionalProperties":false},"CreateRefundRequest":{"type":"object","properties":{"amount_minor":{"type":"string","pattern":"^[1-9][0-9]*$"}},"required":["amount_minor"]},"CreateSellerPayoutRequest":{"type":"object","properties":{"amount_minor":{"type":"string","pattern":"^[1-9][0-9]*$"},"currency":{"default":"BRL","type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount_minor"],"additionalProperties":false},"CreateOrderRequest":{"type":"object","properties":{"offer_id":{"type":"string","pattern":"^off_.*"},"checkout_session_id":{"anyOf":[{"type":"string","pattern":"^cs_.*"},{"type":"null"}]},"bump_ids":{"maxItems":3,"type":"array","items":{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"}}},"required":["offer_id"]},"CreateProductRequest":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":160}},"required":["name"]},"UpdateProductRequest":{"type":"object","properties":{"description":{"anyOf":[{"type":"string","minLength":1,"maxLength":2000},{"type":"null"}]},"category":{"anyOf":[{"type":"string","enum":["negocios_empreendedorismo","marketing_vendas","financas_investimentos","saude_bem_estar","desenvolvimento_pessoal","educacao_concursos","idiomas","tecnologia_programacao","design_fotografia","culinaria_gastronomia","outros"]},{"type":"null"}]},"sales_page_url":{"anyOf":[{"type":"string","minLength":9,"maxLength":2048},{"type":"null"}]},"guarantee_days":{"type":"integer","minimum":0,"maximum":30},"support_name":{"anyOf":[{"type":"string","minLength":2,"maxLength":80},{"type":"null"}]},"support_email":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"support_whatsapp":{"anyOf":[{"type":"string","pattern":"^\\+[1-9][0-9]{7,14}$"},{"type":"null"}]},"statement_descriptor":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9]([A-Za-z0-9 ]{0,11}[A-Za-z0-9])?$"},{"type":"null"}]}},"additionalProperties":false},"CreateProductAccessLinkRequest":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":80},"url":{"type":"string","minLength":9,"maxLength":2048}},"required":["label","url"],"additionalProperties":false},"CreateOfferRequest":{"type":"object","properties":{"product_id":{"type":"string","pattern":"^prd_.*"},"amount_minor":{"type":"string","pattern":"^[1-9][0-9]*$"},"currency":{"default":"BRL","type":"string","pattern":"^[A-Z]{3}$"}},"required":["product_id","amount_minor"]},"UpdateOfferRequest":{"type":"object","properties":{"accepted_methods":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["pix","card"]}}},"required":["accepted_methods"],"additionalProperties":false},"CreateOfferBumpRequest":{"type":"object","properties":{"bump_offer_id":{"type":"string","maxLength":128,"pattern":"^off_[A-Za-z0-9]+$"},"headline":{"type":"string","minLength":1,"maxLength":80},"description":{"type":"string","maxLength":280},"position":{"type":"integer","minimum":0,"maximum":99},"status":{"type":"string","enum":["active","inactive"]}},"required":["bump_offer_id","headline"],"additionalProperties":false},"UpdateOfferBumpRequest":{"type":"object","properties":{"headline":{"type":"string","minLength":1,"maxLength":80},"description":{"type":"string","maxLength":280},"position":{"type":"integer","minimum":0,"maximum":99},"status":{"type":"string","enum":["active","inactive"]}},"additionalProperties":false},"CatalogStatusRequest":{"type":"object","properties":{"status":{"type":"string","enum":["draft","active","archived"]}},"required":["status"]},"CreateCheckoutSessionRequest":{"type":"object","properties":{"offer_id":{"type":"string","pattern":"^off_.*"},"ttl_minutes":{"type":"integer","minimum":5,"maximum":1440}},"required":["offer_id"]},"PayCheckoutSessionRequest":{"type":"object","properties":{"client_secret":{"type":"string","pattern":"^csec_.*"},"payer":{"$ref":"#/components/schemas/PayerInput"},"payment_method":{"$ref":"#/components/schemas/PaymentMethod"},"bump_ids":{"maxItems":3,"type":"array","items":{"type":"string","pattern":"^ob_[A-Za-z0-9]{1,64}$"}}},"required":["client_secret","payer","payment_method"],"additionalProperties":false},"CheckoutSessionSecretRequest":{"type":"object","properties":{"client_secret":{"type":"string","pattern":"^csec_.*"}},"required":["client_secret"]},"CaptureCheckoutLeadRequest":{"type":"object","properties":{"client_secret":{"type":"string","pattern":"^csec_.*"},"name":{"type":"string","minLength":2,"maxLength":160},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string","minLength":8,"maxLength":32,"pattern":"^[0-9()+\\-.\\s]+$"}},"required":["client_secret","name","email"],"additionalProperties":false},"CreatePaymentLinkRequest":{"type":"object","properties":{"offer_id":{"type":"string","maxLength":128,"pattern":"^off_[A-Za-z0-9]+$"}},"required":["offer_id"],"additionalProperties":false},"PaymentLinkStatusRequest":{"type":"object","properties":{"status":{"type":"string","enum":["active","inactive"]}},"required":["status"],"additionalProperties":false},"CreateWebhookEndpointRequest":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"selected_events":{"default":[],"maxItems":100,"type":"array","items":{"type":"string"}},"delivery_mode":{"default":"simulated","type":"string","enum":["simulated","live"]}},"required":["url"],"additionalProperties":false},"UpdateWebhookEndpointRequest":{"type":"object","properties":{"status":{"type":"string","enum":["active","disabled"]},"product_ids":{"maxItems":50,"type":"array","items":{"type":"string","pattern":"^prd_[A-Za-z0-9]{1,64}$"}},"payment_methods":{"maxItems":2,"type":"array","items":{"type":"string","enum":["card","pix"]}}},"additionalProperties":false},"EmptyRequest":{"type":"object","properties":{},"additionalProperties":false},"CreateApiCredentialRequest":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":80},"scopes":{"minItems":1,"type":"array","items":{"type":"string","enum":["payments:read","payments:write","refunds:write","products:read","products:write","offers:read","offers:write","orders:read","orders:write","reports:read","finance:read","webhooks:write","api-keys:write","checkout.exports:create","checkout.exports:read"]}},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["name","scopes"]},"CreateOrganizationRequest":{"type":"object","properties":{"legal_name":{"type":"string","minLength":2,"maxLength":160},"display_name":{"type":"string","minLength":2,"maxLength":80}},"required":["legal_name"]},"CreateOrganizationClosureRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false},"UpdateCurrentOrganizationRequest":{"type":"object","properties":{"timezone":{"type":"string","enum":["America/Sao_Paulo","America/Araguaina","America/Bahia","America/Belem","America/Boa_Vista","America/Campo_Grande","America/Cuiaba","America/Eirunepe","America/Fortaleza","America/Maceio","America/Manaus","America/Noronha","America/Porto_Velho","America/Recife","America/Rio_Branco","America/Santarem","UTC"]}},"required":["timezone"],"additionalProperties":false}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk_test_...","description":"API key secreta do seller (`sk_test_...`), criada no app do seller. Nesta edição só existem chaves de teste."},"sellerSession":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Token de sessão do app do seller (Supabase Auth). Rotas de API keys, rotação de segredo de webhook e organizações exigem sessão humana."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave escolhida pelo cliente (8 a 255 caracteres). Mesma chave + mesmo corpo = mesma resposta; corpo diferente = `409 IDEMPOTENCY_CONFLICT`. Guardada por 24 h.","schema":{"type":"string","minLength":8,"maxLength":255}},"OrganizationId":{"name":"wolf-organization-id","in":"header","required":false,"description":"Só para sessão do app do seller com mais de uma organização (senão `409 TENANT_SELECTION_REQUIRED`). Ignorado para API keys.","schema":{"type":"string","pattern":"^org_"}}},"headers":{"RequestId":{"description":"Identificador da requisição (informe ao suporte).","schema":{"type":"string"}},"IdempotentReplayed":{"description":"`true` quando a resposta é a reprodução de uma requisição anterior com a mesma `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"RetryAfter":{"description":"Segundos até a janela do rate limit reabrir.","schema":{"type":"integer","minimum":1}}}}}