> ## Documentation Index > Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Integra Razorpay para cobrar en tu cuenta > Instala Razorpay, conecta tus claves API, configura los webhooks y registra tu dominio para que los pagos no se rechacen. Razorpay es una de las pasarelas de pago más usadas en India. Puedes conectarla a tu cuenta de Chateea para cobrar pagos únicos, montos personalizados y pagos recurrentes en todos tus canales de cobro, con las mismas automatizaciones que cualquier otra pasarela. La integración está disponible como aplicación en el **Marketplace de aplicaciones** y también desde **Pagos → Integraciones**, con la opción **Buscar más**. ## Qué permite la integración | Capacidad | Detalle | | - | - | | **Pagos únicos** | Cobros puntuales en cualquier canal | | **Montos personalizados** | Cobros por importes que no están en tu catálogo | | **Pagos recurrentes** | Suscripciones de duración fija | | **Gestión de suscripciones** | Cancelar y actualizar la tarjeta registrada | | **Reembolsos** | Devoluciones desde Chateea | Funciona en formularios de pedido, facturas, enlaces de pago, formularios, la ficha del contacto y otros canales. Razorpay se comporta igual que Stripe, NMI o Authorize.net: tienes recibos de venta automáticos, reembolsos, disparadores de **pago recibido** y **pedido enviado**, y descuentos con cupones. ## Cómo conectar Razorpay Los cuatro pasos son obligatorios. Saltarse el cuarto es el error más común y hace que los pagos fallen aunque todo lo demás esté bien. **1. Instala la aplicación Razorpay** Ve al **Marketplace de aplicaciones**, busca Razorpay e instálala. Revisa los permisos que solicita sobre los pagos de tu cuenta (pedidos, suscripciones, transacciones y proveedor personalizado) y haz clic en **Permitir e instalar**. **2. Autentica con tus claves API** Al terminar la instalación se abre la página de autenticación. Copia tus claves desde el panel de Razorpay, en **Accounts & Settings → API Keys**, y pégalas. | Bloque | Qué va ahí | | - | - | | **Credenciales de prueba** | Key Id y clave secreta de prueba, para validar sin cobros reales | | **Credenciales en vivo** | Key Id y clave secreta de producción | > [!WARNING] > > Cada bloque tiene su propio botón de conexión. Conectar el de prueba no habilita los cobros reales. **3. Configura los webhooks** En tu panel de Razorpay, ve a **Accounts & Settings → Webhooks** y agrega la URL de webhook que aparece en la pantalla de configuración de la aplicación dentro de Chateea. Cópiala tal cual; si no la ves, pídela a soporte de Chateea en **[help@chateea.com](mailto:help@chateea.com)**. Activa **todos los eventos relacionados con pagos**. Sin los webhooks, Chateea no recibe el estado de las transacciones y verás pagos cobrados que no se reflejan. | Familia | Eventos | | - | - | | **Pagos** | `payment.authorized`, `payment.failed`, `payment.captured` | | **Pedidos** | `order.paid` | | **Suscripciones** | `subscription.authenticated`, `subscription.paused`, `subscription.resumed`, `subscription.activated`, `subscription.pending`, `subscription.halted`, `subscription.charged`, `subscription.cancelled`, `subscription.completed`, `subscription.updated` | | **Reembolsos** | `refund.processed`, `refund.created` | > [!TIP] > > Razorpay recomienda agregar un secreto al webhook y un correo de alerta para enterarte si el webhook falla. Ambos campos están en la misma pantalla. **4. Registra tu dominio y agrégalo a la lista blanca de Razorpay** **En Chateea:** ve a **Configuración → Perfil del negocio → Dominio de marca**, registra el dominio que usas, verifícalo y haz clic en actualizar la información. **En Razorpay:** ve a **Accounts & Settings → Business Website Details → Add Additional Website/App Details** y agrega el mismo dominio. Razorpay lo verificará y lo habilitará. > [!WARNING] > > Razorpay solo acepta pagos desde dominios que tengas en su lista blanca. Si omites este paso, los pagos fallarán y Razorpay te enviará un correo de aviso. ## Por qué el paso 4 no es opcional | Elemento | Estado | Resultado | | - | - | - | | Aplicación instalada | Correcto | La integración aparece activa | | Claves en vivo | Correctas | La conexión se establece | | Webhooks | Correctos | Los estados llegarían bien | | **Dominio de marca propio** | **No registrado** | Se usa el dominio predeterminado para enlaces de pago, que no está autorizado para tu ID de comerciante | | **Resultado** | **Pago rechazado** | Razorpay envía un correo de intento fallido por dominio no registrado | La solución es exactamente el paso 4: registrar tu propio dominio de marca y agregarlo en Razorpay. ## Limitaciones * Solo se admiten suscripciones de **duración fija**. * Razorpay no permite, a través de esta integración, **cobros fuera de sesión** con tarjetas guardadas (cargos sin que el cliente esté presente). Por eso no sirve para recargar la billetera de tu cuenta ni para cobros que dependan de una tarjeta guardada. ## Preguntas frecuentes > **Recibo un correo de Razorpay que dice que el pago falló porque el dominio no está registrado** > > Razorpay restringe los pagos desde dominios no registrados o no verificados: cada ID de comerciante debe estar asociado a dominios de su lista blanca, como parte de su [política de sitio web](https://razorpay.com/docs/payments/dashboard/account-settings/business-website-details/). El dominio predeterminado que usan los enlaces de pago no está autorizado para tus claves. Registra tu propio dominio de marca como indica el paso 4 y agrégalo en Razorpay; a partir de ahí los pagos se procesarán correctamente. > **¿Dónde encuentro mis claves API?** > > En el panel de Razorpay, en **Accounts & Settings → API Keys**. Necesitas el Key Id y la clave secreta, con un par distinto para prueba y para producción. > **Los pagos se cobran pero el pedido no se actualiza** > > Casi siempre son los webhooks. Revisa que la URL esté bien pegada en Razorpay y que estén activos todos los eventos del paso 3, sobre todo los de `payment` y `order.paid`. > **¿Puedo usar Razorpay para recargar la billetera de mi cuenta?** > > No. Esas recargas necesitan cobros fuera de sesión con tarjeta guardada, que Razorpay no admite en esta integración. > **[Configurar proveedores de pago por canal](https://help.chateea.com/docs/pagos/proveedores-pago-por-canal.md)** > > Decide en qué canales cobras con Razorpay. > **[Cómo gestionar los reembolsos](https://help.chateea.com/docs/pagos/gestionar-reembolsos.md)** > > Devuelve pagos desde Chateea. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.