Visão geral
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.
A API da Accelerazione permite cobrar com Pix, cartão de crédito ou débito e Pix parcelado com a Pagaleve, devolver pagamentos e movimentar o saldo da sua conta. Todas as cobranças usam o mesmo recurso, o PaymentIntent, para identificar a cobrança e consultar o resultado.
Uma integração, três jornadas de cobrança
| Método | O que o seu checkout faz | Como confirmar |
|---|---|---|
| Pix | Exibe o QR Code e o código copia e cola. | Webhook ou consulta. |
| Cartões | Envia a cobrança e apresenta o desafio 3DS quando solicitado. | Resposta da criação, webhook ou consulta. |
| Pix parcelado | Redireciona o comprador ao checkout da Pagaleve. | Webhook ou consulta. |
Depois do pagamento, a mesma API cuida de estornos, webhooks, saques e saldo e extrato.
Como a integração se organiza
- O servidor fala com a API, com a chave de API. Cria cobranças, consulta, estorna, saca e recebe webhooks.
- O navegador fala só com a superfície Hooks, por meio do SDK 3DS e do iframe de desafio, e só em cobranças com cartão. Ele nunca vê a chave de API.
Princípios do contrato
- Valores em centavos, em toda a API.
1990é R$ 19,90 em cobranças, saques e extrato. Veja Valores e moedas. statusé a verdade.201 Createddiz que a cobrança foi criada; o resultado está emstatus. Um cartão recusado também volta201, comstatus: "Failed".- Toda criação é idempotente. Envie
Idempotency-Keye repita com a mesma chave em falhas de rede. Veja Idempotência. - Webhooks são avisos assinados. Valide a assinatura e confirme o estado pela API em caso de dúvida. Veja Webhooks.
- Campos novos podem aparecer. O seu leitor de JSON deve ignorar o que não conhece.
Por onde começar
Primeira cobrança Pix
Tutorial de ponta a ponta no sandbox.
Ambientes e endereços
URLs do sandbox, superfícies e o que pedir no credenciamento.
Referência da API
Todas as rotas, campos e respostas, geradas da especificação OpenAPI.
Para agentes de IA
llms.txt, Markdown por página e instruções para o seu assistente.
Os exemplos de resposta são recortes do JSON real: outros campos podem vir. Valores como SUA_API_KEY, ID_DO_RECEBEDOR e TOKEN_DA_SESSAO devem ser trocados pelos dados do seu credenciamento ou devolvidos pela API. Dados de compradores são fictícios.