> ## Documentation Index > Fetch the complete documentation index at: https://dev.valorapayments.com.br/llms.txt > Use this file to discover all available pages before exploring further. > ## 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 "."), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json. # Bem-vindo à Valora Payments > Receba por Pix, cartão e boleto com uma única integração, um checkout pronto e webhooks assinados. A **Valora Payments** é a infraestrutura de pagamentos da sua empresa. Você cria uma cobrança ou um link de pagamento, o cliente paga pelo método que preferir e o seu sistema recebe a confirmação por webhook. O dinheiro entra no seu saldo e você saca para a conta da empresa. > [card] [Início rápido](https://dev.valorapayments.com.br/quickstart.md) > > Crie sua primeira cobrança Pix em poucos minutos. > [card] [Guia de integração](https://dev.valorapayments.com.br/integrar/guia-de-integracao.md) > > Escolha o caminho certo para o seu produto. > [card] [Referência da API](https://dev.valorapayments.com.br/api-reference/introducao.md) > > Todos os endpoints, parâmetros e respostas. ## O que a Valora resolve > [card] Três formas de pagamento > > Pix, cartão de crédito em até 12 vezes e boleto com Pix embutido, na mesma integração. > [card] Checkout pronto > > Uma página de pagamento hospedada, com a sua marca, que funciona no celular e no computador. > [card] Confirmação em tempo real > > Webhooks assinados avisam o seu sistema assim que o pagamento é confirmado. > [card] Saldo e saques > > Acompanhe o saldo disponível e a liberar, e saque para a chave Pix da empresa. ## Comece Para começar, crie sua conta no [painel da Valora](https://console.valorapayments.com.br). Enquanto a conta passa pela análise, você já pode integrar e testar no ambiente de teste. **1. Crie sua conta** Cadastre a empresa no painel. A análise libera os pagamentos reais. O ambiente de teste fica disponível desde o primeiro acesso. **2. Cadastre seu primeiro produto** O produto define o nome e o preço que o cliente vê no checkout. Crie no painel ou pela API. > [card] [Produtos](https://dev.valorapayments.com.br/recursos/produtos.md) > > Tipos, preço, imagens e status de um produto. **3. Escolha como o cliente paga** > [tab] Link de pagamento > > Crie um link fixo no painel e compartilhe por WhatsApp, e-mail ou redes sociais. Não exige código. > > > [card] [Checkouts](https://dev.valorapayments.com.br/recursos/checkouts.md) > > > > Links fixos, personalização visual e funil de vendas. > [tab] Checkout pela API > > O seu servidor cria uma compra com `POST /v1/checkouts` e redireciona o cliente para o `checkout_url`. O cliente escolhe Pix, cartão ou boleto na página da Valora. > > > [card] [Criar um checkout](https://dev.valorapayments.com.br/api-reference/checkouts/criar-um-checkout.md) > > > > Corpo, resposta e exemplos. > [tab] Pix direto pela API > > O seu servidor cria uma cobrança Pix com `POST /v1/payments` e mostra o QR Code ou o código copia e cola na sua própria tela. > > > [card] [Pix](https://dev.valorapayments.com.br/recursos/pix.md) > > > > Como funciona a cobrança Pix e o ciclo de vida do pagamento. **4. Teste a integração** Use uma chave de teste para criar cobranças sem dinheiro real e receber webhooks de verdade. > [card] [Teste e produção](https://dev.valorapayments.com.br/conceitos/ambientes.md) > > Como os dois ambientes se separam. > [card] [Testes](https://dev.valorapayments.com.br/integrar/testes.md) > > Roteiro para validar cada forma de pagamento. **5. Vá para produção** Troque a chave de teste por uma chave de produção e confira a lista antes de abrir as vendas. > [card] [Checklist de produção](https://dev.valorapayments.com.br/integrar/producao.md) > > O que conferir antes de receber o primeiro pagamento real. ## Integre com agentes de IA Use o prompt abaixo no Claude Code, no Cursor ou em outro agente de código para começar a integração já no padrão da Valora. Integrar a Valora Payments no meu projeto Integre a Valora Payments ([https://dev.valorapayments.com.br](https://dev.valorapayments.com.br/index.md)) no meu projeto. Regras: * Use a API REST em [https://api.valorapayments.com.br](https://api.valorapayments.com.br) com o header Authorization: Bearer sk\_vl\_... A chave fica só no servidor, em variável de ambiente (VALORA\_API\_KEY). * Valores na entrada vão em reais como texto ("49.90"). Valores nas respostas vêm em centavos inteiros (4990). * Para vender um produto, crie a compra com POST /v1/checkouts e redirecione o cliente para checkout\_url. * Para Pix direto, use POST /v1/payments com method "pix" e o header Idempotency-Key. * Confirme o pagamento só pelo webhook payment.succeeded. Valide o header X-Valora-Signature (HMAC-SHA256 do texto "t.corpo\_cru", onde t vem do header) com o segredo do webhook antes de liberar o pedido, e trate eventos repetidos. * Comece com uma chave de teste (Sandbox). Antes de escrever código, leia a página do recurso usado e a página de webhooks na documentação. > [card] [IA e agentes](https://dev.valorapayments.com.br/ia/visao-geral.md) > > Servidor MCP, prompts prontos, regras para o projeto e skill. > [card] [Tutoriais por framework](https://dev.valorapayments.com.br/frameworks/visao-geral.md) > > Next.js, Express, Laravel e FastAPI, do checkout ao webhook. ## Ferramentas para desenvolvedores > [card] [Webhooks](https://dev.valorapayments.com.br/integrar/webhooks.md) > > Receba eventos assinados e reenvie entregas que falharam. > [card] [Idempotência](https://dev.valorapayments.com.br/integrar/idempotencia.md) > > Repita requisições sem criar cobranças duplicadas. > [card] [Erros](https://dev.valorapayments.com.br/api-reference/erros.md) > > Formato dos erros e o que fazer em cada caso. > [card] [Paginação](https://dev.valorapayments.com.br/api-reference/paginacao.md) > > Percorra listas grandes com cursor. ## Precisa de ajuda? > [card] [Perguntas frequentes](https://dev.valorapayments.com.br/ajuda/faq.md) > > Respostas rápidas sobre taxas, prazos e integração. > [card] [Fale com a gente](mailto:contato@valorapayments.com.br) > > Escreva para [contato@valorapayments.com.br](mailto:contato@valorapayments.com.br). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.