Oi, DEV! 👋
Crie sua conta para acessar mais recursos do portal.

e-Bank pixchaverequiredfieldexceptioncampo obrigatoriojson

O campo 'Chave' é requerido mas não foi informado

Este erro ocorre quando o campo chave não é enviado no JSON da requisição. O campo 'Chave' é requerido mas não foi informado.

Atualizado em 9 de mar. de 2026, 13:29

Problema

Este erro ocorre quando o campo chave não é enviado no JSON da requisição.

O campo 'Chave' é requerido mas não foi informado.

O campo chave é obrigatório para a criação da cobrança PIX e representa a chave PIX do beneficiário que receberá o pagamento.

Quando esse campo não é informado, o servidor não consegue identificar qual chave PIX deve ser utilizada na cobrança.

Solução

Como resolver

Inclua o campo chave no JSON enviado para a API.

Exemplo de requisição correta:


{
    "testing": true,
    "beneficiario": {
        ...
    },
    "gerarQRCode": true,
    "qrCodeConfig": {
        ...
    },
    "calendario": {
        ...
    },
    "chave": "SUA_CHAVE_PIX_AQUI",
    "devedor": {
        ...
    },
    "informacoesAdicionais": [
        ...
    ],
    "solicitacaoPagador": "string",
    "tipoCobranca": "string",
    "txId": "string",
    "valor": {
        ...
    }
}

O valor informado deve ser uma chave PIX válida, por exemplo:

  • CPF
  • CNPJ
  • E-mail
  • Telefone
  • Chave aleatória
Dica: sempre valide se os campos obrigatórios estão sendo enviados antes de realizar a requisição para evitar erros de validação.

Após informar a chave PIX corretamente, tente novamente a operação.