Razor Dvara

v0.1.0 · 2026-08-22 업데이트 · COD 상거래를 위한 게이트형 에이전트 체크아웃

"결제 수단을 설정하려고 하는데 COD 주문에 추가 금액을 청구하고 싶습니다." — Shopify 커뮤니티의 판매자, 2025년 1월 1일 (스레드, 답글 0개)

COD는 여전히 인도 전자상거래 주문의 약 절반을 차지합니다. 또한 반품의 대부분을 유발합니다: Tier-2/3 시장은 COD 비율이 58–64%이지만 RTO 물량의 76–83%를 차지합니다 (bepragma.ai, 2026년 6월). 배송 실패 1건당 물류 비용만 ₹180–240이 발생합니다.

Razor Dvara를 사용하면 판매자는 COD 규칙을 한 번만 설정하면 됩니다. AI 구매자는 구조화된 답변을 받습니다. 감사 추적은 무슨 일이 있었는지 증명합니다.

이 도구가 하는 일

모든 응답에는 reason_code와 rule_id가 포함됩니다. 모든 결정은 감사 추적에 추가됩니다. 백엔드가 중단되면 엣지 캐시가 degraded 플래그와 함께 오래된 데이터를 제공하고 주문을 선결제 전용으로 완료합니다.

Related MCP server: ecommerce-store-mcp

아키텍처

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

전체 아키텍처 및 프로토콜 계보: docs/architecture.md

정직한 제약 사항

• 오퍼는 대시보드에서만 생성할 수 있습니다. 기존 오퍼 ID를 연결할 뿐, 새로 만들지 않습니다.

• RTO/COD 인텔리전스는 공개 API가 없는 대시보드 전용입니다. 당사의 스코어러는 게시된 업계 요율에서 보정된 가중치를 사용합니다 — ML이 아닙니다.

• 서비스 가능성은 우리가 직접 구현하는 인바운드 계약입니다. Magic Checkout의 문서화된 10초 하드 킬이 우리가 보장하는 SLA입니다.

• 테스트 모드 전용 (rzp_test_ 키). 실제 금전 거래는 없습니다.

구축하지 않는 것

• 채팅 UI — 이는 에이전트와 금전 작업 사이의 인프라이며, 대화형 제품이 아닙니다.

• RTO 점수 산정을 위한 실제 ML — 배송 결과 데이터 없이 보정된 가중치는 오해를 불러일으키는 정밀도를 생성할 것입니다.

• API를 통한 오퍼 생성 — Razorpay가 이를 노출하지 않습니다. 그렇지 않은 척하는 것은 부정직한 것입니다.

• 프로덕션 배포 — 테스트 키를 사용한 빌드아톤 프로토타입.

증거

모든 주장은 확인 가능한 산출물에 연결됩니다: docs/EVIDENCE.md

테스트

pnpm install
pnpm test

규칙 평가, 위험 점수 산정, 서비스 가능성, 캐시 저하, Shopify 함수 동작, 엔드투엔드 파이프라인 결정론을 다루는 7개 파일의 36개 테스트.