Guías

Páginas prácticas para temas que cruzan más de un componente o hook.

• Manejo de errores - cómo el SDK expone errores del servidor, el patrón de narrowing isRiftApiError(err, "code") y las extensiones tipadas que lleva cada error recuperable.
• Renderizado del lado del servidor - qué garantiza el SDK para Next.js App Router, islas de Astro y Vite SPA, y qué necesitan hacer los consumidores para conservar esas garantías.
• Proteger el token de estado de la orden - cómo transportar el JWT posterior al checkout por el redirect de confirmPayment de Stripe sin filtrarlo al historial, el header Referer o los logs del servidor.
• Precios y estimaciones - el modelo de precios por waves, el algoritmo greedy-fill que usa el picker y el aviso que el desglose muestra cerca del total.
• Temas - custom properties de CSS bajo [data-rift-root], tres capas de override (CSS plano, la prop appearance, la variante oscura de tokens) y qué cosas el SDK deliberadamente no pinta en el wrapper.
• Internacionalización - negociación de locale, overrides de strings por clave y el catálogo completo de claves.
• Solución de problemas - problemas comunes (falta de provider, captcha olvidado, peers de Stripe, imports SSR) y qué hacer con cada uno.

Para detalles por símbolo (props, formas de retorno, códigos de error), consulta la referencia de API.