Gestión de errores

Pase onError y muestre el mensaje. La mayoría de los fallos los puede resolver el cliente, y el silencio solo hace que vuelva a intentarlo a ciegas.

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

Fallos habituales

Red equivocada. La wallet está en una cadena distinta a la del pago. El SDK pide al cliente que cambie de cadena; algunas wallets no permiten el cambio programático y el cliente tiene que cambiarla por su cuenta.

Gas insuficiente. El cliente tiene la stablecoin pero no tiene moneda nativa para pagar la transferencia. La comprobación de saldo lo detecta antes del envío.

Rechazado en la wallet. El cliente rechazó la firma. No es un error por el que haya que disculparse. Deje que lo intente de nuevo.

Pago caducado. Los pagos no permanecen abiertos indefinidamente. Cree uno nuevo.

Cadena no configurada. Crear un pago en una cadena sin wallet de liquidación se rechaza, con un error que indica el nombre de la cadena. Corríjalo en la configuración de su cuenta de comerciante, no en el código.

Qué no hacer

No reintente la creación de un pago sin una clave de idempotencia. Envíe una cabecera Idempotency-Key, o al menos el mismo orderId, para que el servidor pueda distinguir un reintento de una segunda compra. Consulte Reintentar de forma segura.

No interprete un 500 en la lectura de un pago como una caída del servicio sin comprobar antes el ID. Actualmente, un ID de pago desconocido devuelve 500 en lugar de 404. Consulte Errores.