Visión general para desarrolladores
Todo lo que necesitas para integrar MONEI en tu sitio web o app. Elige un método de integración y conecta la API, el SDK de cliente y los webhooks.
Elige tu integración
- Página de pago alojada — redirige a un checkout alojado por MONEI con todos los métodos de pago y casi sin código de frontend.
- Checkout personalizado — recoge los datos de pago en tu propia página con Componentes de MONEI.js.
- API de pagos — crea y gestiona pagos de servidor a servidor.
Bloques fundamentales
- Referencia de la API REST — todos los endpoints, con sus esquemas de petición y respuesta.
- API GraphQL — para partners de MONEI Connect.
- MONEI.js — la librería de cliente para Componentes y .
- Webhooks — recibe el estado autoritativo del pago en tu servidor.
- Tokenización por canal — reutiliza métodos de pago guardados entre canales.
- Documentación para agentes de IA — lee cualquier página en Markdown y consulta la API de búsqueda de la documentación.
Antes de activar los pagos
Prueba y activa — usa tarjetas de prueba, Bizum y PayPal para validar tu integración y luego cambia a las claves de producción.
Preguntas frecuentes
¿Qué integración debería elegir?
Si quieres el menor esfuerzo, usa la página de pago alojada. Si necesitas que el checkout esté en tu propia página, usa un checkout personalizado. Usa la API directamente solo cuando proceses de servidor a servidor.
¿Cómo confirmo que un pago realmente tuvo éxito?
Confía siempre en el webhook enviado a tu servidor — nunca solo en el resultado del lado del cliente.
¿Puedo enviar una clave de idempotencia para que un reintento no cobre dos veces?
No. Los endpoints de creación de pagos no aceptan claves de idempotencia, y la idempotencia no es uniforme en toda la API: SEPA Request to Pay (una beta cerrada, no un método de pago que los comercios puedan usar) es la excepción, donde el resourceId que eliges actúa como tal. Crear un pago no es idempotente: si una petición agota el tiempo de espera y la envías de nuevo, obtienes un segundo pago. Envía tu propio orderId en cada pago, consulta el pedido antes de reintentar y toma el webhook o una consulta del pago como fuente de verdad, en lugar de la respuesta que no llegó.
Las acciones sobre un pago existente son más seguras: repetir la misma captura, cancelación o devolución sobre el mismo pago se agrupa en una sola en lugar de aplicarse dos veces, así que una devolución reintentada justo después de un tiempo de espera agotado no devuelve el dinero dos veces. Esa protección dura poco, así que no confíes en ella pasados unos minutos: consulta antes el pago.