{"templateId":"markdown","versions":[{"version":"v2026.04","label":"v2026.04","link":"/pt-br/products/payments-direct-2/user-interface/guides/handle-payment-errors","default":true,"active":true,"folderId":"7e5507fe"},{"version":"v2026.03","label":"v2026.03","link":"/pt-br/products/payments-direct-2/v2026.03/user-interface/guides/handle-payment-errors","default":false,"active":false,"folderId":"7e5507fe"},{"version":"v2025.11","label":"v2025.11","link":"/pt-br/products/payments-direct-2/v2025.11/user-interface/guides/handle-payment-errors","default":false,"active":false,"folderId":"7e5507fe"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/pt-BR/products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Tratar erros e falhas de pagamento","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"tratar-erros-e-falhas-de-pagamento","__idx":0},"children":["Tratar erros e falhas de pagamento"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use este guia quando um pagamento exibir um status de erro ou falha no ","Payments Direct UI",". Ele mostra como identificar o tipo de falha, interpretar a mensagem de erro e decidir entre tentar novamente, corrigir dados ou acionar o suporte."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para uma descrição de como os estados de falha aparecem na interface, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/user-interface/ui-payment-failures"},"children":["Erros e falhas de pagamento"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pré-requisitos","__idx":1},"children":["Pré-requisitos"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Você tem acesso ao ","Payments Direct UI","."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Um pagamento passou para um estado de erro ou falha."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-1-identificar-a-falha","__idx":2},"children":["Etapa 1: Identificar a falha"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Abra a página ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pagamentos"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Localize o pagamento que falhou na lista de pagamentos. Os pagamentos com falha exibem um indicador de status de erro."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Selecione o pagamento para abrir a visão de detalhes dele."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Anote o ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["error code"]},", a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["error description"]}," e o texto ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What you can do"]}," exibidos no painel da mensagem de erro."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-2-entender-o-motivo-da-falha","__idx":3},"children":["Etapa 2: Entender o motivo da falha"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use a descrição do erro e a tabela abaixo para entender o que causou a falha:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Motivo da falha"},"children":["Motivo da falha"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"O que significa"},"children":["O que significa"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Saldo insuficiente"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["O seu saldo disponível é menor que o valor do pagamento."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Fatura vencida"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A sua conta tem uma fatura em aberto que precisa ser quitada antes que novos pagamentos possam prosseguir."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Limite de transações atingido"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Você atingiu o número máximo de transações permitido em um período de 24 horas."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Limite de valor por transação excedido"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["O valor do pagamento excede o limite por transação da sua conta."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Beneficiário inativo"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["O beneficiário indicado no pagamento está inativo e não pode receber recursos."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Identidade incompatível"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["O ID de identidade informado não corresponde a uma identidade do tipo beneficiário."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se você vir um código de erro que não está listado aqui, anote-o e informe-o ao ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/support"},"children":["suporte técnico"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-3-agir","__idx":4},"children":["Etapa 3: Agir"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Conforme o motivo da falha, tome uma das seguintes ações:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Saldo insuficiente:"]}," deposite mais recursos na sua conta (consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/user-interface/guides/deposit-funds"},"children":["Depositar recursos"]},") e envie o pagamento novamente com uma nova cotação."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fatura vencida:"]}," quite a fatura em aberto. Depois que a fatura for liquidada, envie o pagamento novamente com uma nova cotação."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limite de transações atingido:"]}," aguarde o fim do período de 24 horas atual e envie o pagamento novamente com uma nova cotação."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limite de valor por transação excedido:"]}," repita o pagamento com um valor dentro do limite de transação da sua conta. Entre em contato com o seu representante Ripple se precisar de um limite maior."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beneficiário inativo:"]}," altere o pagamento para referenciar outro beneficiário que esteja ativo. Se o beneficiário pretendido deveria estar ativo, entre em contato com o seu representante Ripple."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identidade incompatível:"]}," confira o ID da identidade do beneficiário e reenvie com o ID correto."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Outro erro ou erro desconhecido:"]}," informe o código do erro ao ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/support"},"children":["suporte técnico"]}," para investigação."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"observações","__idx":5},"children":["Observações"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Os pagamentos que falham liberam automaticamente os recursos reservados de volta ao seu saldo disponível. Nenhuma ação manual de recuperação de recursos é necessária."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cada nova tentativa exige uma nova cotação. As cotações expiram após a janela de validade (normalmente 15 minutos) e não podem ser reutilizadas."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Se você não conseguir resolver o problema com as informações acima, entre em contato com o ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/support"},"children":["suporte técnico"]}," e informe o código de erro do pagamento que falhou."]}]}]},"headings":[{"value":"Tratar erros e falhas de pagamento","id":"tratar-erros-e-falhas-de-pagamento","depth":1},{"value":"Pré-requisitos","id":"pré-requisitos","depth":2},{"value":"Etapa 1: Identificar a falha","id":"etapa-1-identificar-a-falha","depth":2},{"value":"Etapa 2: Entender o motivo da falha","id":"etapa-2-entender-o-motivo-da-falha","depth":2},{"value":"Etapa 3: Agir","id":"etapa-3-agir","depth":2},{"value":"Observações","id":"observações","depth":2}],"frontmatter":{"title":"Tratar erros e falhas de pagamento","seo":{"title":"Tratar erros e falhas de pagamento"}},"lastModified":"2026-10-23T14:40:23.349Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/payments-direct-2/user-interface/guides/handle-payment-errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}