{"section":"known-issues","requestedLocale":"pt","requestedSlug":"o-saldo-do-cartaopresente-foi-alterado-mesmo-que-a-solicitacao-de-transacao-tenha-falhado","locale":"pt","slug":"o-saldo-do-cartaopresente-foi-alterado-mesmo-que-a-solicitacao-de-transacao-tenha-falhado","path":"docs/pt/known-issues/Payments/o-saldo-do-cartaopresente-foi-alterado-mesmo-que-a-solicitacao-de-transacao-tenha-falhado.md","branch":"main","content":">ℹ️ Este problema conhecido foi traduzido automaticamente do inglês.\n\n## Sumário\n\nAo criar uma transação usando um cartão-presente (débito ou crédito), a API pode retornar um erro mesmo que o saldo do cartão já tenha sido alterado.\n\nIsso ocorre porque a transação é registrada em duas etapas:\n\n1. O saldo do cartão-presente é atualizado (débito ou crédito).\n\n2. O registro da transação é salvo.\n\nSe a segunda etapa falhar, a API retorna um erro (geralmente HTTP 400 com a mensagem \"Uma tarefa foi cancelada.\"), mas a alteração de saldo da primeira etapa não é revertida.\n\n- **Conclusão do pedido:** o cartão-presente é debitado, o pagamento falha e o pedido permanece incompleto, mas o saldo não é reembolsado após o cancelamento da transação.\n\n- **Repetição da transação:** Quando a transação é repetida após esse erro, mesmo com o mesmo `requestId`, ela é processada novamente e o cartão-presente é creditado ou debitado mais de uma vez.\n\n- **Lista de transações:** as transações afetadas por este problema impactam o saldo do cartão-presente, mas não são retornadas por `GET /api/giftcards/{giftCardId}/transactions`.\n\n## Simulação\n\nNão é possível simular.\n\n## Workaround\n\n- **Débito:** o reembolso deve ser feito manualmente pela interface do usuário do Cartão-Presente. Se o cartão-presente tiver a opção `Recarregável: Não`, o reembolso deverá ser feito pela API de Transações do Cartão-Presente.\n\n- **Crédito:** não tente novamente automaticamente quando uma solicitação de transação retornar um erro ou expirar. Verifique o saldo do cartão-presente antes de tentar novamente e reverta os créditos duplicados que já foram aplicados."}