---
title: "Pix (legado)"
url: "https://devcenter.stone.com.br/legacy-pix"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Pix+(legado),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktcGl4Ig,s_81S_C7oQM9h7l_WW.png"
---

# Pix

Cobrança via Pix na API Pagar.me v5 — DICT, QR Code dinâmico e SPI.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [Entendendo os conceitos](#entendendo-os-conceitos)

A integração com Pix através do Pagar.me requer que o lojista tenha conta transacional em **um dos participantes diretos do arranjo** Pix, para que seja possível repassar os dados na requisição e criação do QR Code.

## [O que é o Pix?](#o-que-é-o-pix)

O **Pix** é um sistema desenvolvido pelo Banco Central que disponibiliza uma forma de realizar **pagamentos, transferências e recebimentos** instantâneos.

Nesse arranjo, o **Sistema de Pagamentos Instantâneos (SPI)** é a infraestrutura centralizada para liquidação entre instituições — onde transferências de moedas eletrônicas ocorrem **24×7 em tempo real**.

Para o varejo, o Pix traz:

-   ✅ Aumento de eficiência do mercado
-   ✅ Mais segurança
-   ✅ Experiência mais fluida para o cliente
-   ✅ Custo significativamente menor que cartão

## [O que são as chaves Pix?](#o-que-são-as-chaves-pix)

Uma transferência tradicional entre instituições financeiras se baseia em um conjunto de dados de identificação (banco, agência, conta + dados pessoais). Pensando em uma experiência mais simples, o Pix introduziu o **Diretório de Identificadores de Contas Transacionais (DICT)**.

A proposta do DICT é atrelar todos os dados de conta a algumas **"chaves fortes"** mais comuns:

-   📧 **E-mail**
-   📱 **Telefone**
-   📄 **CPF / CNPJ**
-   🔑 **Chave aleatória** (UUID gerada pelo sistema)

No caso da Pagar.me, a instituição financeira do arranjo é o próprio Pagar.me — você não precisa cadastrar chave manualmente. Será usada uma **chave aleatória** atrelada à sua conta, sem dados pessoais expostos. Essa chave é criada assim que o contrato/aditivo Pix é firmado.

## [Como funciona uma compra com Pix](#como-funciona-uma-compra-com-pix)

```text
Lojista → Pagar.me → BACEN/SPI → Banco do pagador → Pagador
   ↑                                                    ↓
   └──── Webhook charge.paid ←── Confirmação ←─────────┘
```

1.  **Pagador** recebe o QR Code com dados bancários do recebedor e detalhes do produto
2.  **Pagador** abre o app do banco (PSP), escaneia o QR e aceita a transferência
3.  **PSP** realiza a transferência via SPI
4.  **Recebedor** é notificado via webhook que o valor foi creditado

## [Como criar uma venda com Pix no Pagar.me](#como-criar-uma-venda-com-pix-no-pagarme)

Para criar uma transação com Pix na v5, o lojista informa o `payment_method = pix` na criação do pedido + a `expires_in`.

```bash
curl -X POST https://api.stone.com.br/core/v5/orders \
  -H "Authorization: Basic $(echo -n $API_KEY: | base64)" \
  -d '{
    "items": [{ "amount": 1990, "description": "Pedido 1042", "quantity": 1 }],
    "customer": { "name": "Maria", "email": "maria@x.com" },
    "payments": [{
      "payment_method": "pix",
      "pix": { "expires_in": 3600 }
    }]
  }'
```

A resposta inclui:

```json
{
  "charges": [{
    "last_transaction": {
      "qr_code": "00020126360014BR.GOV.BCB.PIX...",
      "qr_code_url": "https://api.stone.com.br/.../pix.png",
      "expires_at": "2026-04-28T15:32:11Z"
    }
  }]
}
```

Posteriormente, o webhook `order.paid` informa que o pedido foi concluído.

Migração para a API Unificada

Na Stone, basta `payment_method: "pix"` em [`POST /v1/charges`](https://devcenter.stone.com.br/reference-charges-create) — a Stone gerencia chave DICT, QR Code e webhooks automaticamente. Veja também o [Quickstart · PIX](https://devcenter.stone.com.br/quickstart-pix) com exemplo Node, Python e cURL.

---

**Jornada: [Cobrar um cliente](https://devcenter.stone.com.br/legacy-overview-transacao)**  
Etapa 22 de 22

[**Etapa anterior**Cash](https://devcenter.stone.com.br/legacy-cash)

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.