PayZu Conta HubApoio

Catálogo de erros


Decida pelo código; a mensagem pode mudar.

Códigos

CódigoHTTPMensagem
ACCOUNT_BLOCKED_BY_PROVIDER422A conta tem um bloqueio na instituição parceira que impede esta operação até o desbloqueio.
ACCOUNT_HELD_BY_STAFF422Esta conta está retida por decisão do suporte e não pode realizar operações até a liberação.
ACCOUNT_NOT_OPERABLE412Esta conta não está ativa e não pode movimentar dinheiro.
AUTH_TOO_MANY_REQUESTS429Muitas tentativas. Tente novamente em alguns minutos.
CALLBACK_SECRET_ALREADY_ISSUED409Esta conta já tem um segredo de callback. Para trocá-lo, use a rotação.
CALLBACK_SECRET_MISSING412Gere o segredo de callback da conta antes de informar uma callbackUrl.
DEPOSIT_BLOCKED422O depósito está retido. Libere-o antes de solicitar a devolução.
DEPOSIT_INVALID_CURSOR400Cursor de depósitos inválido.
DEPOSIT_NOT_FOUND404Depósito não encontrado.
INFRACTION_NOT_FOUND404Contestação não encontrada.
PAYMENT_ABOVE_MAXIMUM422O valor excede o máximo permitido.
PAYMENT_AMOUNT_NOT_ABOVE_FEE422O valor da cobrança precisa ser maior que a tarifa de recebimento.
PAYMENT_BELOW_MINIMUM422O valor é inferior ao mínimo permitido.
PAYMENT_CREATION_IN_FLIGHT412Uma cobrança com esta referência está sendo criada agora. Repita em instantes.
PAYMENT_DISABLED403Pagamento desabilitado para esta conta.
PAYMENT_EXTERNAL_REF_MISMATCH409Já existe uma cobrança com esta referência, e os dados enviados não conferem com os dela.
PAYMENT_INVALID_CURSOR400Cursor de paginação inválido — recomece da primeira página.
PAYMENT_NOT_FOUND404Pagamento não encontrado.
PIX_DEST_NOT_AUTHORIZED_AT_PROVIDER502A consulta de chaves PIX não está autorizada para esta conta. Fale com o suporte — tentar de novo não resolve.
PIX_DEST_PIX_KEY404Não encontramos essa chave PIX. Confira se ela está correta.
PIX_DEST_THROTTLED503Muitas consultas de chave em pouco tempo. Aguarde um momento e tente de novo.
PIX_DEST_UNAVAILABLE503A consulta de chaves PIX está indisponível no momento. Tente de novo em instantes.
PIX_KEY_DEFAULT_CANNOT_BE_REMOVED422A chave padrão não pode ser removida. Defina outra como padrão antes.
PIX_KEY_DEFAULT_ON_PROVIDER422Esta chave é a padrão da conta. Defina outra chave como padrão antes de removê-la.
PIX_KEY_DOCUMENT_NOT_HOLDER400A chave de CPF ou CNPJ precisa ser o documento do titular da conta.
PIX_KEY_DUPLICATED409Esta chave já está cadastrada na conta.
PIX_KEY_NOT_FOUND404Chave PIX não encontrada.
PIX_KEY_ONLY_ACTIVE_CAN_BE_DEFAULT422Apenas chave ativa pode ser definida como padrão.
PIX_KEY_PROVIDER_REFUSED422A chave PIX foi recusada.
PIX_KEY_RANDOM_KEY_NOT_ALLOWED400Chave aleatória é gerada automaticamente e não pode ser informada.
PIX_KEY_REQUIRED400Chave é obrigatória para tipos diferentes de EVP.
PIX_KEY_TYPE_NOT_SUPPORTED_BY_PROVIDER422Não é possível criar chave PIX deste tipo nesta conta.
PROVIDER_CAPABILITY_NOT_SUPPORTED422Esta operação não está disponível para esta conta.
PROVIDER_NOT_PROVISIONED412Esta conta ainda não terminou de ser aberta.
PROVIDER_OPERATION_UNAVAILABLE422Operação indisponível para esta conta no momento.
PROVIDER_REFUSED502Esta operação foi recusada. Confira os dados enviados.
PROVIDER_UNAVAILABLE502Não houve resposta a tempo. Tente de novo em instantes.
QR_AMOUNT_DISAGREES422O valor impresso no QR code é diferente do que o banco do recebedor informa. Confirme o valor com quem cobrou.
QR_AMOUNT_MISMATCH422O valor deste QR code é diferente do que foi informado. Se o código é dinâmico, quem cobrou pode tê-lo alterado depois da leitura — leia o código de novo.
QR_AMOUNT_REQUIRED422Este QR code não fixa valor — informe quanto pagar.
QR_CRC400O código PIX está corrompido — copie novamente do recebedor.
QR_MALFORMED400Este código PIX não está num formato válido.
QR_NOT_PIX400Este código não é um QR code de PIX.
RATE_LIMIT_UNAVAILABLE503Proteção de limite indisponível. Tente novamente em instantes.
RECEIPT_MISSING_END_TO_END422Esta operação ainda não tem end-to-end, e sem ele o comprovante não prova nada. Tente de novo em alguns minutos.
RECEIPT_NOT_SETTLED422Comprovante disponível só para operação concluída.
REFUND_ABOVE_REMAINING422O valor do estorno é maior do que o que resta a devolver deste pagamento.
REFUND_ABOVE_TICKET_MAX422O valor do estorno está acima do limite por operação desta conta.
REFUND_ALREADY_REFUNDED422Este pagamento já foi estornado integralmente.
REFUND_DISABLED403Estorno desabilitado para esta conta.
REFUND_IDEMPOTENCY_KEY_REUSED409Este Idempotency-Key já foi usado por um estorno com outros dados.
REFUND_INFRACTION_OPEN422Esta cobrança tem uma contestação MED em andamento; o estorno fica indisponível até o desfecho.
REFUND_INSUFFICIENT_BALANCE422Saldo insuficiente para estornar este pagamento.
REFUND_INVALID_IDEMPOTENCY_KEY400Idempotency-Key inválido: use até 255 caracteres ASCII visíveis, sem espaço.
REFUND_IN_FLIGHT422Já existe um estorno em andamento para este pagamento. Aguarde o desfecho antes de pedir outro.
REFUND_NOT_PAID422Só é possível estornar um pagamento que foi pago.
REFUND_TED_NOT_SUPPORTED422TED recebida não aceita devolução: a devolução é uma operação do Pix e depende do identificador end-to-end, que a TED não tem.
REQUEST_UNKNOWN_QUERY_PARAM400A requisição tem um parâmetro de busca que esta rota não conhece.
SCHEMA_INVALID400A requisição contém valores inválidos.
SCHEMA_MALFORMED_BODY400O corpo da requisição não é um JSON válido.
TOKEN_INVALID401Credencial de integração inválida.
TOKEN_IP_NOT_ALLOWED403Esta credencial não pode ser usada a partir deste IP.
TOKEN_MISSING_SCOPE403Esta credencial não tem permissão para esta operação.
TOKEN_UNSUPPORTED_GRANT_TYPE400grant_type não suportado. Use client_credentials.
TRANSFER_ABOVE_TICKET_MAX422O valor excede o máximo permitido para transferência entre contas.
TRANSFER_AMBIGUOUS_DESTINATION422Esta agência e este número estão em mais de uma conta; não dá para decidir o destino.
TRANSFER_BELOW_TICKET_MIN422O valor é inferior ao mínimo permitido para transferência entre contas.
TRANSFER_DAILY_LIMIT422O limite diário de transferência desta conta foi atingido.
TRANSFER_DESTINATION404Nenhuma conta do hub tem esta agência e este número.
TRANSFER_DESTINATION_NOT_ACTIVE422A conta de destino não está ativa.
TRANSFER_DIFFERENT_PROVIDER422A conta de destino está em outra instituição; use um PIX.
TRANSFER_DISABLED403Transferência entre contas desabilitada para esta conta.
TRANSFER_IDEMPOTENCY_KEY_REUSED409Esta chave de idempotência já foi usada para outra transferência.
TRANSFER_INSUFFICIENT_BALANCE422Saldo insuficiente para esta transferência.
TRANSFER_INVALID_IDEMPOTENCY_KEY400O cabeçalho Idempotency-Key deve ter de 1 a 255 caracteres visíveis.
TRANSFER_MAIN_ACCOUNT_DESTINATION422A conta principal da PayZu não recebe transferência entre contas; para pagar a PayZu, use uma cobrança.
TRANSFER_NOT_FOUND404Transferência não encontrada.
TRANSFER_NOT_SUPPORTED422Esta conta não faz transferência entre contas.
TRANSFER_NO_DESTINATION_KEY422A conta de destino não tem chave PIX ativa para receber a transferência.
TRANSFER_NO_ORIGIN_KEY422Esta conta não tem chave PIX ativa para enviar a transferência.
TRANSFER_SAME_ACCOUNT422A conta de destino é a própria conta de origem.
WEBHOOK_DELIVERY_CALLBACK_SECRET_MISSING422A conta não tem segredo de callback; gere um antes de reenviar este aviso.
WEBHOOK_DELIVERY_DESTINATION_MISSING422Esta entrega não tem destino registrado e não pode ser reenviada.
WEBHOOK_DELIVERY_NOT_FOUND404Entrega de webhook não encontrada.
WEBHOOK_DELIVERY_PAYLOAD_PURGED422O conteúdo deste aviso foi expurgado por tempo e não pode ser reenviado.
WEBHOOK_DELIVERY_WEBHOOK_INACTIVE422O endpoint da loja está desativado; ative-o antes de reenviar.
WEBHOOK_DUPLICATED_URL409Já existe um webhook com esta URL nesta conta.
WEBHOOK_HAS_DELIVERIES409Este endpoint já recebeu eventos e não pode ser excluído. Desative-o para parar de receber — o histórico de entregas é preservado.
WEBHOOK_NOT_FOUND404Webhook não encontrado.
WITHDRAW_ABOVE_TICKET_MAX422O valor excede o máximo permitido para saque.
WITHDRAW_BELOW_TICKET_MIN422O valor é inferior ao mínimo permitido para saque.
WITHDRAW_DAILY_LIMIT422O limite diário de saque desta conta foi atingido.
WITHDRAW_DISABLED403Saque desabilitado para esta conta.
WITHDRAW_IDEMPOTENCY_KEY_REUSED409Este Idempotency-Key já foi usado por um saque com outros dados.
WITHDRAW_INSUFFICIENT_BALANCE422Saldo insuficiente para este saque.
WITHDRAW_INSUFFICIENT_PROVIDER_BALANCE422O saldo desta conta não cobre este saque agora.
WITHDRAW_INVALID_IDEMPOTENCY_KEY400O cabeçalho Idempotency-Key deve ter de 1 a 255 caracteres visíveis.
WITHDRAW_INVALID_PIX_KEY400A chave PIX é inválida: CPF ou CNPJ com dígito verificador errado, ou 11 dígitos que não são CPF nem celular com DDD.
WITHDRAW_NOT_FOUND404Saque não encontrado.
WITHDRAW_PIX_KEY_REFUSED_BY_PROVIDER422A chave PIX de destino foi recusada.
WITHDRAW_PIX_KEY_TYPE_MISMATCH400O tipo informado não corresponde ao formato da chave PIX.
WITHDRAW_UNRECOGNIZED_PIX_KEY422A chave PIX informada não corresponde a nenhum formato válido.