> ## 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 "<t>.<raw body>"), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json.

# Perguntas frequentes

> Respostas rápidas sobre formas de pagamento, prazos, taxas e integração.

> [accordion] Quais formas de pagamento posso aceitar?
>
> Pix, cartão de crédito (em 1, 2, 3, 6 ou 12 vezes) e boleto com Pix embutido. Pix pode ser cobrado direto pela API. Cartão e boleto são pagos pelo checkout da Valora.

> [accordion] Preciso saber programar?
>
> Não. Você cria um link de pagamento no painel e compartilha. A API é para quem quer integrar a venda no próprio sistema.

> [accordion] Quanto custa?
>
> Não há mensalidade nem taxa de adesão. Você paga uma taxa por transação. As taxas estão no [site da Valora](https://valorapayments.com.br/pt-BR#fees), e a taxa de cada pagamento aparece no campo `fee`.

> [accordion] Quando o dinheiro fica disponível?
>
> Pix e boleto ficam disponíveis assim que o pagamento é confirmado. Vendas no cartão são liberadas em parcelas mensais, a partir de 30 dias após a compra. Veja [Saldo e saques](https://dev.valorapayments.com.br/recursos/saldo-e-saques.md).

> [accordion] Como saco o meu saldo?
>
> Pelo painel, em **Saques**, para a chave Pix da empresa. Não existe saque pela API.

> [accordion] Por que os valores vêm em centavos?
>
> Para evitar erros de arredondamento. Você envia `"49.90"` (reais) e recebe `4990` (centavos inteiros). Divida por 100 para exibir.

> [accordion] Posso criar cobranças de cartão pela API?
>
> Não diretamente. Crie uma compra com `POST /v1/checkouts` e mande o cliente para o `checkout_url`. Assim o número do cartão nunca passa pelo seu servidor.

> [accordion] Como devolvo um pagamento?
>
> Pix: com `POST /v1/payments/{payment_id}/refund`, total ou parcial. Cartão e boleto: fale com o [suporte](https://dev.valorapayments.com.br/ajuda/suporte.md).

> [accordion] O cliente voltou para a success\_url. Posso liberar o pedido?
>
> Não. Libere só ao receber o webhook `payment.succeeded` com assinatura válida.

> [accordion] Meu webhook não está chegando. O que confiro?
>
> 1. A URL é HTTPS e pública (não `localhost` nem IP interno)?
> 2. O endpoint está inscrito no evento?
> 3. O seu servidor responde `2xx` em menos de 10 segundos?
> 4. Veja o status HTTP e o erro de cada entrega em **Desenvolvedores → Webhooks** e reenvie se precisar.

> [accordion] Recebi 401 invalid\_api\_key.
>
> Confira o header `Authorization: Bearer sk_vl_...`, sem espaços ou aspas a mais, e se a chave não foi revogada.

> [accordion] Recebi 429 rate\_limited.
>
> Você passou de 300 requisições por minuto com a mesma chave. Espere os segundos indicados no header `Retry-After` e tente de novo.


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