> ## 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.

# Teste e produção

> Como o ambiente de teste (Sandbox) e o de produção se separam, e o que muda entre eles.

A Valora tem dois ambientes. O **Sandbox** serve para integrar e testar sem dinheiro real. A **produção** cobra e paga de verdade. Os dois usam a mesma URL e os mesmos endpoints: quem decide o ambiente é a chave de API.

## A chave define o ambiente

| | Sandbox | Produção |
| - | - | - |
| Chave | criada com o ambiente **Sandbox** | criada com o ambiente **Production** |
| Dinheiro | nenhum dinheiro real se move | cobranças e saques reais |
| Campo `livemode` | `false` | `true` |
| Saldo (`GET /v1/balance`) | saldo de teste | saldo real |
| Webhooks | entregues de verdade, com `livemode: false` | entregues com `livemode: true` |

Não existe parâmetro para trocar de ambiente numa requisição. Para mudar, troque a chave.

> [!NOTE]
>
> Todo objeto da API traz `livemode`. Confira esse campo no webhook antes de liberar um pedido: um evento de teste nunca deve liberar uma venda real.

## Conta em análise

Logo depois do cadastro, a sua empresa passa por uma análise. Enquanto isso, o Sandbox já funciona normalmente. Os pagamentos reais só ficam disponíveis depois da aprovação.

## Mesma URL, dados separados

* Base da API: `https://api.valorapayments.com.br`
* Checkout: `https://pay.valorapayments.com.br`

Pagamentos, sessões de checkout e saldo de teste ficam separados dos reais. Produtos, clientes e webhooks cadastrados pertencem ao negócio e são vistos pelas duas chaves.

> [!WARNING]
>
> Cada webhook cadastrado recebe os eventos **dos dois ambientes**. Se o mesmo servidor atende teste e produção, separe pelo campo `livemode` do evento. Um evento com `livemode: false` nunca deve liberar uma venda real.

## Próximos passos

> [card] [Chaves de API](https://dev.valorapayments.com.br/conceitos/chaves-de-api.md)
>
> Como criar, limitar e revogar chaves.

> [card] [Testes](https://dev.valorapayments.com.br/integrar/testes.md)
>
> Roteiro de testes para cada forma de pagamento.


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