PayZu Conta HubApoio
Catálogo de erros
Decida pelo código; a mensagem pode mudar.
Códigos
| Código | HTTP | Mensagem |
|---|---|---|
ACCOUNT_BLOCKED_BY_PROVIDER | 422 | A conta tem um bloqueio na instituição parceira que impede esta operação até o desbloqueio. |
ACCOUNT_HELD_BY_STAFF | 422 | Esta conta está retida por decisão do suporte e não pode realizar operações até a liberação. |
ACCOUNT_NOT_OPERABLE | 412 | Esta conta não está ativa e não pode movimentar dinheiro. |
AUTH_TOO_MANY_REQUESTS | 429 | Muitas tentativas. Tente novamente em alguns minutos. |
CALLBACK_SECRET_ALREADY_ISSUED | 409 | Esta conta já tem um segredo de callback. Para trocá-lo, use a rotação. |
CALLBACK_SECRET_MISSING | 412 | Gere o segredo de callback da conta antes de informar uma callbackUrl. |
DEPOSIT_BLOCKED | 422 | O depósito está retido. Libere-o antes de solicitar a devolução. |
DEPOSIT_INVALID_CURSOR | 400 | Cursor de depósitos inválido. |
DEPOSIT_NOT_FOUND | 404 | Depósito não encontrado. |
INFRACTION_NOT_FOUND | 404 | Contestação não encontrada. |
PAYMENT_ABOVE_MAXIMUM | 422 | O valor excede o máximo permitido. |
PAYMENT_AMOUNT_NOT_ABOVE_FEE | 422 | O valor da cobrança precisa ser maior que a tarifa de recebimento. |
PAYMENT_BELOW_MINIMUM | 422 | O valor é inferior ao mínimo permitido. |
PAYMENT_CREATION_IN_FLIGHT | 412 | Uma cobrança com esta referência está sendo criada agora. Repita em instantes. |
PAYMENT_DISABLED | 403 | Pagamento desabilitado para esta conta. |
PAYMENT_EXTERNAL_REF_MISMATCH | 409 | Já existe uma cobrança com esta referência, e os dados enviados não conferem com os dela. |
PAYMENT_INVALID_CURSOR | 400 | Cursor de paginação inválido — recomece da primeira página. |
PAYMENT_NOT_FOUND | 404 | Pagamento não encontrado. |
PIX_DEST_NOT_AUTHORIZED_AT_PROVIDER | 502 | A consulta de chaves PIX não está autorizada para esta conta. Fale com o suporte — tentar de novo não resolve. |
PIX_DEST_PIX_KEY | 404 | Não encontramos essa chave PIX. Confira se ela está correta. |
PIX_DEST_THROTTLED | 503 | Muitas consultas de chave em pouco tempo. Aguarde um momento e tente de novo. |
PIX_DEST_UNAVAILABLE | 503 | A consulta de chaves PIX está indisponível no momento. Tente de novo em instantes. |
PIX_KEY_DEFAULT_CANNOT_BE_REMOVED | 422 | A chave padrão não pode ser removida. Defina outra como padrão antes. |
PIX_KEY_DEFAULT_ON_PROVIDER | 422 | Esta chave é a padrão da conta. Defina outra chave como padrão antes de removê-la. |
PIX_KEY_DOCUMENT_NOT_HOLDER | 400 | A chave de CPF ou CNPJ precisa ser o documento do titular da conta. |
PIX_KEY_DUPLICATED | 409 | Esta chave já está cadastrada na conta. |
PIX_KEY_NOT_FOUND | 404 | Chave PIX não encontrada. |
PIX_KEY_ONLY_ACTIVE_CAN_BE_DEFAULT | 422 | Apenas chave ativa pode ser definida como padrão. |
PIX_KEY_PROVIDER_REFUSED | 422 | A chave PIX foi recusada. |
PIX_KEY_RANDOM_KEY_NOT_ALLOWED | 400 | Chave aleatória é gerada automaticamente e não pode ser informada. |
PIX_KEY_REQUIRED | 400 | Chave é obrigatória para tipos diferentes de EVP. |
PIX_KEY_TYPE_NOT_SUPPORTED_BY_PROVIDER | 422 | Não é possível criar chave PIX deste tipo nesta conta. |
PROVIDER_CAPABILITY_NOT_SUPPORTED | 422 | Esta operação não está disponível para esta conta. |
PROVIDER_NOT_PROVISIONED | 412 | Esta conta ainda não terminou de ser aberta. |
PROVIDER_OPERATION_UNAVAILABLE | 422 | Operação indisponível para esta conta no momento. |
PROVIDER_REFUSED | 502 | Esta operação foi recusada. Confira os dados enviados. |
PROVIDER_UNAVAILABLE | 502 | Não houve resposta a tempo. Tente de novo em instantes. |
QR_AMOUNT_DISAGREES | 422 | O valor impresso no QR code é diferente do que o banco do recebedor informa. Confirme o valor com quem cobrou. |
QR_AMOUNT_MISMATCH | 422 | O 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_REQUIRED | 422 | Este QR code não fixa valor — informe quanto pagar. |
QR_CRC | 400 | O código PIX está corrompido — copie novamente do recebedor. |
QR_MALFORMED | 400 | Este código PIX não está num formato válido. |
QR_NOT_PIX | 400 | Este código não é um QR code de PIX. |
RATE_LIMIT_UNAVAILABLE | 503 | Proteção de limite indisponível. Tente novamente em instantes. |
RECEIPT_MISSING_END_TO_END | 422 | Esta 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_SETTLED | 422 | Comprovante disponível só para operação concluída. |
REFUND_ABOVE_REMAINING | 422 | O valor do estorno é maior do que o que resta a devolver deste pagamento. |
REFUND_ABOVE_TICKET_MAX | 422 | O valor do estorno está acima do limite por operação desta conta. |
REFUND_ALREADY_REFUNDED | 422 | Este pagamento já foi estornado integralmente. |
REFUND_DISABLED | 403 | Estorno desabilitado para esta conta. |
REFUND_IDEMPOTENCY_KEY_REUSED | 409 | Este Idempotency-Key já foi usado por um estorno com outros dados. |
REFUND_INFRACTION_OPEN | 422 | Esta cobrança tem uma contestação MED em andamento; o estorno fica indisponível até o desfecho. |
REFUND_INSUFFICIENT_BALANCE | 422 | Saldo insuficiente para estornar este pagamento. |
REFUND_INVALID_IDEMPOTENCY_KEY | 400 | Idempotency-Key inválido: use até 255 caracteres ASCII visíveis, sem espaço. |
REFUND_IN_FLIGHT | 422 | Já existe um estorno em andamento para este pagamento. Aguarde o desfecho antes de pedir outro. |
REFUND_NOT_PAID | 422 | Só é possível estornar um pagamento que foi pago. |
REFUND_TED_NOT_SUPPORTED | 422 | TED 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_PARAM | 400 | A requisição tem um parâmetro de busca que esta rota não conhece. |
SCHEMA_INVALID | 400 | A requisição contém valores inválidos. |
SCHEMA_MALFORMED_BODY | 400 | O corpo da requisição não é um JSON válido. |
TOKEN_INVALID | 401 | Credencial de integração inválida. |
TOKEN_IP_NOT_ALLOWED | 403 | Esta credencial não pode ser usada a partir deste IP. |
TOKEN_MISSING_SCOPE | 403 | Esta credencial não tem permissão para esta operação. |
TOKEN_UNSUPPORTED_GRANT_TYPE | 400 | grant_type não suportado. Use client_credentials. |
TRANSFER_ABOVE_TICKET_MAX | 422 | O valor excede o máximo permitido para transferência entre contas. |
TRANSFER_AMBIGUOUS_DESTINATION | 422 | Esta agência e este número estão em mais de uma conta; não dá para decidir o destino. |
TRANSFER_BELOW_TICKET_MIN | 422 | O valor é inferior ao mínimo permitido para transferência entre contas. |
TRANSFER_DAILY_LIMIT | 422 | O limite diário de transferência desta conta foi atingido. |
TRANSFER_DESTINATION | 404 | Nenhuma conta do hub tem esta agência e este número. |
TRANSFER_DESTINATION_NOT_ACTIVE | 422 | A conta de destino não está ativa. |
TRANSFER_DIFFERENT_PROVIDER | 422 | A conta de destino está em outra instituição; use um PIX. |
TRANSFER_DISABLED | 403 | Transferência entre contas desabilitada para esta conta. |
TRANSFER_IDEMPOTENCY_KEY_REUSED | 409 | Esta chave de idempotência já foi usada para outra transferência. |
TRANSFER_INSUFFICIENT_BALANCE | 422 | Saldo insuficiente para esta transferência. |
TRANSFER_INVALID_IDEMPOTENCY_KEY | 400 | O cabeçalho Idempotency-Key deve ter de 1 a 255 caracteres visíveis. |
TRANSFER_MAIN_ACCOUNT_DESTINATION | 422 | A conta principal da PayZu não recebe transferência entre contas; para pagar a PayZu, use uma cobrança. |
TRANSFER_NOT_FOUND | 404 | Transferência não encontrada. |
TRANSFER_NOT_SUPPORTED | 422 | Esta conta não faz transferência entre contas. |
TRANSFER_NO_DESTINATION_KEY | 422 | A conta de destino não tem chave PIX ativa para receber a transferência. |
TRANSFER_NO_ORIGIN_KEY | 422 | Esta conta não tem chave PIX ativa para enviar a transferência. |
TRANSFER_SAME_ACCOUNT | 422 | A conta de destino é a própria conta de origem. |
WEBHOOK_DELIVERY_CALLBACK_SECRET_MISSING | 422 | A conta não tem segredo de callback; gere um antes de reenviar este aviso. |
WEBHOOK_DELIVERY_DESTINATION_MISSING | 422 | Esta entrega não tem destino registrado e não pode ser reenviada. |
WEBHOOK_DELIVERY_NOT_FOUND | 404 | Entrega de webhook não encontrada. |
WEBHOOK_DELIVERY_PAYLOAD_PURGED | 422 | O conteúdo deste aviso foi expurgado por tempo e não pode ser reenviado. |
WEBHOOK_DELIVERY_WEBHOOK_INACTIVE | 422 | O endpoint da loja está desativado; ative-o antes de reenviar. |
WEBHOOK_DUPLICATED_URL | 409 | Já existe um webhook com esta URL nesta conta. |
WEBHOOK_HAS_DELIVERIES | 409 | Este 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_FOUND | 404 | Webhook não encontrado. |
WITHDRAW_ABOVE_TICKET_MAX | 422 | O valor excede o máximo permitido para saque. |
WITHDRAW_BELOW_TICKET_MIN | 422 | O valor é inferior ao mínimo permitido para saque. |
WITHDRAW_DAILY_LIMIT | 422 | O limite diário de saque desta conta foi atingido. |
WITHDRAW_DISABLED | 403 | Saque desabilitado para esta conta. |
WITHDRAW_IDEMPOTENCY_KEY_REUSED | 409 | Este Idempotency-Key já foi usado por um saque com outros dados. |
WITHDRAW_INSUFFICIENT_BALANCE | 422 | Saldo insuficiente para este saque. |
WITHDRAW_INSUFFICIENT_PROVIDER_BALANCE | 422 | O saldo desta conta não cobre este saque agora. |
WITHDRAW_INVALID_IDEMPOTENCY_KEY | 400 | O cabeçalho Idempotency-Key deve ter de 1 a 255 caracteres visíveis. |
WITHDRAW_INVALID_PIX_KEY | 400 | A 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_FOUND | 404 | Saque não encontrado. |
WITHDRAW_PIX_KEY_REFUSED_BY_PROVIDER | 422 | A chave PIX de destino foi recusada. |
WITHDRAW_PIX_KEY_TYPE_MISMATCH | 400 | O tipo informado não corresponde ao formato da chave PIX. |
WITHDRAW_UNRECOGNIZED_PIX_KEY | 422 | A chave PIX informada não corresponde a nenhum formato válido. |