Erros

A requisição foi processada com sucesso.

Requisição malformada ou faltando header obrigatório.

Chave de API ausente ou inválida.

A chave não tem o escopo necessário.

O recurso não existe (ou não é do seu Merchant).

A requisição é válida mas não pode ser cumprida (ex.: método não suportado).

Excesso de requisições. Veja rate limiting.

Chave ausente, inválida, expirada ou revogada.

A chave não possui o escopo exigido (ex.: charge:write).

Falta o header Idempotency-Key (mín. 8 chars) na criação.

Método de pagamento ainda não suportado. Use pix.

O Merchant não possui chave PIX ativa para gerar o QR.

A pix_key informada não existe ou não está ativa.

Cobrança inexistente para o seu Merchant.

Falta amount no pagamento (obrigatório, exceto PIX pix_code).

PIX sem destino: informe pix_key, pix_code ou recipient.

Payout por pix_key sem end_to_end_id. Consulte a chave em POST /v1/pix/dict/lookup e reenvie o id devolvido.

O end_to_end_id enviado já foi usado, expirou (12h) ou não é seu. Consulte a chave de novo.

Já existe um payout em andamento com esse end_to_end_id. Aguarde o resultado antes de repetir.

Cota de consultas de chave PIX excedida. Consulte uma vez por pagamento; veja rate limiting.

O end_to_end_id pertence à consulta de outra chave. Use o id devolvido para a chave que está pagando.

O limite de consultas de chave PIX do Banco Central foi atingido nesta conta. As consultas ficam suspensas por alguns minutos. Não repita a chamada: cada tentativa durante o bloqueio aprofunda o limite.

TED exige o objeto recipient com a conta bancária.

Dados do pagamento inválidos (ex.: finalidade Outros sem descrição).

Pagamento inexistente para o seu Merchant.