> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payable.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox

> Construa e teste sem custo e sem mensagens reais.

Chaves que começam com `esk_test_` rodam em um sandbox isolado:

* **Sem débito**: o saldo da carteira não muda
* **Sem mensagens reais**: WhatsApp, e-mail e SMS são simulados, e os webhooks continuam disparando
* **Dados isolados**: clientes e cobranças de teste não aparecem na visão de produção do painel
* **PIX fake**: QR codes de teste com simulação de pagamento

## Simular pagamento

```bash theme={null}
curl -X POST "https://api.payable.run/api/v1/test/payments/ID_DO_PAGAMENTO/simulate-paid" \
  -H "Authorization: Bearer esk_test_SUA_CHAVE"
```

Dispara os webhooks `payment.received` e `debt.paid` com `"live": false`. Com uma chave live, retorna `403`.

## Ir para produção

**1. Crie uma chave live**

Configurações → API & Webhooks → Criar chave → **Produção**.

**2. Troque a chave**

Substitua a variável de ambiente no seu sistema. Nenhuma mudança de código é necessária.

**3. Registre os webhooks de produção**

Use URLs separadas das de teste e confira o campo `live` em cada payload.

**4. Confira o saldo**

Envios live são debitados da sua carteira. Um `402` com `INSUFFICIENT_BALANCE` indica que é preciso recarregar.


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