surfboard_white
Book a demo

Developers Changelog Developer Docs

Developer Docs v2026.9

The hosted MCP server and the site's API reference catch up with the npm package. 237 endpoints across 29 sections, six new sections, five new webhook events, and one version number read from one place.

Released
Product
Developer Docs
Version
v2026.9

🔢 One Version, Read From One Place

Category: Developer Experience

The server card at /.well-known/mcp reported 1.3.0 after @surfboardpayments/surf-mcp 1.3.1 had shipped, and would have kept saying so after a redeploy: the endpoint carried the version as a string constant, while the sibling server-card.json asked the npm registry at build time. The two could disagree, and did.

  • Both cards, and the MCP initialize response, now read the version from the installed npm package at build time. Bumping the dependency is the whole release step
  • No registry lookup during a build, so a build is reproducible and cannot silently fall back to an old number

📚 Reference Synced With Upstream

Category: Documentation

The hosted MCP server, the developer search, the AI endpoints and the Carbon OpenAPI document all answer from the site’s own copy of the reference, and that copy had stopped at 157 endpoints while the npm package moved on. The site is now synced with the same upstream documentation the package is built from.

  • 237 endpoints across 29 sections, up from 157 across 23
  • Six new sections: Electronic Cash Register (ECR) V2, Partners, RFID, Webhooks API, Transactions and Bin Ranges
  • Expanded sections: Terminals 21 to 33, Product Catalog 16 to 25, Merchants 12 to 19, Stores 8 to 12, Payments 5 to 10, Logistics 7 to 10, Receipts 5 to 8, Service Providers 5 to 8, Payment Methods 4 to 7
  • NFC Reading removed, superseded upstream by the RFID API, along with ten orphaned pages the index no longer listed
  • Every reference page regenerated from upstream: path parameter tables, consistent prerequisites, and fuller error sections
  • The /openapi/carbon.json document grows from 148 to 236 operations over 179 paths, and still passes the reference test suite
  • The Create Merchant and Check Application Status pages keep the prefill documentation added in Carbon Platform v2026.9, merged with upstream’s richer status response tables

🔔 Five New Webhook Events

Category: Documentation

The webhook catalog gains two sections, Stores and Terminals, and the hosted MCP’s search_webhook_docs finds them.

  • store.activated and store.onboarded
  • terminal.hardware.registered, terminal.online.registered and terminal.softpos.registered