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. |
canceled | - | Quando se realiza um cancelamento que corresponde aos payouts que se encontram programados ou agendados e são executados pelo endpoint de Cancelar uma transação. |
created | - | Um payout (lote) foi criado. |
error | failed | Quando ocorre um erro no processo da transação e não se consegue creditar o valor na conta de destino. Veja aqui mais informações sobre as mensagens retornadas. |
processed | approved | O processamento da transação foi bem-sucedido. |
refunded | refunded | A transação foi totalmente reembolsada pelo banco de destino. |
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. |
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. |
Mensagens de erros de transação
Quando uma transação apresenta error, o campo status_detail indicará uma falha e conterá uma mensagem amigável que descreverá a causa do erro. Abaixo estão listadas as possíveis mensagens.
| Mensagem |
| A conta do pagador não possui fundos suficientes para completar esta transação. Verifique o saldo da conta e tente novamente. |
| Não foi possível processar a transação. Ocorreu um erro ao reservar os fundos. Por favor, tente novamente mais tarde ou entre em contato com o suporte. |
| Conta TED não encontrada ou inativa. Verifique as informações da conta e tente novamente. |
| Não foi possível processar a transação. Ocorreu um erro ao processar os dados da transferência. Por favor, tente novamente mais tarde ou entre em contato com o suporte. |
| A transação foi rejeitada. Verifique os detalhes da transação e tente novamente. Se o problema persistir, entre em contato com o suporte. |
| Não foi possível processar a transação. Ocorreu um erro interno. Por favor, tente novamente mais tarde ou entre em contato com o suporte. |
| Recurso não encontrado. Verifique os detalhes da transação e tente novamente. |
| Formato de data inválido. Verifique os campos de data na sua requisição. |
| Não foi possível obter informações bancárias. Verifique os dados da conta bancária e tente novamente. |
| Informações de usuário inválidas. Verifique os IDs de usuário em sua requisição. |
| Estamos temporariamente impossibilitados de exibir o status desta transferência. Isso não significa que a transferência falhou. Por favor, atualize a página em alguns instantes ou entre em contato com o suporte. |
| Serviço temporariamente indisponível. Por favor, tente novamente mais tarde. |
| Ocorreu um erro inesperado. Por favor, entre em contato com o suporte para obter assistência. |
Aqui você pode encontrar os possíveis erros que podem ocorrer ao realizar uma solicitação de payout, juntamente com suas descrições e possíveis soluções.
| 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 | 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 | 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. |