Home
SiteDashboardInternet Bank
Home
SiteDashboardInternet Bank
  1. Embedded Bank
  • Home
  • Embedded Bank
    • Guias
    • Autenticação
    • Paginação
    • Idempotência
    • Erros
    • Data e Hora
    • Eventos e Webhooks
    • Modelo de dados
      • Entidades
      • Contas
      • Plataforma
      • Número de conta
      • Transferências
      • Pix Internacional
      • Cross-Border (Pagamentos Internacionais)
    • Conta
      • Detalhes de uma empresa
      • Criar uma Empresa
      • /entities/person
  • Gateway (Obsoleto)
    • Autenticação
      • Recebendo um token de acesso
    • Conta
      • Dados da conta
      • Visualizar saldo na conta
    • PIX
      • Pagamento
        • Iniciando e Confirmando o PIX
        • Listando Pagamentos de PIX
        • Detalhe de um Pagamento PIX
      • Recebimento
        • Criando QRCode PIX
        • Listando QRCodes
        • Detalhe de um QRCode
        • Devolvendo PIX Recebido
        • Encontrando pix pelo EndToEndId
        • Inativando um QRCode
    • Transferências
      • Consulta conta disponível transferências
      • Transferências entre contas P2P
      • Transferências entre contas P2P por Lote
      • Transferências entre contas TED
    • Boletos
      • Retornando lista de boleto emitidos
      • Emitindo um boleto
      • Cancelando um boleto
    • Pagamentos de Títulos
      • Consulta código de barras
      • Pagamento código de barras
    • Webhook
      • Criando um webhook
      • Listando webhooks
      • Removendo webhook
    • HealthCheck
      GET
  • Core
  • Esquemas
    • bussines_entity
    • Address
  1. Embedded Bank

Autenticação

Host Base#

A Valut utiliza um único endpoint de API para todos os ambientes:
AmbienteHost
Únicohttps://api.valut.baas

Requisições#

Todas as requisições HTTP devem ser realizadas via HTTPS e incluir os cabeçalhos obrigatórios.

Autenticação via Header#

A autenticação é feita através do header:
http X-Api-Key: <YOUR_API_KEY>

Ambientes via API Key#

O ambiente (sandbox ou produção) é definido pelo prefixo da API Key:
AmbientePrefixo da API Key
Sandboxdev_
Produçãoprod_

Exemplo#

Sandbox#

bash curl https://api.valut.baas/v1/entities \ -H "X-Api-Key: dev_xxxxxxxxxxxxxxxxx"

Boas práticas#

Nunca exponha sua API Key em frontend
Utilize variáveis de ambiente
Separe chaves por ambiente
Revogue imediatamente qualquer chave comprometida
A Valut simplifica a integração utilizando um único endpoint, permitindo alternar entre ambientes apenas pela API Key.
Modificado em 2026-04-26 02:15:07
Página anterior
Guias
Próxima página
Paginação
Built with