Saltar al contenido principal
Migo Docs

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.

Para quién es esto

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ámetroObligatorioQué es
secretSíLa credencial de tu comercio — identifica tu cuenta sin que tengas que enviar ningún otro dato de cliente
channelSí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_bySí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.

Trata el secret como una credencial

Cualquier 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étodoRutaQué 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/linksCrea 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/linksLista 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/plansLista 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:

EntornoURL base
Sandbox / QAhttps://sb-mw.migopayments.com/v1/plugins
Producciónhttps://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​