Foundations
Tudo que é compartilhado entre Checkout, Stone Online, Físico/TEF e Conta Stone.
Tudo que é compartilhado entre Checkout Stone, Stone Online (Pagar.me), Físico/TEF e Conta Stone (Banking) vive aqui. Sem enrolação: leia esta seção antes de mergulhar em qualquer produto e você economiza horas.
Por que "Foundations"?
A API Unificada Stone significa que um mesmo conjunto de credenciais, webhooks, formato de erro e padrão de idempotência funciona para todos os produtos. Você não aprende quatro autenticações diferentes — aprende uma e usa em tudo.
O que você encontra aqui
AutenticaçãoOAuth2 client-credentials, API Keys e mTLS para Conta Stone.
:::card{ to: "/foundations-environments" border: "1px solid var(--kui-color-border-neutral)" border-radius: "12px" padding: "20px" } Ambientes
Sandbox vs produção, URLs base, dados de teste. :::
:::card{ to: "/foundations-webhooks" border: "1px solid var(--kui-color-border-neutral)" border-radius: "12px" padding: "20px" } Webhooks
Assinatura HMAC, retry, idempotência de entrega. :::
:::card{ to: "/foundations-idempotency" border: "1px solid var(--kui-color-border-neutral)" border-radius: "12px" padding: "20px" } Idempotência
`Idempotency-Key` em todas as escritas. :::
:::card{ to: "/foundations-pagination" border: "1px solid var(--kui-color-border-neutral)" border-radius: "12px" padding: "20px" } Paginação
Cursor-based, padrão único em todas as APIs. :::
:::card{ to: "/foundations-errors" border: "1px solid var(--kui-color-border-neutral)" border-radius: "12px" padding: "20px" } Tratamento de erros
Problem Details (RFC 7807) em todas as APIs. :::
:::card{ to: "/foundations-sdks" border: "1px solid var(--kui-color-border-neutral)" border-radius: "12px" padding: "20px" } SDKs
Node, Python, PHP, Java, Go, .NET, Android. :::
Dica
Se você só lê uma página inteira, leia Autenticação. É a única que muda muito pouco mas onde a maioria dos erros de integração acontece.