# Tratar erros e falhas de pagamento

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.

Para uma descrição de como os estados de falha aparecem na interface, consulte [Erros e falhas de pagamento](/pt-br/products/payments-direct-2/user-interface/ui-payment-failures).

## Pré-requisitos

- Você tem acesso ao Payments Direct UI.
- Um pagamento passou para um estado de erro ou falha.


## Etapa 1: Identificar a falha

1. Abra a página **Pagamentos**.
2. Localize o pagamento que falhou na lista de pagamentos. Os pagamentos com falha exibem um indicador de status de erro.
3. Selecione o pagamento para abrir a visão de detalhes dele.
4. Anote o **error code**, a **error description** e o texto **What you can do** exibidos no painel da mensagem de erro.


## Etapa 2: Entender o motivo da falha

Use a descrição do erro e a tabela abaixo para entender o que causou a falha:

| Motivo da falha | O que significa |
|  --- | --- |
| Saldo insuficiente | O seu saldo disponível é menor que o valor do pagamento. |
| Fatura vencida | A sua conta tem uma fatura em aberto que precisa ser quitada antes que novos pagamentos possam prosseguir. |
| Limite de transações atingido | Você atingiu o número máximo de transações permitido em um período de 24 horas. |
| Limite de valor por transação excedido | O valor do pagamento excede o limite por transação da sua conta. |
| Beneficiário inativo | O beneficiário indicado no pagamento está inativo e não pode receber recursos. |
| Identidade incompatível | O ID de identidade informado não corresponde a uma identidade do tipo beneficiário. |


Se você vir um código de erro que não está listado aqui, anote-o e informe-o ao [suporte técnico](/pt-br/products/payments-direct-2/support).

## Etapa 3: Agir

Conforme o motivo da falha, tome uma das seguintes ações:

**Saldo insuficiente:** deposite mais recursos na sua conta (consulte [Depositar recursos](/pt-br/products/payments-direct-2/user-interface/guides/deposit-funds)) e envie o pagamento novamente com uma nova cotação.

**Fatura vencida:** quite a fatura em aberto. Depois que a fatura for liquidada, envie o pagamento novamente com uma nova cotação.

**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.

**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.

**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.

**Identidade incompatível:** confira o ID da identidade do beneficiário e reenvie com o ID correto.

**Outro erro ou erro desconhecido:** informe o código do erro ao [suporte técnico](/pt-br/products/payments-direct-2/support) para investigação.

## Observações

- 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.
- 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.
- Se você não conseguir resolver o problema com as informações acima, entre em contato com o [suporte técnico](/pt-br/products/payments-direct-2/support) e informe o código de erro do pagamento que falhou.