Cobros con QR desde tus propios sistemas
Tu ERP, tu tienda o tu backend crean el cobro con una llamada a nuestra API. A través de nuestra integración con TAYPI, recibes un QR y un enlace de pago para tu cliente.
Reintentar con la misma clave nunca crea un segundo cobro.
QR interoperable
Generación de cobros mediante nuestra integración con TAYPI.
API REST
Un POST para cobrar, un GET para el estado.
Idempotencia
Los reintentos no duplican cobros.
Portal de cliente
Pagos, peticiones y claves de acceso.
Cómo funciona
Tu sistema habla solo con nuestra API y nuestra API se conecta con TAYPI, que procesa el cobro. Tu sistema nunca necesita credenciales de la pasarela.
Crea el cobro
Tu sistema envía monto, referencia y una Idempotency-Key a nuestra API. Generamos el cobro en TAYPI y te devolvemos el QR, el enlace de pago y la fecha de vencimiento.
Tu cliente paga
Muestras el QR o compartes el enlace. El pago se realiza y se procesa en TAYPI.
Consultas el estado
Cuando TAYPI confirma el pago, lo verificamos y el estado pasa a completed. Lo consultas con un GET cuando lo necesites.
Conecta los cobros con tus sistemas
Una API REST sobre HTTPS que puedes llamar desde tu ERP, tu backend o cualquier proceso automatizado.
Autenticación por cabecera
Cada petición se identifica con X-API-Key. Puedes tener varias claves activas, una por sistema.
Reintentos seguros
Si se corta la conexión, repite la petición con la misma Idempotency-Key: obtienes el mismo pago, nunca uno nuevo.
Respuesta con estructura estable
Siempre success, message y data. Los importes viajan como texto con dos decimales.
curl "https://pagos.sentra.com.pe/api/v1/payments" \
-H "X-API-Key: sk_live_TU_API_KEY" \
-H "Idempotency-Key: ORD-12345" \
-H "Content-Type: application/json" \
-d '{"amount": "25.00", "reference": "ORD-12345"}'{
"success": true,
"message": "Pago creado correctamente",
"data": {
"id": "pay_3f9a1c...",
"status": "pending",
"amount": "25.00",
"currency": "PEN",
"qr_code": "000201...",
"checkout_url": "https://...",
"expires_at": "2026-10-18T15:15:00-05:00"
}
}Preguntas frecuentes
¿Con qué se puede pagar?
Los pagos se procesan mediante TAYPI, y los medios de pago son los que acepta su QR interoperable: Yape, Plin o la app de cualquier banco conectado a la CCE. Los cobros son en soles.
¿Qué pasa si mi sistema reintenta la petición?
Cada cobro lleva una Idempotency-Key que eliges tú, por ejemplo el
número de tu orden. Repetir la petición con la misma clave devuelve el mismo pago:
nunca se genera un segundo cobro.
¿Cuánto dura un QR?
La respuesta incluye expires_at con el vencimiento exacto. Si vence
sin pagarse, el pago pasa a expired y puedes crear uno nuevo.
¿Cómo sé que el pago llegó?
Consulta el pago con GET /api/v1/payments/{id}. Cuando TAYPI
confirma el cobro, el estado pasa a completed e incluye la fecha de pago.
¿Puedo revisar mis cobros?
En el portal tienes el listado de tus pagos con su estado, el detalle de cada petición a la API y tus API Keys.
Empieza a cobrar desde tus sistemas
Cuéntanos qué necesitas y damos de alta tu cuenta.