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

# Saldo e saques

> Entenda o saldo disponível e o saldo a liberar, e como sacar para a conta da empresa.

Todo pagamento confirmado vira saldo no seu negócio, já descontada a taxa da Valora. O saldo se divide em duas partes:

| Parte | O que é |
| - | - |
| **Disponível** (`available`) | pode ser sacado agora |
| **A liberar** (`pending`) | já é seu, mas ainda não chegou a data de liberação (vendas no cartão) |

## Quando cada venda fica disponível

| Forma de pagamento | Disponível |
| - | - |
| Pix | na hora da confirmação |
| Boleto | na hora da confirmação |
| Cartão | em parcelas mensais, a partir de 30 dias após a compra |

## Consultar o saldo

```bash theme={null}
curl https://api.valorapayments.com.br/v1/balance \
  -H "Authorization: Bearer $VALORA_API_KEY"
```

```json theme={null}
{
  "object": "balance",
  "currency": "BRL",
  "available": 125430,
  "pending": 48000,
  "updated_at": "2026-11-14T15:02:11.000Z"
}
```

Os valores vêm em centavos: `125430` é R\$ 1.254,30. Com uma chave de teste, a resposta mostra o saldo de teste.

## Taxas

A taxa de cada pagamento fica registrada no próprio pagamento, no campo `fee`:

```json theme={null}
"fee": { "bps": 199, "fixed": 0, "amount": 298 }
```

| Campo | Significado |
| - | - |
| `bps` | parte percentual, em pontos-base (199 = 1,99%) |
| `fixed` | parte fixa, em centavos |
| `amount` | taxa total cobrada neste pagamento, em centavos |

As taxas vigentes estão no [site da Valora](https://valorapayments.com.br/pt-BR#fees) e no painel.

## Sacar

Os saques são feitos **pelo painel**, em **Saques**. Não existe endpoint de saque na API: nenhuma chave consegue tirar dinheiro do seu saldo.

**1. Escolha o destino**

Uma chave Pix da empresa.

**2. Informe o valor**

O painel mostra a taxa de saque e quanto chega no destino.

**3. Acompanhe**

O saque passa por análise e o status aparece no painel até a conclusão.

> [!NOTE]
>
> Por segurança, o primeiro saque para uma chave Pix nova sempre passa por conferência manual.


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