{"templateId":"markdown","versions":[{"version":"v2026.04","label":"v2026.04","link":"/pt-br/products/payments-direct-2/api-docs/error-handling/api-payment-failures","default":true,"active":true,"folderId":"7e5507fe"},{"version":"v2026.03","label":"v2026.03","link":"/pt-br/products/payments-direct-2/v2026.03/api-docs/error-handling/api-payment-failures","default":false,"active":false,"folderId":"7e5507fe"},{"version":"v2025.11","label":"v2025.11","link":"/pt-br/products/payments-direct-2/v2025.11/api-docs/error-handling/api-payment-failures","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":"Falhas de pagamento da API","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":"falhas-de-pagamento-da-api","__idx":0},"children":["Falhas de pagamento da API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As falhas de pagamento são uma classe especial de erros que ocorrem apenas depois que um pagamento é criado."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Elas exigem que você investigue e resolva a condição subjacente antes de tentar novamente."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As causas mais comuns incluem:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Saldo insuficiente"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Limites de crédito ou de transação excedidos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Faturas vencidas"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Dados da conta do beneficiário inválidos ou inativos"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tabela-de-códigos-de-falha-de-pagamento","__idx":1},"children":["Tabela de códigos de falha de pagamento"]},{"$$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":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Título"},"children":["Título"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_062"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Limite de transações atingido"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque você já fez o número máximo de transações em um período de 24 horas. Tente novamente mais tarde."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["402"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_064"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Limite de crédito atingido"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque você já atingiu o seu limite de crédito."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["402"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_066"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fatura vencida"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque você tem uma fatura vencida. Se você já enviou uma confirmação de pagamento, tente novamente mais tarde ou entre em contato com o suporte técnico da Ripple."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["402"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_067"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Saldo insuficiente"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou por saldo insuficiente. Adicione fundos à sua conta e tente novamente."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["402"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_151"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Informações de identidade inválidas"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou devido a um ou mais erros nos dados da identidade do beneficiário. Crie uma nova identidade de beneficiário com valores válidos e tente novamente."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_152"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Informações conflitantes de nome do beneficiário"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque os campos Cdtr.Nm e Cdtr.StrdNm estão ambos preenchidos nas informações de identidade do beneficiário. Apenas um desses campos deve estar presente. Se o beneficiário for uma instituição, especifique apenas Cdtr.Nm. Se o beneficiário for uma pessoa física, especifique apenas Cdtr.StrdNm."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_166"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de conta incorreto"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque o número de conta que você informou não corresponde ao número de conta do beneficiário."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_169"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Não foi possível encontrar o destino do pagamento"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque a conta do beneficiário que você especificou não pôde ser encontrada. Tente novamente com informações válidas do beneficiário."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_171"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Formato de dados da requisição incorreto"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque um ou mais campos da requisição contêm dados com formato incorreto. Tente novamente com parâmetros de requisição corretamente formatados."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_172"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conta do beneficiário inativa"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque a conta do beneficiário que você especificou para este pagamento está inativa. Tente novamente com uma conta de beneficiário válida e ativa."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_173"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Informações conflitantes de nome do beneficiário"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque os campos Cdtr.Nm e Cdtr.StrdNm estão ambos preenchidos nas informações de identidade do beneficiário. Apenas um desses campos deve estar presente. Se o beneficiário for uma instituição, especifique apenas Cdtr.Nm. Se o beneficiário for uma pessoa física, especifique apenas Cdtr.StrdNm."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_201"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Limite de transações atingido"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque você já fez o número máximo de transações em um período de 24 horas. Tente novamente mais tarde."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_203"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Crédito insuficiente"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque o valor do pagamento excede o seu crédito disponível. Se você pagou uma fatura recentemente, o seu crédito disponível pode ainda não refletir esse pagamento."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_204"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fatura vencida"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque você tem uma fatura vencida. Se você já enviou uma confirmação de pagamento, tente novamente mais tarde ou entre em contato com o suporte técnico da Ripple."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_205"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Saldo insuficiente"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou por saldo insuficiente. Adicione fundos à sua conta e tente novamente."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USR_206"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USER_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transações de débito direto pendentes em excesso"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento falhou porque você tem transações de débito direto pendentes em excesso. Tente novamente depois que algumas das transações pendentes forem concluídas."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]}]}]}]}]},"headings":[{"value":"Falhas de pagamento da API","id":"falhas-de-pagamento-da-api","depth":1},{"value":"Tabela de códigos de falha de pagamento","id":"tabela-de-códigos-de-falha-de-pagamento","depth":2}],"frontmatter":{"seo":{"title":"Falhas de pagamento da API"}},"lastModified":"2026-10-21T01:29:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/payments-direct-2/api-docs/error-handling/api-payment-failures","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}