Pular para o conteúdo principal
A API da Valora é REST, recebe e devolve JSON e usa os status HTTP padrão. Todas as rotas ficam em /v1.

Início rápido

A primeira cobrança em poucos minutos.

Webhooks

Confirmação dos pagamentos no seu servidor.

URL base

A mesma URL atende teste e produção. O ambiente vem da chave usada. Veja Teste e produção.

Autenticação

Envie a chave no header Authorization, no formato Bearer:
Use a chave só no servidor. Veja Chaves de API para escopos e revogação.

Convenções

Dinheiro

A moeda é sempre BRL. O valor mínimo é 0.01.

Ids

Todo objeto tem um id com prefixo:

Datas

Datas vêm em ISO 8601, em UTC: 2026-11-14T15:02:11.000Z.

Campos opcionais

Campos sem valor vêm como null, nunca omitidos. Nas rotas PATCH, enviar null limpa o campo.

external_reference e metadata

  • external_reference: o seu identificador (id do pedido, SKU), até 100 caracteres. Use para conciliar e para buscar.
  • metadata: até 20 pares de chave e valor em texto (chave até 40, valor até 500 caracteres). Volta igual em todas as respostas e webhooks.
Não coloque dados sensíveis (senhas, números de cartão, documentos completos) em metadata.

Respostas

Sucesso: o objeto, ou uma lista.
Erro: sempre no mesmo formato. Veja Erros.

Limites

Passou do limite? A resposta é 429 rate_limited com o header Retry-After (em segundos).

Recursos

Pagamentos

Cobranças Pix, cancelamento e devolução.

Checkouts

Compras com página de pagamento pronta.

Clientes

Dados de quem compra.

Produtos

Catálogo e preços.

Saldo

Disponível e a liberar.

Webhooks

Endpoints, entregas e segredos.