# Accelerazione: API de pagamentos

> Documentação da API Accelerazione: cobranças com Pix, cartão e Pix parcelado, estornos, webhooks, saques e saldo. Toda a documentação está em português do Brasil, e cada página tem uma versão em Markdown: acrescente `.md` ao fim da URL.

Fatos que valem para todas as chamadas:

- Autenticação: cabeçalho `Authorization` com a chave de API, sem prefixo. A chamada sai sempre do servidor do integrador, nunca do navegador.
- Todos os valores são inteiros na menor unidade da moeda, em cobranças, saques e extrato: `1990` em BRL é R$ 19,90.
- A criação de cobrança aceita o cabeçalho `Idempotency-Key`, com retenção de 24 horas.
- O resultado financeiro de uma cobrança é o `status` do PaymentIntent. QR Code gerado, iframe 3DS concluído ou retorno do comprador ao site não provam pagamento.
- Webhooks são assinados com HMAC-SHA256 no cabeçalho `X-DM-Signature`.
- Especificação OpenAPI 3.1: https://docs.accelerazione.com.br/openapi.yaml (também em https://docs.accelerazione.com.br/openapi.json).
- Toda a documentação em um arquivo: https://docs.accelerazione.com.br/llms-full.txt

## Comece aqui

- [Visão geral](https://docs.accelerazione.com.br/docs.md): A API Accelerazione em uma página. Um objeto de cobrança para Pix, cartão e Pix parcelado, webhooks assinados, estornos, saques e saldo.
- [Primeira cobrança Pix](https://docs.accelerazione.com.br/docs/primeiros-passos.md): Do zero a um Pix criado, exibido e confirmado no sandbox, em cinco passos.
- [Ambientes e endereços](https://docs.accelerazione.com.br/docs/ambientes.md): As superfícies da API (API, Hooks e SDKs), os endereços de sandbox e de produção, e as diferenças entre os dois ambientes.
- [Autenticação](https://docs.accelerazione.com.br/docs/autenticacao.md): Como enviar a chave de API, o que acontece quando ela falha e como mantê-la segura.
- [Integre com agentes de IA](https://docs.accelerazione.com.br/docs/agentes-de-ia.md): Como apontar Claude, ChatGPT, Cursor ou qualquer assistente de código para esta documentação, e as regras que ele precisa seguir para gerar uma integração segura.

## Fundamentos

- [O objeto PaymentIntent](https://docs.accelerazione.com.br/docs/payment-intent.md): O recurso que representa uma cobrança em todos os métodos, seus estados e o que cada um significa para o seu pedido.
- [Valores e moedas](https://docs.accelerazione.com.br/docs/valores-e-moedas.md): Como representar dinheiro em cada API, as moedas aceitas por método e os limites de valor.
- [Idempotência](https://docs.accelerazione.com.br/docs/idempotencia.md): Como repetir chamadas com segurança depois de uma falha de rede, sem criar cobranças duplicadas.
- [Dados do comprador](https://docs.accelerazione.com.br/docs/comprador.md): Os campos de customer exigidos por método de pagamento, o formato de documento, telefone e endereço, e os dados de dispositivo em cartões.

## Receber

- [Split de pagamentos](https://docs.accelerazione.com.br/docs/split.md): Distribua o valor de uma cobrança entre recebedores cadastrados, por percentual ou valor fixo, e concilie o valor calculado.

## Pix

- [Pix](https://docs.accelerazione.com.br/docs/pix.md): Cobranças Pix com QR Code e copia e cola, confirmadas por webhook assinado ou consulta.
- [Crie uma cobrança Pix](https://docs.accelerazione.com.br/docs/pix/criar-cobranca.md): Crie o PaymentIntent Pix no servidor, com valor, prazo, comprador e URL de webhook.
- [Exiba o QR Code e acompanhe](https://docs.accelerazione.com.br/docs/pix/exibir-e-acompanhar.md): Use os dados de pixPayment para mostrar o QR Code, o código copia e cola e o prazo, e confirme o pagamento pelo servidor.

## Cartões

- [Cartões](https://docs.accelerazione.com.br/docs/cartoes.md): O fluxo de cobrança com cartão de crédito e débito, com coleta de dispositivo e autenticação 3DS, de ponta a ponta.
- [Abra a sessão 3DS](https://docs.accelerazione.com.br/docs/cartoes/sessao-3ds.md): Crie no servidor a sessão de coleta de dados do dispositivo que acompanha cada tentativa de cobrança com cartão de crédito.
- [Colete os dados do dispositivo](https://docs.accelerazione.com.br/docs/cartoes/coleta-do-dispositivo.md): Carregue o SDK DM3DS no checkout e execute a coleta de dados do dispositivo do comprador antes de criar a cobrança.
- [Crie a cobrança com cartão](https://docs.accelerazione.com.br/docs/cartoes/criar-cobranca.md): Envie a cobrança de crédito com o cartão, a sessão 3DS, o comprador e o split, e trate os quatro desfechos possíveis.
- [Opções e dados do cartão](https://docs.accelerazione.com.br/docs/cartoes/opcoes.md): Campos do cartão, parcelamento, 3DS, débito, moeda, descritor de fatura e categoria de atividade (MCC).
- [Exiba o desafio 3DS](https://docs.accelerazione.com.br/docs/cartoes/desafio-3ds.md): Abra o desafio em um iframe quando a cobrança voltar RequiresAction, receba as mensagens do navegador e confirme o resultado pelo servidor.
- [Capture o cartão com o SDK de campos](https://docs.accelerazione.com.br/docs/cartoes/sdk-de-campos.md): Colete os dados do cartão em campos seguros da Accelerazione dentro do seu checkout e cobre com um token, sem que número e código de segurança passem pela sua página ou pelo seu servidor.
- [Referência do SDK de campos](https://docs.accelerazione.com.br/docs/cartoes/sdk-referencia.md): Todas as opções, métodos, eventos e erros do DMCard, com aparência, idiomas, versões fixas e integração com React, Vue e Angular.
- [Tokenize um cartão](https://docs.accelerazione.com.br/docs/cartoes/tokenizacao.md): Guarde um cartão do comprador como token reutilizável e cobre com ele em compras futuras, sem armazenar o número do cartão.

## Pix parcelado

- [Pix parcelado](https://docs.accelerazione.com.br/docs/pix-parcelado.md): Ofereça Pix parcelado pelo checkout da Pagaleve. O comprador parcela, a captura é automática e você acompanha pelo PaymentIntent.
- [Pré-análise](https://docs.accelerazione.com.br/docs/pix-parcelado/pre-analise.md): Consulte, antes de mostrar a opção, se o Pix parcelado deve ser oferecido para um comprador e um valor.
- [Checkout parcelado](https://docs.accelerazione.com.br/docs/pix-parcelado/checkout.md): Crie a cobrança Pix parcelado, redirecione o comprador para a Pagaleve e confirme o pagamento pelo servidor.

## Depois do pagamento

- [Consulte um pagamento](https://docs.accelerazione.com.br/docs/consultar-pagamento.md): Leia o estado atual de um PaymentIntent, interprete cada status e saiba quais campos guardar para conciliação.
- [Estornos](https://docs.accelerazione.com.br/docs/estornos.md): Peça a devolução integral de uma cobrança paga e acompanhe o resultado assíncrono pelo refundId.

## Webhooks

- [Receba webhooks](https://docs.accelerazione.com.br/docs/webhooks.md): Como a Accelerazione notifica o seu servidor sobre desfechos de cobranças e estornos, e o contrato que o seu endpoint precisa cumprir.
- [Eventos](https://docs.accelerazione.com.br/docs/webhooks/eventos.md): Catálogo dos tipos de webhook, quando cada um é enviado e o formato exato do campo data.
- [Verifique a assinatura](https://docs.accelerazione.com.br/docs/webhooks/assinatura.md): Valide o HMAC-SHA256 do cabeçalho X-DM-Signature para ter certeza de que o webhook veio da Accelerazione e não foi alterado.

## Saques e saldo

- [Visão geral de saques e saldo](https://docs.accelerazione.com.br/docs/saques.md): Como o dinheiro sai da sua conta Accelerazione por Pix, como consultar saldo e extrato, e as diferenças em relação à API de cobranças.
- [Consulte saldo e extrato](https://docs.accelerazione.com.br/docs/saques/saldo-e-extrato.md): Obtenha o saldo atual, o total agendado e as movimentações de uma conta, com paginação por cursor e comprovante de Pix recebido.
- [Solicite um saque](https://docs.accelerazione.com.br/docs/saques/solicitar-saque.md): Peça uma transferência Pix do saldo da sua conta para a chave de destino cadastrada, com idempotência e as regras de valor e titularidade.
- [Acompanhe e cancele saques](https://docs.accelerazione.com.br/docs/saques/acompanhar-saque.md): Estados do saque, consulta por identificador, listagem com filtros e cancelamento de um saque ainda em análise.
- [Erros de saque](https://docs.accelerazione.com.br/docs/saques/erros.md): Todos os códigos que as rotas de saque podem devolver, o que cada um significa e se vale repetir a chamada.

## Erros

- [Como tratar erros](https://docs.accelerazione.com.br/docs/erros.md): Os formatos de erro da API, como distinguir erro HTTP de cobrança recusada, e quando é seguro repetir uma chamada.
- [Códigos de erro](https://docs.accelerazione.com.br/docs/erros/codigos.md): Catálogo dos códigos que a criação, a consulta e o estorno de cobranças podem devolver, com a causa e a ação de cada um.

## Antes de produzir

- [Novidades](https://docs.accelerazione.com.br/docs/novidades.md): Mudanças na documentação e no contrato da API, em ordem cronológica.

## Homologação

- [Roteiro de homologação](https://docs.accelerazione.com.br/docs/homologacao.md): Os cenários que a sua integração precisa passar no sandbox antes da liberação de produção, com a preparação e o resultado esperado de cada um.
- [Dados de teste](https://docs.accelerazione.com.br/docs/homologacao/dados-de-teste.md): Cartões de teste do sandbox, o nome do titular que controla cada desfecho e como simular confirmações de Pix.
- [Checklist de entrega](https://docs.accelerazione.com.br/docs/homologacao/checklist.md): Os critérios que encerram a homologação no sandbox e o que enviar à equipe de integração ao pedir suporte.

## Optional

- [Referência da API](https://docs.accelerazione.com.br/docs/api.md): Todas as rotas da API Accelerazione, com campos, respostas e exemplos, geradas da especificação OpenAPI 3.1.
- [Consultar cobrança](https://docs.accelerazione.com.br/docs/api/cobrancas/consultar-cobranca.md): Devolve o estado atual da cobrança. Logo após a criação ou um webhook, pode devolver estado anterior ou `404` temporário.
- [Criar cobrança](https://docs.accelerazione.com.br/docs/api/cobrancas/criar-cobranca.md): Cria uma cobrança (PaymentIntent) com Pix, cartão de crédito, cartão de débito ou Pix parcelado.
- [Solicitar estorno](https://docs.accelerazione.com.br/docs/api/estornos/solicitar-estorno.md): Pede o estorno **integral** e assíncrono de uma cobrança `Succeeded`. `202` confirma o pedido, não a devolução.
- [Pré-análise do Pix parcelado](https://docs.accelerazione.com.br/docs/api/pix-parcelado/pre-analise.md): Indica se o Pix parcelado deve ser oferecido a um comprador e valor. Não reserva crédito nem garante aprovação.
- [Abrir sessão 3DS](https://docs.accelerazione.com.br/docs/api/3ds/abrir-sessao.md): Abre a sessão de coleta de dados do dispositivo para uma tentativa de cobrança de crédito.
- [Abrir sessão do SDK de campos](https://docs.accelerazione.com.br/docs/api/tokenizacao/abrir-sessao-de-campos.md): Abre a sessão que autoriza o SDK de campos (`DMCard`) a capturar o cartão no navegador do comprador.
- [Tokenizar cartão](https://docs.accelerazione.com.br/docs/api/tokenizacao/criar-token.md): Troca os dados do cartão por um token reutilizável (`ctok_…`). Não cobra nada.
- [Cancelar saque](https://docs.accelerazione.com.br/docs/api/saques/cancelar-saque.md): Cancela um saque ainda em análise. Idempotente. A devolução do valor ao saldo é assíncrona.
- [Consultar saque](https://docs.accelerazione.com.br/docs/api/saques/consultar-saque.md): Devolve o estado atual de um saque. Saque de outra conta responde `404`, igual a um inexistente.
- [Listar saques](https://docs.accelerazione.com.br/docs/api/saques/listar-saques.md): Lista os saques da conta, do mais recente para o mais antigo, com paginação por número de página.
- [Solicitar saque](https://docs.accelerazione.com.br/docs/api/saques/solicitar-saque.md): Cria um pedido de saque por Pix para a chave de destino cadastrada da conta. O valor é reservado
- [Consultar comprovante de lançamento](https://docs.accelerazione.com.br/docs/api/saldo-e-extrato/consultar-comprovante.md): Detalhe de um lançamento. Hoje só Pix recebido tem comprovante; os demais respondem `422 Statement.DetailNotAvailable`, definitivo.
- [Consultar saldo e extrato](https://docs.accelerazione.com.br/docs/api/saldo-e-extrato/consultar-extrato.md): Saldo atual, total agendado e movimentações de uma conta de recebedor vinculado à sua conta.
- [Evento de cobrança](https://docs.accelerazione.com.br/docs/api/webhooks/evento-de-cobranca.md): Enviado à `postbackUrl` da cobrança quando ela chega a um desfecho. Responda **exatamente 200** depois de gravar o evento.