Paylink — widget embebible de link de pago
Además del camino de Inicio rápido de links de pago (tu backend llama a la API), Migo ofrece paylink: un widget listo para usar que se embebe por <iframe> en cualquier sitio — tu CRM, tu ERP, el panel de un partner, una herramienta interna de soporte. No requiere que escribas código de backend ni que le crees una cuenta de usuario a nadie en tus sistemas: se autentica con un único secret por comercio.
Si tu equipo ya integra la API (el flujo de Inicio rápido de links de pago), no necesitas este widget. Está pensado para el caso contrario: un equipo de soporte, ventas u operaciones que necesita generar y compartir links de pago sin que un desarrollador escriba una integración — solo pegan un <iframe> en la herramienta que ya usan.
Qué hace el widget
Dentro del widget, quien lo usa puede:
- Generar un link de pago indicando monto e identificador del cliente final (teléfono, correo u otro).
- Elegir cuotas, agregar cargos extra y llenar campos adicionales — si tu cuenta los tiene habilitados.
- Vender vía links de suscripción, si tu cuenta usa el producto de Suscripciones de Migo.
- Consultar el historial de links generados y cancelar uno que aún no fue pagado.
El link resultante abre exactamente el mismo webview hospedado que ya conoces — el pagador no ve ninguna diferencia según cómo se generó el link.
Cómo lo embebes
https://paylink.migopayments.com/?secret=<tu-secret>&channel=wa&created_by=agente@tuempresa.com
El host que lo embebe controla tres parámetros de query:
| Parámetro | Obligatorio | Qué es |
|---|---|---|
secret | Sí | La credencial de tu comercio — identifica tu cuenta sin que tengas que enviar ningún otro dato de cliente |
channel | Sí | Por qué canal se está generando el link (wa, email, fb, o cualquier valor que tenga sentido para tu operación) — queda registrado en la transacción para tu reportería |
created_by | Sí | Quién generó el link (el agente, usuario o proceso) — además de quedar en la transacción, filtra el historial dentro del widget |
Si falta cualquiera de los tres, el widget muestra un mensaje de error sin intentar cargar nada.
Ejemplo de embedding
<iframe
src="https://paylink.migopayments.com/?secret=TU_SECRET&channel=wa&created_by=agente@tuempresa.com"
width="100%"
height="720"
style="border: none; max-width: 480px;"
title="Widget de link de pago"
></iframe>
El widget mide el ancho del contenedor que le das, no el de la ventana del navegador — hazlo con width="100%" (o el ancho de tu columna) en vez de un valor fijo, para que se adapte igual de bien en escritorio y en móvil. height sí es un valor fijo que tú controlas; 720px cubre el formulario completo sin scroll interno en la mayoría de los casos.
secret como una credencialCualquier origen que tenga el secret puede embeber el widget para tu comercio — no hay todavía una lista de dominios permitidos a nivel de infraestructura. No publiques el secret en repositorios públicos, documentación compartida ni páginas indexables. Si crees que se expuso, contacta a Migo para rotarlo.
Cómo obtienes tu secret
El alta y la configuración del widget la hace el equipo de Migo — no es autoservicio todavía. Contacta a tu ejecutivo de cuenta o a soporte de Migo para habilitar el widget en tu comercio; te confirmarán qué funcionalidades (cuotas, cargos extra, campos adicionales, suscripciones, historial) quedan activas para tu cuenta y te entregarán el secret una única vez.
Si prefieres tu propia interfaz
El widget también expone su API directamente, autenticada con el mismo secret — útil si quieres construir tu propia UI en vez de embeber la nuestra.
| Método | Ruta | Qué hace |
|---|---|---|
GET | /plugin/config?secret=<secret> | Devuelve la identidad de tu comercio, qué funcionalidades tienes activas y los datos que necesitas para armar el formulario (procesadores, campos adicionales, rango de monto permitido) |
POST | /plugin/links | Crea un link de pago. Admite el header Idempotency-Key: reintentar dentro de 60 segundos devuelve el mismo link en vez de crear uno nuevo |
GET | /plugin/links | Lista los links ya generados, opcionalmente filtrados por created_by, paginado |
DELETE | /plugin/links/{uid} | Cancela un link que todavía no fue pagado |
GET | /plugin/plans | Lista los planes de suscripción de tu cuenta, si tienes ese módulo activo |
Todas se llaman contra la misma base que el resto de Middleware:
| Entorno | URL base |
|---|---|
| Sandbox / QA | https://sb-mw.migopayments.com/v1/plugins |
| Producción | https://mw.migopayments.com/v1/plugins |
Un secret inválido, tu comercio deshabilitado, o una funcionalidad que no tienes activa responden todos con el mismo 404 genérico — así ningún endpoint sirve para adivinar secrets válidos por prueba y error. Consulta la especificación en vivo en /api-reference/migo-api para el detalle completo de cada campo.
Relacionado
- Inicio rápido de links de pago — el camino equivalente si prefieres integrar la API desde tu backend.
- Webview hospedado — qué ve el cliente final al abrir el link, sin importar cómo se generó.
- Seguridad y alcance PCI — qué maneja Migo y qué manejas tú.
- ¿Necesitas habilitarlo para tu cuenta? Contacta soporte de Migo.