Recursos para IA
Possíveis erros
Consulte a lista de possíveis erros retornados pela API de Orders e como corrigi-los.
| Tipo de erro | Status | Código | Descrição e possíveis soluções |
| Erro de solicitação | 400 | json_syntax_error | Certifique-se de que a solicitação tenha uma estrutura JSON válida, com chaves e valores adequados. |
| Erro de solicitação | 400 | required_properties | Algumas propriedades obrigatórias estão ausentes. Verifique a solicitação e certifique-se de incluir todas as propriedades requeridas conforme a documentação da API. |
| Erro de solicitação | 400 | unsupported_properties | Algumas propriedades informadas não são suportadas pela API. Revise a solicitação e remova ou corrija as propriedades não suportadas. |
| Erro de solicitação | 400 | minimum_properties | O número mínimo de propriedades requeridas não foi atendido. Adicione as propriedades necessárias para completar a solicitação. |
| Erro de solicitação | 400 | property_type | O tipo da propriedade informada é inválido. Certifique-se de que o valor enviado na solicitação corresponda ao tipo esperado. |
| Erro de solicitação | 400 | property_value | O valor da propriedade informada é inválido. Verifique o valor enviado e faça os ajustes para que corresponda aos valores permitidos. |
| Erro de solicitação | 400 | maximum_items | O número máximo de itens permitidos foi excedido. Reduza a quantidade de itens enviados para que não ultrapasse o máximo permitido. |
| Erro de solicitação | 400 | minimum_items | O número mínimo de itens requerido não foi atendido. Adicione mais itens à solicitação para cumprir com os requisitos da API. |
| Erro de solicitação | 400 | invalid_path_param | Verifique se o ID fornecido como parâmetro é válido. |
| Erro de solicitação | 400 | invalid_properties | Algumas propriedades informadas são inválidas ou estão mal formadas. Revise as propriedades enviadas e verifique se estão de acordo com as especificações da API. |
| Erro de solicitação | 400 | empty_required_header | Um ou mais headers obrigatórios estão vazios. Verifique a solicitação e certifique-se de que todos os headers requeridos estão presentes e devidamente preenchidos. |
| Erro de solicitação | 400 | invalid_idempotency_key_length | O valor enviado no header X-Idempotency-Key excedeu o tamanho máximo permitido. O header aceita valores entre 1 e 64 caracteres. |
| Erro de solicitação | 400 | order_builder_without_transactions | Não há uma transação associada à order. Certifique-se de incluir pelo menos uma transação para a criação da order. |
| Erro de solicitação | 400 | invalid_order_mode_for_operation | O modo informado não é válido para esta operação. Verifique se você está utilizando o modo correto conforme a operação desejada. |
| Erro de solicitação | 400 | invalid_order_type | O tipo da order é inválido. Verifique se o tipo utilizado é válido para a operação. |
| Erro de solicitação | 400 | invalid_transaction_id | O ID da transação é inválido. Certifique-se de que o ID está correto. |
| Erro de solicitação | 400 | exceeded_number_of_transactions | Ocorreu um erro na solicitação. A Order aceita no máximo uma transação. Remova as transações excedentes. |
| Erro de solicitação | 400 | invalid_email_for_sandbox | O formato de e-mail não é válido para o ambiente de sandbox, deve conter "@testuser.com". |
| Erro de solicitação | 400 | order_invalid_sponsor_id | O identificador do patrocinador da order é inválido. Certifique-se de que o ID esteja correto. |
| Erro de solicitação | 400 | invalid_header_value | Identificador do chamador (caller_id) não encontrado. Certifique-se de que o ID esteja correto. |
| Erro de solicitação | 401 | 401 | O valor enviado como Access Token está incorreto. Por favor, verifique-o e tente novamente enviando o valor correto. |
| Erro de solicitação | 401 | invalid_credentials | Não há suporte para credenciais de teste. Use usuários de teste com credenciais de produção para o ambiente de teste (sandbox) e suas credenciais de produção para o ambiente de produção. |
| Erro de processamento | 402 | failed | Houve um erro no processamento de alguma das transações. Verifique a mensagem retornada para mais informações. |
| Erro de solicitação | 404 | order_not_found | A order não foi encontrada. Verifique se o ID informado está correto. |
| Erro de solicitação | 404 | transaction_not_found | A transação não foi encontrada. Verifique se o ID informado está correto. |
| Erro de solicitação | 409 | cannot_refund_order | Certifique-se de que a order esteja em um estado que permita a realização de um reembolso. |
| Erro de solicitação | 409 | cannot_capture_order | Verifique se o estado da order permite a captura e se ela foi criada com o campo processing_mode definido como automatic. |
| Erro de solicitação | 409 | cannot_cancel_order | Certifique-se de que a order esteja em um estado que permita seu cancelamento. |
| Erro de idempotência | 409 | idempotency_key_already_used | A chave X-Idempotency-Key fornecida já foi utilizada. Cada chave de idempotência deve ser única para garantir que a operação seja realizada apenas uma vez. Utilize uma nova chave para a próxima solicitação. |
| Erro de solicitação | 409 | operation_not_supported | A operação solicitada não é suportada. Verifique se a operação que você está tentando realizar é válida para o contexto atual. |
| Erro de solicitação | 409 | order_already_refunded | A order informada já foi reembolsada. Não é possível processar um reembolso em uma order que já possui este status. |
| Erro de solicitação | 409 | order_already_canceled | A order informada já foi cancelada. Não é possível realizar operações em uma order que já se encontra cancelada. |
| Erro de solicitação | 409 | order_refund_already_in_process | Já existe uma solicitação de reembolso completo em processo para a order em questão. |
| Erro de idempotência | 423 | resource_locked | A chave de idempotência está temporariamente bloqueada. Aguarde alguns instantes e tente executar a solicitação novamente. |
| Erro de idempotência | 500 | idempotency_validation_failed | Ocorreu um erro interno no servidor. Tente reenviar a solicitação com uma chave de idempotência nova e única para evitar conflitos. Se o problema persistir, entre em contato com o Suporte e forneça o x-request-id junto com mais detalhes sobre a operação realizada. |
| Erro da API | 500 | internal_error | Ocorreu um erro interno no servidor. Por favor, tente novamente mais tarde. Se o problema persistir, entre em contato com o Suporte e forneça o x-request-id junto com mais detalhes sobre a operação realizada. |
| Erro de solicitação | 400 | invalid_sequence_control | Não é possível criar o pagamento enviando a informação do nó automatic_payments.subscription.sequence utilizando um perfil de pagamento com sequence_control definido como AUTO. O valor deste campo deve ser definido como MANUAL para enviar a informação relativa à recorrência. Acesse Gerenciar pagamentos com recorrência programada para mais informações. |
| Erro de solicitação | 400 | invalid_payment_methods | O perfil de pagamento sendo utilizado para criar a order não tem meios de pagamento associados, ou tem dois cartões e a order está sendo processada com o modo síncrono, o que não é permitido. Revise sua configuração para tentar novamente. |
| Erro de solicitação | 400 | invalid_capture_mode | A order tem a lógica de retentativas configurada, mas o modo de processamento está definido como automatic. O campo retries só será permitido se processing_mode=automatic_async tiver sido definido. |
| Erro de solicitação | 400 | invalid_payment_method_list | O perfil de pagamento sendo utilizado para criar a order tem mais de dois meios de pagamento associados, que é a quantidade máxima permitida. Revise sua configuração para tentar novamente. |
| Erro de solicitação | 400 | invalid_application_id | O identificador da aplicação sendo utilizada para executar a solicitação está incorreto ou não está autorizado. Verifique se você está enviando a informação correta. |
| Erro de solicitação | 400 | profile_not_found | O perfil de pagamento sendo utilizado para criar o pagamento não existe ou é inválido. Verifique se você enviou o valor correto e tente novamente. |
| Erro de solicitação | 400 | invalid_profile_status | Você está tentando criar a order utilizando um perfil de pagamento com um status que não permite. Só é possível criar pagamentos com perfis de pagamento com status=READY. Verifique o status do perfil utilizando a API de Perfis. |
| Erro de solicitação | 400 | invalid_customer_id | O identificador do cliente enviado na solicitação não corresponde ao do perfil de pagamento. Verifique se você enviou os valores corretos em ambos os casos. |
| Erro de solicitação | 400 | invalid_collector_with_application_fee | Deve ser enviado um application_fee maior que 1 para que a solicitação esteja correta. |
| Erro de solicitação | 404 | profile_not_found | O perfil de pagamento sendo utilizado para criar o pagamento não foi encontrado. Verifique se você enviou o valor correto e tente novamente. |
| Erro de solicitação | 400 | profile_id_must_be_informed | O identificador do perfil não foi enviado, o que é obrigatório nos casos em que sequence_control.reason=recurring. |
| Erro de solicitação | 400 | invalid_intent_status | Não é possível reembolsar a order em seu estado atual. Certifique-se de que a order esteja em um estado que permita a realização de um reembolso. |
| Erro de solicitação | 400 | invalid_refund_amount | Não é possível reembolsar o valor definido na solicitação. Certifique-se de ter enviado o valor correto. |
| Erro de solicitação | 400 | refund_error | Houve um erro ao tentar processar o reembolso. Aguarde um momento e tente novamente. |
| Erro de solicitação | 400 | invalid_refund | Você está tentando reembolsar um pagamento que não permite. Certifique-se de cumprir com as condições para criar um reembolso e tente novamente. |
| Erro da API | 424 | error_dependency | Ocorreu um erro interno. Aguarde um momento e tente novamente. |