Recursos para IA
Principais status e possíveis erros
Veja abaixo os principais status de uma transação e os possíveis erros de requisição.
Após a criação exitosa do payout, são geradas as transações, que correspondem às transações enviadas no body da solicitação. Quando se cria uma transação, ou quando consulta informações relativas a ela, as respostas retornarão os campos que permitirão conhecer o status em que ela se encontra.
status: este campo fornecerá informações sobre o estado atual do processamento.status_detail: este campo é encontrado como atributo detransaction.to.accounts, e trará informações sobre os motivos ou detalhes que resultaram nesse status.
Veja abaixo todos os status pelos quais uma transação pode passar durante seu processamento.
status | status_detail | Descrição |
approved | - | Uma transação foi criada, mas ainda não foi processada. É um status intermediário. |
approved | partially_refunded | A transação foi parcialmente reembolsada pelo banco de destino. |
error | failed | Quando ocorre um erro no processo da transação e não se consegue creditar o valor na conta de destino. |
processed | approved | O processamento da transação foi bem-sucedido. |
rejected | by_bank | A transação foi rejeitada pelo banco de destino. Execute novamente a solicitação. |
rejected | by_provider | A transação foi rejeitada pelo provedor. Execute novamente a solicitação. |
rejected | high_risk | A transação é rejeitada devido ao risco de fraude. Execute novamente a solicitação. |
rejected | insufficient_funds | A transação foi rejeitada devido a fundos insuficientes na conta de origem. Execute novamente a solicitação. |
rejected | other_reason | A transação foi rejeitada por padrão devido a problemas internos durante o processamento. Execute novamente a solicitação. |
rejected | review_manual | A transação é rejeitada e enviada para análise de prevenção de fraudes. Execute novamente a solicitação. |
refunded | refunded | A transação foi totalmente reembolsada pelo banco de destino. |
success | accredited | A transação encontra-se creditada na conta de destino. |
success | in_progress | A creditação da transação está em processo, ainda não está na conta de destino. |
transaction_in_process | pending_authorized | A transação está em andamento, com status final pendente e aguardando autorização. |
transaction_in_process | pending_bank | O banco de destino não respondeu, portanto, a transação está pendente de um estado final. |
Caso haja um erro de requisição, será retornado um erro indicando o problema que deverá ser resolvido e, após isso, o processo deverá ser realizado novamente.
| Tipo de Erro | Status | Código | Descrição e soluções possíveis |
| Erro de requisição | 400 | invalid_payout_id | Dados inválidos foram enviados no body da requisição. O payout não foi encontrado. Tente enviar a solicitação novamente, validando todos os campos. |
| Erro de requisição | 400 | invalid_transaction_id | Dados inválidos foram enviados no body da requisição. A transação não foi encontrada. Tente enviar a solicitação novamente, validando todos os campos. |
| Erro de requisição | 400 | invalid_signature | Dados inválidos foram enviados no body da requisição. Verifique se a secret foi gerada corretamente e está registrada com o Mercado Pago. Verifique também se o body que se está enviando é o que foi criptografado. Para mais informações, acesse Criptografia de segurança. |
| Erro de requisição | 400 | idempotency_key_required | Dados inválidos foram enviados no body da requisição. O header X-Idempotency-Key está ausente. Tente enviar a solicitação novamente, validando todos os campos. |
| Erro de requisição | 400 | invalid_chave | O valor do campo transaction.to.accounts[0].chave.value é inválido. Verifique se o valor da chave Pix está correto. |
| Erro de requisição | 400 | invalid_chave_type | O valor do campo transaction.to.accounts[0].chave.type é inválido. Verifique se o tipo de chave Pix está correto. |
| Erro de requisição | 400 | invalid_chave_pix | A chave Pix é inválida. Verifique o valor digitado. |
| Erro de requisição | 400 | chave_not_found | A chave Pix não foi encontrada. Verifique o valor digitado. |
| Erro de requisição | 400 | unsupported_chave | A chave Pix não está cadastrada no Bacen. |
| Erro de requisição | 400 | chave_has_different_owner | O valor da chave Pix não corresponde às informações do proprietário. |
| Erro de requisição | 400 | unrecognized_key_format | O formato da chave Pix é inválido. Confirme os valores possíveis. |
| Erro de requisição | 400 | invalid_identity_source | O header X-Identity-Source suporta apenas dict ou ted. |
| Erro de requisição | 400 | key_PSP_error | Tentativa de consultar uma chave PSP externa que já está cadastrada no Mercado Pago. |
| Erro de requisição | 400 | invalid_payload | Payload inválido. Verifique o formato da requisição. |
| Erro de requisição | 400 | rate_limit | O serviço de consulta atingiu o limite de rpm para não ultrapassar o limite permitido pelo Bacen e não receber multas. |
| Erro de requisição | 400 | invalid_external_reference | Valor inválido para o campo external_reference. Verifique os valores permitidos para esse campo. |
| Erro de requisição | 400 | invalid_type_point_of_interaction | Valor inválido para o campo point_of_interaction.type. Lembre-se que é um valor fixo, sempre {"type":"PSP_TRANSFER"}. |
| Erro de requisição | 400 | invalid_amount | Valor inválido para o campo transaction.from.accounts[0].amount. Verifique os valores permitidos para a transação. |
| Erro de requisição | 400 | invalid_identification_number | Valor inválido para o campo transaction.to.accounts[0].identification.number. Verifique os valores permitidos. |
| Erro de requisição | 400 | invalid_identification_type | Valor inválido para o campo transaction.to.accounts[0].owner.identification.type. Verifique os valores permitidos. |
| Erro de requisição | 400 | account_is_disabled | A conta do Mercado Pago está desativada. |
| Erro de requisição | 400 | participant_is_not_available | O participante não está habilitado para o fluxo transacional. |
| Erro de requisição | 400 | flow_not_specified | O header X-Flow-id suporta apenas transfer ou management. |
| Erro de requisição | 400 | compliance_not_processed | A verificação de conformidade não foi concluída para o usuário. |
| Erro de requisição | 400 | invalid_body | O body da requisição tem um formato inválido. Verifique o formato da requisição. |
| Erro de requisição | 400 | client_not_allowed | O client_id associado às credenciais não tem permissão para fazer a requisição. |
| Erro de requisição | 400 | financial_identity_not_found | A instituição financeira não foi localizada. Verifique o campo to.accounts.bank_id. |
| Erro de requisição | 400 | many_requests | Muitas requisições foram feitas. Aguarde e tente novamente. |
| Erro de requisição | 400 | unauthorized | A requisição não está autorizada. |
| Erro de requisição | 400 | id_format_invalid | O formato do ID enviado no path da requisição é inválido. Verifique o ID da transação ou do payout. |
| Erro de requisição | 401 | invalid_token | O valor enviado como Access Token está incorreto. Verifique e tente enviar a requisição novamente com o valor correto. |
| Erro de requisição | 403 | forbidden | Sem permissão para acessar o recurso. Verifique se o Access Token enviado possui as permissões necessárias. |
| Erro de requisição | 404 | not_found | O recurso solicitado não foi encontrado ou o valor enviado para identificá-lo é inexistente. Valide as informações enviadas nos parâmetros e tente realizar a requisição novamente. |
| Erro de requisição | 412 | precondition_failed | O status da transação não permite o seu cancelamento. Apenas transações com status pending ou in_process podem ser canceladas. |
| Erro da API | 424 | resource_locked | O serviço de rate limit está processando o consumo de nossa API pelo integrador. Aguarde e tente novamente. |
| Erro da API | 500 | internal_server_error | Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente. Se o problema persistir, acione o suporte. |
| Erro da API | 502 | bad_gateway | Ocorreu um erro na integração com um serviço externo. Tente enviar a requisição novamente. Se o problema persistir, acione o suporte. |