Payments is the one category that documents how to undo a call, and still cannot rehearse one

Payments is the one category that documents how to undo a call, and still cannot rehearse one

The Payments tag is the biggest scored category on apis.io that is clearly ahead of the market: 1,476 providers and 997 APIs, with 1,449 of them scored, averaging 31.9 on the Kin Score against 21.9 for the rest of the catalog. It is also not one thing. The helper splits it into four senses, checkout and subscription billing at 24.9% of members, open banking at 22.0%, crypto and stablecoin payments at 13.0%, and remittances at 6.9%, with a third unassigned. The five that lead the tag page are all merchant-side: the money moving in at a checkout, a point of sale, or an invoice. That is the sense this post is about, and it is the sense where the category has done something no other tag in this series has managed.

The five, in rank order. Airwallex leads at 91.4, exemplar, carried by access clarity at 100.0, developer ergonomics at 95.8, and operational transparency at 94.7, across 14 API pages, an MCP server, and an agentic access profile. It is the cross-border member of the five, multi-currency accounts and foreign exchange for businesses paying and getting paid across borders. Shopify follows at 88.0, exemplar, with developer ergonomics at 96.4 and 102 API pages, the widest surface in the group, and it is the only one of the five, and one of 0.2% of the whole tag, with the agentic commerce dimension lit. Stripe scores 87.0, exemplar, with operational transparency at 100.0, 71 API pages, and two MCP servers, held back by discoverability at 48.1, the lowest of the five. Lightspeed Commerce scores 83.7, exemplar, the point-of-sale and restaurant platform whose payments product rides on 58 API pages, with contract governance at 4.5, the lowest facet score anywhere in this group. The tag page’s fifth slot is Cvent Registration, an event registration product that reaches the tag through two transaction APIs among its 63 pages, so I have taken the next name down instead. Tabby scores 80.6, exemplar, the buy-now-pay-later provider for Saudi Arabia and the UAE, carried by developer ergonomics at 92.9 and contract quality at 78.7, the highest contract quality of the five, on just 4 API pages.

Against the rest of the catalog the tag is ahead on every measure, and the shape of the lead is the finding. The median is 33.8 against 15.0. Exemplar is 3.7% of the tag against 1.3% of the rest, strong 10.2% against 4.1%, developing 24.6% against 12.6%. Minimal is 19.2% against 35.9%. Spec presence is lit for 56.4% against 32.2%, auth clarity for 62.7% against 37.8%, error semantics for 42.8% against 20.9%. The five leaders share one weakness, and it is the one the whole category shares: contract governance sits at 47.0 for Airwallex, Shopify, and Tabby, 33.3 for Stripe, and 4.5 for Lightspeed. The best payments contracts on apis.io say very little about how they change.

On agent readiness the category averages 19.1 against 10.9, with 8.3% agent-native against 1.4% and 37.1% human-only against 54.2%. Three of the five, Airwallex at 61.6, Stripe at 58.3, and Shopify at 55.5, are agent-native. The dimensions where payments leads the market most are the safety ones, and this is where the tag separates from every category profiled so far. Idempotency is lit for 21.4% of payments providers against 3.0% of the rest, a gap of 18.4 points. Reversibility is documented for 27.3% against 6.2%, a gap of 21.1. The event surface is described for 34.2% against 9.7%. Transactional email, profiled two days ago, had idempotency at 19.4% and reversibility at 36.1% inside a much smaller and better-scored cohort. Payments has them at scale, across 1,449 scored providers, because a duplicate charge is a chargeback and a refund is a product feature. All five leaders light idempotency, reversibility, and the event surface. The one safety dimension nobody has is dry-run mode, lit for 0.1% of the tag, one provider in a thousand.

The band gate confirms it rather than complicating it. Agent-native requires idempotency and a stable error envelope on top of the score floor, and the three that clear it clear it on merit: Airwallex, Stripe, and Shopify all light idempotency and error semantics. Lightspeed at 37.5 and Tabby at 42.8 are agent-ready, and both light idempotency too. What holds them one rung down is the identity layer. Lightspeed has no protected resource metadata and no dynamic client registration, and no agentic access profile at all. Tabby has none of the three identity dimensions. Airwallex and Stripe have all of them, which is what an agent needs to register itself and act under a delegated grant, and Shopify has protected resource metadata but neither delegation nor registration. The category is ahead on what a payment call does. It is uneven on who is allowed to make one.

That is the finding. Payments is the first category this series has profiled that treats an agent’s mistake as its own problem. It documents how to retry a call safely and how to reverse one, at rates three to seven times the rest of the catalog, because it learned those lessons from human integrators long before agents arrived. What it has not built is the rehearsal: one provider in a thousand lets a caller try a charge without making it. The five at the top have everything an agent needs to act and undo. None of them lets it practice first.

← Vespa built a public MCP server, measured it against the CLI, and the catalog has not lit it yet
Redocly documents MCP servers in OpenAPI, and its own agent door is undocumented →