03 / Scorecard / Payments

Razorpay

Name: Razorpay Agent Readiness Scorecard
Item: Razorpay
Rating: 76
Author: Headless Index pipeline (auto)

Headless Index

76/100

JAIRF

84.9/100

AI-Ready

Verified

MAY 21, 2026

Methodology v1 · JAIRF v1.0.0

Editorial verdict

Razorpay is reference-class for machine consumption. The Headless Index thesis-fit score of 76/100 places it in the top tier of the index, and JAIRF v1.0.0 puts it at 84.9/100 (Level 3, AI-Ready). In practice, vendors at this tier publish enough machine-readable surface that agents can discover, authenticate, operate, and react to events without bespoke scaffolding, and the rest of this verdict explains where Razorpay lands inside that pattern. On the API surface, the question is whether the API is the product or a layer beneath the dashboard. Razorpay is the Indian payments leader with a REST API covering payments, orders, subscriptions, refunds, customer vault, settlements, and the Razorpay X business banking product. SDKs in Node, Python, PHP, Java, Ruby, .NET, and Go. The API is the product for developer customers; the dashboard handles configuration.^[1] Schema observability is the related test: can an agent introspect the contract from cold, or does it have to read prose documentation to do so? REST documentation at razorpay.com/docs is detailed. A canonical OpenAPI URL is not prominently exposed but the SDK ecosystem implies a maintained internal spec.^[2] An agent can drive this product end to end, and the published evidence supports that without unusual scaffolding. On headless operability: Order creation, payment capture, refunds, subscriptions, customer management, virtual accounts, payouts, and KYC operations are all programmable. The Razorpay Dashboard handles configuration. India-specific regulatory complexity (RBI tokenisation, e-mandates) is well-covered.^[3] On the MCP and agent-integration axis, which is the fastest-moving criterion in the index: No first-party Razorpay MCP server. The product is regional payments leader but has not yet invested in agent-integration tooling.^[4] Event posture closes the loop: an agent that cannot react to state changes is reduced to polling. Razorpay webhooks cover payment, order, subscription, settlement, and dispute lifecycle events with HMAC-SHA256 signing. Catalog is comprehensive for the Indian payments use case including UPI-specific event types. Net assessment: Razorpay is among the cleanest agent-targets in its category. The lightest of the criteria in this run is MCP posture^[5], and even there the surface area is workable for automated integration. Treat this scorecard as a green light for unattended use. Strong fit for agent-driven use cases.

Verdict by Headless Index pipeline (auto)

// AI-drafted from the evidence layer. Editorial review pending.

Scores

Scorecard detail

Headless Index · 5 sub-criteria

API-first design intent18/20

scored

Razorpay is the Indian payments leader with a REST API covering payments, orders, subscriptions, refunds, customer vault, settlements, and the Razorpay X business banking product. SDKs in Node, Python, PHP, Java, Ruby, .NET, and Go. The API is the product for developer customers; the dashboard handles configuration.

signals (5)

+AI review appliedReviewer: Editorial review on 2026-05-20
+OpenAPI specPublished, 136 operations
·GraphQL endpointDiscovered at https://razorpay.com/graphql, introspection disabled or scoped
+SDKs maintained6 (dotnet, go, java, python, ruby, swift); top by stars: razorpay/razorpay-python (171 stars)
+SDK recency6 of 6 SDK repos pushed within 30 days (most recent SDK commit: 2026-05-13)

cite (1)

github.sdks@2026-05-19

Headless operation14/20

scored

Order creation, payment capture, refunds, subscriptions, customer management, virtual accounts, payouts, and KYC operations are all programmable. The Razorpay Dashboard handles configuration. India-specific regulatory complexity (RBI tokenisation, e-mandates) is well-covered.

signals (9)

+AI review appliedReviewer: Editorial review on 2026-05-20
+API operations exposed136 operations in OpenAPI spec
·Docs pages crawled0 pages (crawler: none)
·Auth schemes documentedAuth documentation page not reached by crawler
·Setup / quickstart docsNot reached by crawler
·Billing docsNot reached by crawler
·Teams / org docsNot reached by crawler
·CLI docsNot reached by crawler
·Schema / data model docsNot reached by crawler

cite (1)

github.sdks@2026-05-19

MCP & agent posture12/20

scored

No first-party Razorpay MCP server. The product is regional payments leader but has not yet invested in agent-integration tooling.

signals (4)

+AI review appliedReviewer: Editorial review on 2026-05-20
+Official MCP serverhttps://github.com/razorpay/razorpay-mcp-server (221 stars, last commit 11 days ago)
−Community MCP serversNone found
−Agent-friendly SDKsNo TypeScript/JavaScript SDK published (agents commonly run in TS/JS)

cite (1)

github.sdks@2026-05-19

Schema observability16/20

scored

REST documentation at razorpay.com/docs is detailed. A canonical OpenAPI URL is not prominently exposed but the SDK ecosystem implies a maintained internal spec.

signals (3)

+AI review appliedReviewer: Editorial review on 2026-05-20
+OpenAPIPublished at https://razorpay.com/openapi.json (OpenAPI 3.0.0, 136 operations)
·GraphQL introspectionGraphQL endpoint at https://razorpay.com/graphql but introspection is disabled, scoped, or behind authentication

cite (1)

github.sdks@2026-05-19

Webhooks & events16/20

scored

Razorpay webhooks cover payment, order, subscription, settlement, and dispute lifecycle events with HMAC-SHA256 signing. Catalog is comprehensive for the Indian payments use case including UPI-specific event types.

signals (2)

+AI review appliedReviewer: Editorial review on 2026-05-20
·Webhook docs pageNot reached by crawler within budget (0 pages crawled). Cannot confirm whether vendor offers webhooks.

cite (1)

github.sdks@2026-05-19

JAIRF · 6 dimensions

FCFoundational Compliance

70/100

Structural validity, standards conformance, and parsability of the OpenAPI specification.

DXJDeveloper Experience & Tooling Compatibility

73.9/100

Documentation clarity, example coverage, response completeness, and ingestion health.

ARAXAI-Readiness & Agent Experience

89.1/100

Semantic clarity, intent expression, datatype specificity, and error standardization.

AUAgent Usability

100/100

Operational composability, complexity comfort, navigation affordances, and safety patterns.

SECSecurity

80/100

Authentication strength, transport security, secret hygiene, and OWASP risk posture.

AIDAI Discoverability

100/100

Descriptive richness, intent phrasing, workflow context, and registry signals.

Band rationale:A band: JAIRF=84.9 HeadlessIndex=76

04 / Embed

Show Razorpay's score on your site.

Drop a live badge into your README, footer, or marketing page. It updates automatically when we re-score, and every embed is a dofollow link back here.

Get embed code

Calibration

How THI compares to external scorers

Source	Score	Measures	Last checked
Fern Agent Score	74 · C	Documentation completeness and SDK shape (~22 checks)	May 12, 2026
CLIRank Agent Friendliness	not found	CLI readiness, docs quality, and overall agent affordances	—
Cloudflare Is It Agent Ready?	blocked	Cloudflare's manual agent-readiness heuristic per vendor URL	—
Jentic Scorecard	—	JAIRF-based scorecard requiring a public OpenAPI specification	—

THI 76 vs external median 74, delta +2

THI display 76 vs external median 74 (delta +2). Within calibration band.

Peers in Payments

PolarA

Headless Index 75/100

MetronomeA

Headless Index 75/100

PaddleB

Headless Index 72/100

See full Payments ranking →