Razor Dvara

v0.1.0 · actualizado 2026-08-22 · checkout agéntico controlado para COD

"Estoy intentando configurar métodos de pago para los que quiero cobrar un importe adicional por los pedidos COD." — comerciante de la Comunidad de Shopify, 1 de enero de 2025 (hilo, sin respuestas)

El COD sigue siendo ~la mitad de los pedidos del comercio electrónico indio. También provoca la mayoría de las devoluciones: los mercados Tier-2/3 registran un 58–64 % de COD, pero un 76–83 % del volumen de RTO (bepragma.ai, jun. 2026). Cada entrega fallida cuesta entre ₹180 y ₹240 solo en logística.

Razor Dvara permite a los comerciantes definir las reglas de COD una sola vez. Los compradores de IA reciben respuestas estructuradas. La pista de auditoría demuestra lo que ha ocurrido.

Qué hace

Toda respuesta incluye reason_code y rule_id. Cada decisión se añade a la pista de auditoría. Si el backend cae, la caché de borde sirve datos obsoletos con un indicador de degradación y completa el pedido en modo solo prepago.

Related MCP server: ecommerce-store-mcp

Arquitectura

AI buyer / checkout agent
         |
         | MCP (streamable HTTP)
         v
+-------------------------------------------+
| Razor Dvara MCP Server                    |
| 5 tools · zero overlap w/ official 45    |
+-------------------+-----------------------+
                    |
                    v
+-------------------------------------------+
| Policy Engine (src/gates/)                |
| merchant caps · PIN rules → reason + ID  |
+-------------------+-----------------------+
                    |
                    v
+-------------------------------------------+
| Audit Trail (Cloudflare D1)              |
| sequence numbers · UTC · append-only    |
+-------------------+-----------------------+
                    |
                    v
+-------------------------------------------+
| SWR Edge Cache                           |
| 8s origin timeout → stale fallback       |
| degraded flag → fail-closed COD          |
+-------------------------------------------+

Shopify side: Payment Customization Function
  keyed on dvara.cod.eligible metafield
  hides COD when any cart line ineligible

Arquitectura completa con el linaje del protocolo: docs/architecture.md

Limitaciones honestas

• Las ofertas solo se crean desde el panel. Nos limitamos a asociar IDs de ofertas existentes; no generamos nuevas.

• RTO/COD Intelligence existe solo en el panel, sin API pública. Nuestro puntuador usa pesos calibrados a partir de tasas publicadas del sector; no es ML.

• La capacidad de servicio es un contrato de entrada que implementamos nosotros mismos. La interrupción forzosa de 10 segundos documentada por Magic Checkout es el SLA que garantizamos.

• Solo modo de prueba (claves rzp_test_). No se mueve dinero real.

Lo que NO construiremos

• Interfaz de chat: esto es infraestructura entre agentes y acciones de dinero, no un producto conversacional.

• ML real para la puntuación de RTO: calibrar pesos sin datos de resultados de entrega produciría una precisión engañosa.

• Creación de ofertas por API: Razorpay no la expone; fingir lo contrario sería deshonesto.

• Despliegue en producción: prototipo de buildathon con claves de prueba.

Evidencia

Cada afirmación se corresponde con un artefacto comprobable: docs/EVIDENCE.md

Pruebas

pnpm install
pnpm test

36 pruebas en 7 archivos que cubren la evaluación de reglas, la puntuación de riesgo, la combinatoria de servicio, la degradación de la caché, el comportamiento de funciones de Shopify y el determinismo de extremo a extremo del pipeline.