Introducción
API v0.1.0En esta página
Rutiva es una API de pagos C2P (Customer-to-Payment) para Venezuela. Esta guía explica cómo aceptar pagos en tu sitio o aplicación.
Qué es Rutiva
Rutiva expone una capa de developer-experience sobre la red C2P bancaria. Tu backend crea un payment_intent, tu frontend confirma con el OTP que el cliente recibe por SMS de su banco, y nosotros notificamos el resultado vía webhook.
Conceptos clave
| Concepto | Descripción |
|---|---|
payment_intent | Objeto que representa un pago en curso. Ciclo de vida: created → succeeded / failed / canceled. |
sk_xxx | Secret key. Se usa en tu backend para crear intents. Nunca exponer al navegador. |
client_secret | Token de un solo uso vinculado a un payment_intent. Se entrega al navegador para confirmar el pago sin exponer sk_. |
whsec_xxx | Signing secret del webhook. Verifica que las notificaciones vienen de Rutiva. |
| OTP | Código que el banco del cliente le envía por SMS. El cliente lo escribe en tu UI para confirmar. |
Flujo recomendado (Stripe-style)
bash
┌──────────┐ 1. crear intent ┌─────────────┐ 2. crear intent (sk_) ┌────────────┐
│ Cliente │ ───────────────────▶ │ Tu backend │ ──────────────────────▶ │ Rutiva API │
│ (browser)│ │ │ │ │
│ │ ◀─── client_secret ─ │ │ ◀─── client_secret ──── │ │
│ │ └─────────────┘ │ │
│ │ 3. confirm con OTP + client_secret │ │
│ │ ─────────────────────────────────────────────────────────▶ │ │
│ │ ◀─── payment_intent (succeeded / failed) ───────────────────│ │
└──────────┘ └────────────┘El backend del comerciante guarda sk_xxx y crea intents. El navegador solo recibe el client_secret y confirma el pago. La sk_ jamás toca el frontend.
Base URL
bash
# Producción
https://rutiva-api.onrender.com
# Swagger UI interactivo
https://rutiva-api.onrender.com/docs