Blog / Developers
Cómo agregar un botón de pago a tu web
Agrega un botón de pago con QR a cualquier web con unas pocas líneas. Tu cliente paga sin salir de tu página.
Agregar un botón de pago web Perú a tu sitio puede transformar la forma en que cobras: en lugar de esperar transferencias o validar capturas manualmente, tu cliente escanea un QR y paga sin salir de tu página. Con herramientas como Checkout.js o un link de pago de TAYPI, integrar cobros con QR interoperable toma poco tiempo y te da confirmación automática.
¿Qué es un botón de pago web en Perú y para qué sirve?
Un botón de pago web es un componente que insertas en tu página para iniciar un cobro digital. Puede ser un botón que abre un checkout embebido, genera un QR en pantalla o redirige al cliente a una pasarela de pago. En el contexto peruano, lo más potente es un botón que dispare un pago con QR interoperable, porque el cliente paga desde Yape, Plin o cualquier billetera conectada a la interoperabilidad del BCRP.
La ventaja principal es que reduces la fricción: el cliente no tiene que copiar un número de cuenta, enviar una captura ni esperar validación manual. Todo el flujo ocurre dentro de tu web o en un checkout optimizado, y la confirmación llega automáticamente.
No necesitas ser un experto para implementarlo. Puedes optar por un desarrollo técnico con una API y un script, o usar un enlace de pago listo para pegar en cualquier botón. Ambas opciones te permiten cobrar con pagos QR sin depender de un POS físico.
Cómo funciona un botón de pago con QR interoperable
Cuando tu cliente pulsa el botón, el sistema genera un QR dinámico único con monto fijo y referencia. Ese QR no es reutilizable y expira en 15 minutos. El cliente lo escanea con su billetera —Yape, Plin o cualquier billetera interoperable— y confirma el pago en su app.
La verificación no depende de capturas de pantalla. La pasarela consulta directamente con la entidad financiera a través de la Cámara de Compensación Electrónica (CCE). Si el pago es confirmado, queda pagado. Esto elimina el riesgo de fraude por comprobantes falsos y acelera la conciliación.
Detrás de este flujo hay una infraestructura regulada. La interoperabilidad del QR en Perú opera sobre el marco del BCRP y bajo supervisión de la SBS mediante un procesador regulado. Para tu negocio, eso significa que cada cobro queda asociado a una referencia y la liquidación se hace al día hábil siguiente (T+1) en tu cuenta CCI.
Si quieres entender mejor este ecosistema, te conviene leer qué son los pagos QR interoperables en Perú.
Cómo agregar un botón de pago web en Perú con Checkout.js
Opción 1: Checkout.js para developers
Checkout.js es la forma más rápida de aceptar pagos QR incrustados en tu web. Es un script que te permite generar un checkout sin redirigir al cliente a una página externa. Integras unas pocas líneas de código y el botón queda listo para cobrar.
El flujo técnico típico es:
- Crear una cuenta en la pasarela y obtener tus claves de API.
- Desde tu backend, hacer una petición
POST /api/v1/payments. - Recibir el QR y el
checkout_urlque devuelve la API. - Renderizar el checkout embebido con Checkout.js en tu frontend.
- Escuchar la confirmación del pago por webhook en tiempo real.
La integración usa autenticación con firma HMAC-SHA256 e idempotencia para evitar cobros duplicados. También hay claves de sandbox para probar sin mover dinero real. Si desarrollas en PHP, JavaScript/TypeScript o .NET, existen SDK oficiales que simplifican todo.
Para una guía más detallada, revisa el artículo Checkout.js: la forma más rápida de aceptar pagos QR y la documentación para developers.
Opción 2: Link de pago sin programar
Si no quieres escribir código, puedes crear un link de pago desde el panel del comercio. Ese enlace genera una página de cobro con QR interoperable. Luego, simplemente lo enlazas en cualquier botón de tu web, en un email o en tus redes.
Es ideal para negocios que recién empiezan, para campañas puntuales o para quienes no tienen un equipo técnico. El cliente pulsa el botón, se abre el link de pago, escanea el QR y paga al instante.
Ambas opciones conviven: puedes empezar con un link de pago y migrar luego a una integración embebida con Checkout.js.
Ventajas de usar un botón de pago con QR en tu web
Implementar un botón de pago con QR no es solo una mejora estética. Tiene beneficios concretos para tu operación:
- Cobro sin fricción: el cliente paga en segundos desde su billetera, sin tarjetas ni formularios largos.
- Confirmación automática: la verificación es bancaria directa, no por capturas. Si la pasarela confirma, está pagado.
- QR de un solo uso: cada cobro genera un QR dinámico con monto fijo y vencimiento de 15 minutos.
- Cero contracargos: al no procesar tarjetas, no existen chargebacks ni comisiones de marca.
- Liquidación al día siguiente: el dinero llega a tu CCI en T+1, sin saldos atrapados en una app.
- Pago en un clic: con la afiliación de Yape On File, el cliente puede afiliar su Yape una sola vez y pagar después en un clic, sin escanear ni reingresar datos.
La siguiente tabla compara las dos formas principales de implementar un botón de pago:
| Característica | Checkout.js (embebido) | Link de pago |
|---|---|---|
| Programación requerida | Sí, básica | No |
| Experiencia de usuario | Pago sin salir de tu web | Redirige a una página de cobro |
| Personalización | Alta | Media |
| Tiempo de implementación | Alrededor de un día | Inmediato |
| Ideal para | E-commerce y desarrolladores | Negocios sin equipo técnico |
Precios y comisiones de un botón de pago web en Perú
Uno de los puntos que más preocupa a los comercios es cuánto cuesta realmente aceptar pagos por QR. En el caso de TAYPI, la comisión es 2.50% + S/ 0.20 + IGV por cobro confirmado. No hay costo de instalación, ni mensualidad, ni permanencia.
La fórmula es: (monto × 2.50% + número de cobros × S/ 0.20) × 1.18.
Para un cobro de S/ 100, el desglose sería:
| Concepto | Monto |
|---|---|
| Comisión variable | S/ 2.50 |
| Comisión fija | S/ 0.20 |
| IGV sobre la comisión | S/ 0.49 |
| Total comisión | S/ 3.19 |
| El comercio recibe | S/ 96.81 |
El monto mínimo por transacción es S/ 1.00. Si quieres ver el detalle completo, visita precios de TAYPI.
Ten en cuenta que esta comisión cubre todo el procesamiento del QR interoperable, la verificación bancaria directa y la conciliación automática. No hay costos ocultos por contracargos porque no se procesan tarjetas.
Seguridad y confianza: verificación bancaria directa
La seguridad en los pagos digitales no es opcional. Un botón de pago debe estar respaldado por una infraestructura que proteja tanto al comercio como al cliente.
TAYPI opera con verificación bancaria directa, no con capturas de pantalla. Cada QR es de un solo uso y expira en 15 minutos. Las comunicaciones usan cifrado TLS 1.3 y las integraciones se autentican con firma HMAC-SHA256. Además, la API soporta idempotencia, lo que evita cobros duplicados si una petición se repite.
En cumplimiento normativo, la pasarela se alinea con la regulación PLAFT (prevención de lavado de activos) conforme a la normativa peruana de la SBS y la UIF-Perú. Opera sobre la infraestructura de pagos interoperables del BCRP a través de la CCE, bajo el marco del sistema financiero supervisado por la SBS. También cuenta con certificaciones ISO 27001:2022 e ISO 9001:2015.
Para más información sobre este aspecto, consulta seguridad de TAYPI.
Preguntas frecuentes
¿Necesito saber programar para agregar un botón de pago a mi web?
No necesariamente. Puedes usar un link de pago y enlazarlo a cualquier botón de tu web sin escribir código. Si quieres integrar un checkout embebido, entonces sí necesitas conocimientos básicos de desarrollo o usar un plugin oficial, como el de WooCommerce.
¿Qué medios de pago acepta un botón de pago con QR?
Acepta Yape, Plin y cualquier billetera interoperable conectada a la CCE a través del BCRP. No procesa tarjetas de crédito ni débito.
¿El pago se confirma automáticamente?
Sí. La confirmación se realiza mediante verificación bancaria directa con la entidad financiera. No se validan capturas de pantalla ni comprobantes manuales.
¿Cuánto cuesta implementar un botón de pago web en Perú?
No hay costo de instalación ni mensualidad. Solo pagas una comisión por cobro confirmado: 2.50% + S/ 0.20 + IGV. Por ejemplo, en un cobro de S/ 100, la comisión total es S/ 3.19.
¿Puedo usar el botón de pago en mi tienda WooCommerce?
Sí. Existe un plugin oficial de WooCommerce que te permite integrar pagos QR sin desarrollar desde cero. También puedes usar la API REST o Checkout.js para desarrollos a medida.
Conclusión
Agregar un botón de pago web Perú es una decisión práctica para cobrar más rápido, reducir la fricción y eliminar la validación manual de pagos. Puedes empezar con un link de pago sin programar o implementar Checkout.js para un checkout embebido. La clave está en elegir una pasarela que verifique los pagos directamente con la entidad financiera y te ofrezca liquidación al día siguiente.
Si buscas una opción con QR interoperable, confirmación automática y comisión clara, TAYPI te permite crear tu cuenta gratis y empezar a cobrar en tu web hoy mismo.
¿Listo para cobrar con QR en tu web? Crea tu cuenta en TAYPI y agrega un botón de pago con Checkout.js o un link de pago en minutos.
¿Listo para cobrar con QR?
Crea tu cuenta gratis y genera tu primer QR en minutos.
Abrir cuenta gratis