En esta página

Botón de Pago

Agrega un botón de pago a tu web sin escribir código. Perfecto para pequeños negocios, sitios WordPress e integraciones rápidas.

¿Qué es un botón de pago?

Un botón de pago es un widget embebible que permite a tus clientes pagar desde tu web sin necesidad de integración de backend. Lo creas en el portal de iion pay, copias un código y lo pegas en tu sitio — listo.

Cómo funciona
Crea un botón en el portal de iion pay → Obtén un slug único → Embébelo en tu sitio → Tus clientes pagan → Recibe notificaciones

Crear un botón de pago

  1. Ve a Portal de iion pay → Integraciones → Botones de pago
  2. Haz clic en Nuevo botón
  3. Completa:
    • Nombre: Nombre interno (p.ej., "Consulta 30 min", "Servicio")
    • Título: Lo que ve el pagador (p.ej., "Reserva una consulta de 30 minutos")
    • Modo: Monto fijo o rango personalizado
    • Monto: Para fijo; o mín/máx para personalizado
    • Etiqueta del botón: Texto en el botón (predeterminado: "Pagar")
    • URL de retorno: A dónde redirigir después del pago (opcional, HTTPS requerido)
  4. Haz clic en Crear
  5. Copia el slug — lo usarás para embeber el botón

Embeber en cualquier web

Pega este código en tu página HTML:

Snippet HTML
<div data-iion-pay="SLUG"><a href="https://pay.iionpay.com/w/SLUG">Pagar</a></div>
<script async src="https://pay.iionpay.com/embed/v1/iion-pay.js"></script>

Reemplaza SLUG con el código de tu botón. La etiqueta <a> es un respaldo — si JavaScript está bloqueado o la CSP es estricta, el enlace seguirá funcionando.

Sin JavaScript requerido
El enlace de respaldo funciona aunque tu sitio tenga una Content Security Policy (CSP) estricta. Tus clientes siempre pueden pagar.

Plugin de WordPress

Si usas WordPress, utiliza el plugin oficial de iion pay en lugar de pegar HTML:

Instalación

  1. Descarga el plugin
  2. Ve a Panel de WordPress → Plugins → Subir plugin
  3. Sube el archivo zip y haz clic en Activar

Usar el shortcode

En cualquier página o entrada, usa:

Shortcode de WordPress
[iionpay id="SLUG" label="Pagar ahora" target="_blank"]
Atributo Requerido Descripción
id Sí El slug de tu botón del portal
label No Texto para el enlace de respaldo (predeterminado: "Pagar")
target No Establece "_blank" para abrir el checkout en pestaña nueva

Notificaciones de pago

Cuando un cliente paga usando tu botón, recibes el mismo webhook payment.completed que con cualquier otro método de pago. Busca estos campos en los datos del webhook:

Ejemplo de webhook
{
  "event": "payment.completed",
  "data": {
    "id": "order-uuid",
    "status": "COMPLETED",
    "amount": 50000,
    "metadata": {
      "source": "pay_button",
      "payButtonId": "pb-uuid",
      "siteOrigin": "https://tusitio.com"
    },
    ...
  }
}
Campo Valor Uso
metadata.source "pay_button" Verifica que el pago vino de un botón (vs. API, enlace directo, etc.)
metadata.payButtonId UUID del botón Rastrea cuál botón se usó para reportes
metadata.siteOrigin Dominio de tu sitio Audita de dónde vino el pago

Mejores prácticas

  • Usa solo HTTPS. Las URL de retorno deben ser HTTPS (no http://)
  • Prueba primero. Crea un botón de prueba y verifica el flujo antes de usar en producción
  • Establece una URL de retorno. Da a tus clientes un próximo paso claro después de pagar
  • Monitorea webhooks. No confíes solo en el redireccionamiento — verifica el pago via webhook
  • Fijo vs. Personalizado. Usa montos fijos para servicios; rangos personalizados para donaciones o precios flexibles

Content Security Policy (CSP)

Si tu sitio tiene una CSP estricta, el botón estilizado no funcionará, pero el enlace seguirá funcionando. Tus clientes pueden seguir pagando haciendo clic en el enlace de respaldo.

Para habilitar el botón completamente estilizado, permite:

Directivas de CSP
script-src 'unsafe-inline' https://pay.iionpay.com
form-action https://pay.iionpay.com
No se requiere CSP para el respaldo
El enlace <a> funciona con cualquier CSP porque es solo un enlace normal.

Gestiona tus botones

En el portal puedes:

  • Rotar el slug — Obtén un nuevo código (el anterior deja de funcionar)
  • Ver estadísticas — Mira cuántos pagos usaron cada botón
  • Editar — Cambia el monto, etiqueta, URL de retorno, etc.
  • Desactivar — Desactiva un botón sin borrarlo