Tratamento de erros

Passe onError e mostre a mensagem. A maioria das falhas pode ser resolvida pelo cliente, e o silêncio só o leva a tentar de novo às cegas.

onError={(error) => {
  console.error('[stablezact]', error);
  showBanner(String(error));
}}

Falhas comuns

Rede errada. A wallet está numa rede diferente da do pagamento. O SDK pede para mudar de rede; algumas wallets recusam a mudança programática e o cliente tem de a fazer manualmente.

Gas insuficiente. O cliente tem a stablecoin, mas não tem moeda nativa para pagar a transferência. A verificação de saldo deteta isto antes do envio.

Rejeitado na wallet. O cliente recusou a assinatura. Não é um erro pelo qual tenha de pedir desculpa. Deixe-o tentar de novo.

Pagamento expirado. Os pagamentos não ficam abertos indefinidamente. Crie um novo.

Rede não configurada. A criação de um pagamento numa rede sem wallet de liquidação é rejeitada, com a indicação da rede. Corrija isto nas definições de comerciante, não no código.

O que não fazer

Não repita a criação de um pagamento sem uma chave de idempotência. Envie um cabeçalho Idempotency-Key, ou pelo menos o mesmo orderId, para que o servidor consiga distinguir uma repetição de uma segunda compra. Consulte Repetir com segurança.

Não trate um 500 numa leitura de pagamento como uma indisponibilidade do serviço sem antes verificar o ID. Atualmente, um ID de pagamento desconhecido devolve 500 em vez de 404. Consulte Erros.