---
title: "Idempotência"
url: "https://devcenter.stone.com.br/foundations-idempotency"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~SWRlbXBvdMOqbmNpYQ,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9mb3VuZGF0aW9ucy1pZGVtcG90ZW5jeSI,s_HOIT9M88be5jw_4k.png"
---

## **Idempotência**

Idempotency-Key em todas as escritas — sem duplicatas em retries.

Toda chamada `POST` que cria um recurso aceita o header `Idempotency-Key`. Reenviar a mesma chave dentro de **24h** retorna a _mesma resposta_ sem criar duplicatas.

```bash
curl -X POST https://api.stone.com.br/v1/charges \\
  -H "Authorization: Bearer $TOKEN" \\
  -H "Idempotency-Key: 7b3f8e2a-9c4d-4e6f-8a1b-0d3c5e7f9a2b" \\
  -H "Content-Type: application/json" \\
  -d '{ "amount": 1990, "payment_method": "pix" }'
```

-   Use **UUIDv4** ou ULID
-   Uma chave por _intenção de negócio_ (não por retry)
-   Mesma chave + corpo diferente = erro `409 idempotency_key_reused`

## [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)[**Foundations**Tudo que é compartilhado entre Checkout, Stone Online, Físico/TEF e Conta Stone.](https://devcenter.stone.com.br/foundations-overview)

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.