# Valora Payments

> Documentação da Valora Payments: Pix, cartão e boleto por uma única API, com checkout pronto e webhooks assinados.

> ## Agent Instructions
> Valora Payments API (Brazil: Pix, card, boleto). Base URL https://api.valorapayments.com.br, Authorization: Bearer sk_vl_... used only on the server. Request amounts are reais as strings ("149.90"); response amounts are integer cents (14990). Use POST /v1/checkouts for card and boleto; POST /v1/payments only creates Pix and should send an Idempotency-Key. Confirm payments only through the payment.succeeded webhook after verifying X-Valora-Signature (hex HMAC-SHA256 of "<t>.<raw body>"), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json.

- [Bem-vindo à Valora Payments](https://dev.valorapayments.com.br/index.md): Receba por Pix, cartão e boleto com uma única integração, um checkout pronto e webhooks assinados.
- [Início rápido](https://dev.valorapayments.com.br/quickstart.md): Crie uma chave de teste, gere sua primeira cobrança Pix e receba a confirmação por webhook.
- [Teste e produção](https://dev.valorapayments.com.br/conceitos/ambientes.md): Como o ambiente de teste (Sandbox) e o de produção se separam, e o que muda entre eles.
- [Chaves de API](https://dev.valorapayments.com.br/conceitos/chaves-de-api.md): Crie chaves por ambiente, limite o que cada uma pode fazer com escopos e revogue quando precisar.
- [Checkouts](https://dev.valorapayments.com.br/recursos/checkouts.md): Uma página de pagamento pronta, com a sua marca, onde o cliente paga por Pix, cartão ou boleto.
- [Pix](https://dev.valorapayments.com.br/recursos/pix.md): Cobranças Pix com QR Code e copia e cola, confirmadas em segundos.
- [Cartão de crédito](https://dev.valorapayments.com.br/recursos/cartao.md): Pagamento com cartão em até 12 vezes, direto no checkout, sem o número do cartão passar pelo seu servidor.
- [Boleto](https://dev.valorapayments.com.br/recursos/boleto.md): Boleto bancário com Pix embutido, para clientes que preferem pagar pelo código de barras.
- [Produtos](https://dev.valorapayments.com.br/recursos/produtos.md): Cadastre o que você vende: nome, preço, imagens e tipo. O preço do produto é a base das cobranças e dos checkouts.
- [Clientes](https://dev.valorapayments.com.br/recursos/clientes.md): Guarde os dados de quem compra para reutilizar em cobranças e checkouts.
- [Saldo e saques](https://dev.valorapayments.com.br/recursos/saldo-e-saques.md): Entenda o saldo disponível e o saldo a liberar, e como sacar para a conta da empresa.
- [Devoluções e contestações](https://dev.valorapayments.com.br/recursos/devolucoes-e-contestacoes.md): Devolva um Pix ao pagador pela API e entenda o que acontece quando um comprador contesta uma compra no cartão.
- [Guia de integração](https://dev.valorapayments.com.br/integrar/guia-de-integracao.md): Escolha o caminho de integração, crie a cobrança no servidor e confirme o pagamento pelo webhook.
- [Webhooks](https://dev.valorapayments.com.br/integrar/webhooks.md): Receba no seu servidor, em tempo real e com assinatura, cada mudança de status dos pagamentos.
- [Catálogo de eventos](https://dev.valorapayments.com.br/integrar/eventos.md): Todos os eventos de webhook da Valora, quando cada um chega e o que fazer.
- [Idempotência](https://dev.valorapayments.com.br/integrar/idempotencia.md): Repita a criação de um pagamento com segurança, sem cobrar o cliente duas vezes.
- [Testes](https://dev.valorapayments.com.br/integrar/testes.md): Roteiro para validar a sua integração com uma chave de teste antes de receber pagamentos reais.
- [Checklist de produção](https://dev.valorapayments.com.br/integrar/producao.md): O que conferir antes de abrir as vendas reais.
- [Frameworks](https://dev.valorapayments.com.br/frameworks/visao-geral.md): Tutoriais passo a passo para integrar a Valora no seu framework: checkout, Pix e webhook com assinatura verificada.
- [Next.js](https://dev.valorapayments.com.br/frameworks/nextjs.md): Integre a Valora num app Next.js (App Router): crie a compra no servidor, redirecione para o checkout e confirme pelo webhook.
- [Node.js com Express](https://dev.valorapayments.com.br/frameworks/express.md): Integre a Valora numa API Express: crie compras, gere Pix e confirme os pagamentos pelo webhook.
- [Laravel](https://dev.valorapayments.com.br/frameworks/laravel.md): Integre a Valora numa aplicação Laravel com o Http Client: crie a compra, redirecione para o checkout e confirme pelo webhook.
- [Python com FastAPI](https://dev.valorapayments.com.br/frameworks/fastapi.md): Integre a Valora numa API FastAPI com httpx: crie compras e Pix e confirme os pagamentos pelo webhook.
- [Integre com IA](https://dev.valorapayments.com.br/ia/visao-geral.md): Dê ao seu agente de código (Claude Code, Cursor, Copilot, Codex) a documentação e as regras da Valora para integrar mais rápido e sem erros.
- [Servidor MCP](https://dev.valorapayments.com.br/ia/mcp.md): Conecte a documentação da Valora ao seu agente pelo Model Context Protocol, para ele pesquisar e ler as páginas sozinho.
- [Prompts prontos](https://dev.valorapayments.com.br/ia/prompts.md): Prompts testados para o seu agente integrar checkout, Pix e webhooks da Valora do jeito certo.
- [Regras para o projeto](https://dev.valorapayments.com.br/ia/regras.md): Um bloco de regras da Valora para o AGENTS.md, CLAUDE.md ou .cursor/rules do seu projeto.
- [Skill para agentes](https://dev.valorapayments.com.br/ia/skill.md): Instale a skill da Valora no seu agente de código para ele saber integrar e revisar pagamentos sem você repetir as regras.
- [Perguntas frequentes](https://dev.valorapayments.com.br/ajuda/faq.md): Respostas rápidas sobre formas de pagamento, prazos, taxas e integração.
- [Suporte](https://dev.valorapayments.com.br/ajuda/suporte.md): Como falar com a Valora e o que enviar para resolvermos mais rápido.
- [Referência da API](https://dev.valorapayments.com.br/api-reference/introducao.md): URL, autenticação, formato das respostas, limites e convenções da API REST da Valora.
- [Erros](https://dev.valorapayments.com.br/api-reference/erros.md): Formato das respostas de erro, os tipos possíveis e o que fazer em cada um.
- [Paginação](https://dev.valorapayments.com.br/api-reference/paginacao.md): Percorra listas com cursor usando limit e starting_after.
- [Criar um pagamento Pix](https://dev.valorapayments.com.br/api-reference/pagamentos/criar-um-pagamento-pix.md): Cria uma cobrança Pix e devolve o QR Code e o código copia e cola. Envie `amount` **ou** `product_id` (um dos dois). A confirmação chega pelo webhook `payment.succeeded`.
- [Listar pagamentos](https://dev.valorapayments.com.br/api-reference/pagamentos/listar-pagamentos.md): Lista os pagamentos do negócio, do mais novo para o mais antigo.
- [Consultar um pagamento](https://dev.valorapayments.com.br/api-reference/pagamentos/consultar-um-pagamento.md): Devolve um pagamento com o status atual.
- [Cancelar um pagamento](https://dev.valorapayments.com.br/api-reference/pagamentos/cancelar-um-pagamento.md): Cancela um Pix que ainda está aguardando pagamento (`requires_payment`). O QR Code deixa de valer e o evento `payment.canceled` é enviado.
- [Devolver um pagamento](https://dev.valorapayments.com.br/api-reference/pagamentos/devolver-um-pagamento.md): Devolve todo ou parte de um Pix aprovado **ao pagador**. Sem `amount`, devolve tudo o que resta. O valor sai do saldo disponível. Cartão e boleto são devolvidos pelo suporte.
- [Criar um checkout](https://dev.valorapayments.com.br/api-reference/checkouts/criar-um-checkout.md): Cria uma compra e devolve o `checkout_url`, o link que você manda ao cliente. O cliente escolhe Pix, cartão ou boleto na página da Valora. O preço vem do produto e fica travado na criação.
- [Consultar um checkout](https://dev.valorapayments.com.br/api-reference/checkouts/consultar-um-checkout.md): Devolve a compra com o status atual. A confirmação do pagamento continua chegando pelo webhook.
- [Criar um cliente](https://dev.valorapayments.com.br/api-reference/clientes/criar-um-cliente.md): Salva um cliente para reutilizar em cobranças e checkouts.
- [Listar clientes](https://dev.valorapayments.com.br/api-reference/clientes/listar-clientes.md): Lista os clientes do negócio, do mais novo para o mais antigo.
- [Consultar um cliente](https://dev.valorapayments.com.br/api-reference/clientes/consultar-um-cliente.md): Devolve um cliente.
- [Atualizar um cliente](https://dev.valorapayments.com.br/api-reference/clientes/atualizar-um-cliente.md): Atualiza só os campos enviados. `null` limpa um campo opcional.
- [Criar um produto](https://dev.valorapayments.com.br/api-reference/produtos/criar-um-produto.md): Cadastra um produto. O preço do produto é a base de checkouts e de cobranças com `product_id`.
- [Listar produtos](https://dev.valorapayments.com.br/api-reference/produtos/listar-produtos.md): Lista os produtos do negócio.
- [Consultar um produto](https://dev.valorapayments.com.br/api-reference/produtos/consultar-um-produto.md): Devolve um produto.
- [Atualizar um produto](https://dev.valorapayments.com.br/api-reference/produtos/atualizar-um-produto.md): Atualiza só os campos enviados. `null` limpa um campo opcional. Mudar o preço vale para as próximas compras; pagamentos já criados não mudam.
- [Consultar o saldo](https://dev.valorapayments.com.br/api-reference/saldo/consultar-o-saldo.md): Saldo do negócio, em centavos. Chave de teste mostra o saldo de teste. Não existe rota que tire dinheiro do saldo: saques são feitos pelo painel.
- [Criar um endpoint de webhook](https://dev.valorapayments.com.br/api-reference/webhooks/criar-um-endpoint-de-webhook.md): Cadastra uma URL para receber eventos. O `secret` aparece **só nesta resposta**. Limite: 10 endpoints ativos.
- [Listar endpoints de webhook](https://dev.valorapayments.com.br/api-reference/webhooks/listar-endpoints-de-webhook.md): Lista os endpoints ativos.
- [Consultar um endpoint de webhook](https://dev.valorapayments.com.br/api-reference/webhooks/consultar-um-endpoint-de-webhook.md): Devolve um endpoint ativo. O segredo nunca aparece aqui.
- [Remover um endpoint de webhook](https://dev.valorapayments.com.br/api-reference/webhooks/remover-um-endpoint-de-webhook.md): Desativa o endpoint. Entregas pendentes deixam de ser tentadas; o histórico continua visível.
- [Rotacionar o segredo](https://dev.valorapayments.com.br/api-reference/webhooks/rotacionar-o-segredo.md): Gera um novo segredo. O antigo para de valer na hora. O novo aparece **só nesta resposta**.
- [Listar entregas](https://dev.valorapayments.com.br/api-reference/webhooks/listar-entregas.md): Lista o que foi enviado ao endpoint e o resultado de cada entrega. Inclui endpoints removidos.
- [Reenviar uma entrega](https://dev.valorapayments.com.br/api-reference/webhooks/reenviar-uma-entrega.md): Coloca a entrega de novo na fila, com o mesmo evento. Serve para entregas que falharam ou para reprocessar uma já entregue.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.