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.
Crear un botón de pago
- Ve a Portal de iion pay → Integraciones → Botones de pago
- Haz clic en Nuevo botón
- 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)
- Haz clic en Crear
- Copia el slug — lo usarás para embeber el botón
Embeber en cualquier web
Pega este código en tu página 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.
Plugin de WordPress
Si usas WordPress, utiliza el plugin oficial de iion pay en lugar de pegar HTML:
Instalación
- Descarga el plugin
- Ve a Panel de WordPress → Plugins → Subir plugin
- Sube el archivo zip y haz clic en Activar
Usar el shortcode
En cualquier página o entrada, usa:
[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:
{
"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:
script-src 'unsafe-inline' https://pay.iionpay.com
form-action https://pay.iionpay.com
<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