InicioPago con QRPreciosSeguridadDevelopersBlog Ingresar Crear cuenta
Blog / Developers
Developers · 07 nov 2026 · 3 min de lectura · por TAYPI

Primeros pasos con la API de pagos de TAYPI

Crea tus claves, genera tu primer cobro con POST /api/v1/payments y recibe el estado por webhook.

</>

Integrar una API de pagos QR Perú para tu e-commerce no tiene por qué ser complicado: con TAYPI creas tus claves, generas tu primer cobro con POST /api/v1/payments y recibes la confirmación por webhook. Si ya tienes un equipo de desarrollo y buscas una pasarela de QR interoperable que no dependa de capturas falsas, este tutorial te lleva por los primeros pasos con la documentación para developers de TAYPI.

¿Qué es la API de pagos QR Perú de TAYPI?

La API de pagos QR Perú de TAYPI es una interfaz REST que permite a comercios y e-commerce generar cobros con QR dinámico interoperable desde su propio sistema. Cada solicitud crea un QR único, con monto fijo y referencia, que expira en 15 minutos. No se trata de un QR estático reutilizable: cada transacción tiene su propio identificador visual y lógico.

Esta API opera sobre la infraestructura de pagos interoperables del BCRP (a través de la CCE), lo que significa que el cobro puede pagarse desde Yape, Plin y cualquier billetera interoperable del sistema financiero peruano. La verificación del pago se hace directamente con la entidad financiera, no con capturas de pantalla. Si TAYPI confirma el pago, está pagado.

Un punto clave: TAYPI no procesa tarjetas de crédito o débito. Solo trabaja con billeteras y pagos QR interoperables. Para muchos negocios esto es una ventaja, porque elimina los contracargos y las comisiones de marca de tarjetas.

Requisitos previos para integrar la API de pagos QR

Antes de lanzar tu primer POST /api/v1/payments, necesitas preparar tu entorno. La buena noticia es que la activación es inmediata y sin costo de instalación ni mensualidad.

Crea tu cuenta y obtén tus claves de sandbox

Lo primero es registrarte en TAYPI. Desde el panel obtienes tus claves de API, incluidas claves de sandbox para probar sin tocar dinero real. El entorno de pruebas te permite simular cobros, verificar respuestas y validar tu lógica de webhooks antes de pasar a producción.

Para cobrar y recibir la liquidación deberás ser un comercio Nivel 2 (KYB verificado), pero para integrar y probar la API no necesitas esperar validaciones complejas.

Autenticación con firma HMAC-SHA256

Toda solicitud a la API debe autenticarse con una firma HMAC-SHA256. Esto significa que tu backend calcula una firma usando tu clave secreta y los datos de la solicitud. TAYPI verifica esa firma para asegurarse de que el request proviene de tu sistema y no fue alterado en el camino.

Si quieres profundizar en el manejo de firmas, te recomiendo leer cómo verificar firmas HMAC-SHA256 en tu backend. Como capa adicional, toda la comunicación viaja con TLS 1.3, el estándar actual de cifrado en tránsito.

Tu primer cobro con POST /api/v1/payments

El corazón de la integración es el endpoint POST /api/v1/payments. Con una sola llamada obtienes el QR y un checkout_url listo para compartir.

Estructura de la solicitud

Tu backend envía los datos mínimos del cobro: monto, referencia interna, clave de idempotencia y la firma HMAC-SHA256

¿Listo para cobrar con QR?

Crea tu cuenta gratis y genera tu primer QR en minutos.

Abrir cuenta gratis