Integración de Plataformas de Pago

Canales de pago soportados

Ofrecemos una amplia variedad de opciones para procesar pagos recurrentes en diferentes mercados

Tarjetas

Débito Directo

Métodos Locales

Billeteras Digitales

Procesamiento de tarjetas

Soporte completo para los principales emisores de tarjetas a nivel mundial, con capacidades avanzadas de gestión y seguridad.

Tarjetas soportadas

Visa, Mastercard, American Express, Discover, Diners Club, JCB y otras tarjetas internacionales.

Seguridad PCI DSS

Cumplimiento total con los estándares de seguridad de la industria de tarjetas de pago, minimizando tu ámbito de responsabilidad.

Actualización automática

Integración con redes de actualización de tarjetas para mantener la información al día cuando hay renovaciones o reemplazos.

3D Secure 2.0

Soporte para autenticación avanzada que mejora la seguridad manteniendo una experiencia de usuario fluida.

Débito Directo SEPA

Solución ideal para cobros recurrentes en la zona euro, con alta tasa de aceptación y menor costo de procesamiento.

Cobertura SEPA

Soporte para todos los países de la zona SEPA, incluyendo gestión de mandatos y notificaciones previas.

Gestión de mandatos

Herramientas para la creación, almacenamiento y gestión de mandatos electrónicos conforme a la normativa europea.

Programación flexible

Configuración personalizada de fechas de cargo y frecuencias adaptadas a tus necesidades de facturación.

Gestión de devoluciones

Procesos automatizados para la gestión de devoluciones (R-transactions) y reintentos según normativa.

Métodos de pago locales

Soporte para métodos de pago específicos de diferentes países, facilitando la expansión internacional y mejorando las tasas de conversión en mercados locales.

España

Bizum, transferencias inmediatas, domiciliación bancaria local y tarjetas específicas del mercado español.

América Latina

Integración con sistemas como Oxxo, Boleto Bancário, PSE, Webpay y otros métodos relevantes en la región.

Europa

Soporte para iDEAL, Sofort, Giropay, Bancontact y otros métodos preferidos en diferentes países europeos.

Asia-Pacífico

Integración con Alipay, WeChat Pay, GrabPay y otros sistemas populares en mercados asiáticos.

Billeteras digitales

Soporte para las principales soluciones de pago digital, ofreciendo a tus clientes opciones modernas y convenientes para sus suscripciones.

PayPal

Integración completa con PayPal para pagos recurrentes, incluyendo gestión de acuerdos de facturación.

Apple Pay

Soporte para pagos recurrentes a través de Apple Pay, ofreciendo una experiencia fluida en dispositivos iOS.

Google Pay

Integración con Google Pay para facilitar pagos recurrentes en el ecosistema Android y web.

Otras billeteras

Soporte para soluciones emergentes como Klarna, Revolut y otras opciones de pago digital en crecimiento.

Proceso de integración

Implementación paso a paso para conectar tu plataforma con Mekebook

Registro y configuración

Crea tu cuenta de Mekebook y configura los detalles básicos de tu negocio, incluyendo información fiscal y preferencias de notificación.

Obtención de API keys

Genera tus claves de API para el entorno de pruebas (sandbox) y producción, con diferentes niveles de permisos según tus necesidades.

Pruebas en sandbox

Utiliza nuestro entorno de pruebas para validar la integración, simular diferentes escenarios de pago y verificar el correcto funcionamiento.

Configuración de reglas

Define las reglas de facturación, estrategias de dunning y otros parámetros que determinarán cómo se gestionan tus cobros recurrentes.

Pase a producción

Una vez validada la integración en el entorno de pruebas, realiza la transición a producción para comenzar a procesar pagos reales.

Gestión de errores y recuperación

Nuestro sistema está diseñado para manejar de forma robusta las diferentes situaciones que pueden surgir durante el procesamiento de pagos recurrentes:

Detección de errores

Identificación precisa del tipo de error (fondos insuficientes, tarjeta caducada, límites excedidos, etc.) para aplicar la estrategia de recuperación más adecuada.

Política de reintentos

Configuración flexible de secuencias de reintentos con intervalos optimizados según el tipo de error y el comportamiento histórico del cliente.

Notificaciones inteligentes

Sistema de comunicación multicanal (email, SMS, push) que envía mensajes personalizados para facilitar la actualización de métodos de pago o resolución de problemas.

Registro detallado

Logs completos de todas las transacciones, intentos y comunicaciones, proporcionando una visión clara del estado de cada suscripción y sus eventos relacionados.

Detalles técnicos para desarrolladores

Información esencial para implementar correctamente la integración con Mekebook

API REST

Webhooks

Seguridad

Integración SaaS

API RESTful

Nuestra API sigue los principios REST y utiliza JSON para el intercambio de datos, facilitando la integración desde cualquier lenguaje de programación o plataforma.

Endpoints principales

/v1/customers - Gestión de clientes y sus métodos de pago
/v1/subscriptions - Creación y gestión de suscripciones
/v1/plans - Configuración de planes y precios
/v1/invoices - Acceso a facturas y estados de pago
/v1/payment_methods - Gestión de métodos de pago
/v1/events - Historial de eventos del sistema

Ejemplo de creación de cliente

POST /v1/customers
{
  "email": "cliente@ejemplo.com",
  "name": "Empresa Ejemplo S.L.",
  "tax_id": "B12345678",
  "billing_address": {
    "line1": "Calle Principal 123",
    "postal_code": "28001",
    "city": "Madrid",
    "country": "ES"
  },
  "metadata": {
    "internal_id": "CL-12345"
  }
}

Ejemplo de creación de suscripción

POST /v1/subscriptions
{
  "customer_id": "cus_12345abcde",
  "plan_id": "plan_premium_monthly",
  "payment_method_id": "pm_67890fghij",
  "trial_end": "2025-12-15",
  "metadata": {
    "source": "campaign_spring2025"
  }
}

Sistema de Webhooks

Los webhooks permiten recibir notificaciones en tiempo real sobre eventos importantes, manteniendo tus sistemas sincronizados con el estado de las suscripciones.

Eventos principales

subscription.created - Nueva suscripción creada
subscription.updated - Actualización en una suscripción
subscription.cancelled - Cancelación de suscripción
payment.succeeded - Pago procesado con éxito
payment.failed - Fallo en intento de pago
payment_method.updated - Actualización de método de pago
invoice.created - Nueva factura generada
invoice.paid - Factura marcada como pagada
dunning.started - Inicio de proceso de recuperación
dunning.succeeded - Recuperación exitosa
dunning.failed - Proceso de recuperación fallido

Estructura de evento webhook

{
  "id": "evt_12345abcde",
  "type": "payment.succeeded",
  "created": 1731542400,
  "data": {
    "object": {
      "id": "pay_67890fghij",
      "amount": 2995,
      "currency": "eur",
      "subscription_id": "sub_54321abcde",
      "customer_id": "cus_12345abcde",
      "invoice_id": "inv_98765zyxwv",
      "payment_method": "card",
      "status": "succeeded"
    }
  }
}

Recomendaciones para webhooks

Idempotencia: Diseña tus controladores de webhooks para manejar entregas duplicadas (mismo evento recibido múltiples veces).
Respuesta rápida: Responde con código 200 lo antes posible y procesa la lógica de negocio de forma asíncrona.
Verificación de firma: Utiliza la firma incluida en las cabeceras para verificar la autenticidad de las notificaciones.
Manejo de errores: Implementa reintentos y logging adecuado para garantizar que no se pierdan eventos importantes.

Seguridad y buenas prácticas

La seguridad es una prioridad máxima cuando se trata de procesamiento de pagos. Sigue estas recomendaciones para garantizar una integración segura y robusta.

Autenticación y autorización

API Keys: Utiliza claves de API diferentes para entornos de prueba y producción, y nunca expongas las claves en código cliente.
HTTPS: Todas las comunicaciones con nuestra API deben realizarse a través de conexiones seguras HTTPS.
Permisos granulares: Crea claves de API con permisos limitados según las necesidades específicas de cada integración.

Manejo de datos sensibles

Tokenización: Nunca almacenes datos de tarjetas directamente; utiliza nuestros tokens para referencias seguras.
Minimización: Recopila y almacena solo los datos personales estrictamente necesarios para la operación.
Cifrado: Asegúrate de que cualquier dato sensible esté cifrado tanto en tránsito como en reposo.

Prácticas de desarrollo seguro

Validación de entrada: Verifica y sanitiza todas las entradas de usuario antes de enviarlas a la API.
Manejo de errores: Implementa un sistema robusto de manejo de excepciones que no exponga información sensible.
Logging seguro: Registra actividades relevantes pero evita incluir datos sensibles en los logs.
Actualizaciones: Mantén tus librerías y dependencias actualizadas para evitar vulnerabilidades conocidas.

Integración con plataformas SaaS

Mekebook está especialmente diseñado para integrarse de forma fluida con aplicaciones SaaS, proporcionando una gestión completa del ciclo de vida de las suscripciones.

Ciclo de vida del cliente

Onboarding: Integración con flujos de registro y activación de cuentas.
Trials: Gestión de períodos de prueba con o sin método de pago, con conversión automática a suscripciones pagadas.
Upgrades/Downgrades: Cambios de plan con prorrateo y ajustes automáticos de facturación.
Cancelaciones: Flujos personalizables de cancelación con opciones de retención y feedback.
Reactivaciones: Proceso simplificado para recuperar clientes que cancelaron previamente.

Integraciones típicas

Nuestros clientes suelen integrar Mekebook con los siguientes sistemas:

CRM: Sincronización bidireccional con sistemas de gestión de relaciones con clientes.
ERP: Integración con sistemas de planificación de recursos empresariales para facturación y contabilidad.
Sistemas de provisioning: Activación y desactivación automática de servicios basada en el estado de la suscripción.
Plataformas de marketing: Segmentación y campañas basadas en el comportamiento de pago y ciclo de vida del cliente.
Herramientas de análisis: Exportación de datos para análisis avanzados de retención, LTV y otros KPIs.

Ejemplo de webhook para provisioning



app.post('/webhooks/Mekebook', function(req, res) {
  const event = req.body;
  
 
  
  switch(event.type) {
    case 'subscription.activated':
     
      activateService(event.data.object.customer_id, event.data.object.plan_id);
      break;
    
    case 'subscription.cancelled':
     
      deactivateService(event.data.object.customer_id);
      break;
      
    case 'subscription.updated':
     
      updateServiceTier(event.data.object.customer_id, event.data.object.plan_id);
      break;
  }
  
  res.status(200).send();
});