---
title: "Foundations"
url: "https://devcenter.stone.com.br/foundations-overview"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Foundations,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9mb3VuZGF0aW9ucy1vdmVydmlldyI,s_plW6Qo8nFMvfN--z.png"
---

## **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"?](#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](#o-que-você-encontra-aqui)

[**Autenticação**OAuth2 client-credentials, API Keys e mTLS para Conta Stone.](https://devcenter.stone.com.br/foundations-auth)

:::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](https://devcenter.stone.com.br/foundations-auth). É a única que muda _muito pouco_ mas onde a maioria dos erros de integração acontece.

## [Veja também](#veja-também)

[**Autenticação**OAuth2, API Key e mTLS — três modos, mesmas credenciais.](https://devcenter.stone.com.br/foundations-auth)[**Ambientes**Sandbox vs produção, dados de teste, migração.](https://devcenter.stone.com.br/foundations-environments)[**Tratamento de erros**RFC 7807 Problem Details — formato único.](https://devcenter.stone.com.br/foundations-errors)[**Idempotência**Idempotency-Key em todas as escritas — sem duplicatas em retries.](https://devcenter.stone.com.br/foundations-idempotency)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.