
Developers
Build on a full API, with docs your AI can read.
A REST API for every part of the product, signed webhooks, a Buy button script and a full test mode. Point your coding assistant at the docs MCP server.
send-usage.http
POST https://usage.comecero.com/v1/events
Authorization: Bearer apk_live_...
{
"events": [{
"operation_id": "req_7Hk2p9",
"external_customer_id": "cust_8412",
"metric_key": "ai_tokens",
"quantity": "1250"
}]
}200 · Answer
{
"counted": 1,
"duplicate": 0,
"results": [{
"operation_id": "req_7Hk2p9",
"status": "counted"
}]
}In short
Comecero has a full REST API described in OpenAPI 3.1, covering carts, payments, customers, subscriptions, invoices, products, usage and settings. Webhooks are signed and retried for about 56 hours. A full test mode, team roles, API tokens and a docs MCP server for AI coding tools are included.
Updated
API
What does the API cover?
Carts, payments, customers, subscriptions, invoices, products, usage and settings, all described in one OpenAPI 3.1 file that the reference is built from.
- REST and JSON
- OpenAPI 3.1 description
- Secret and limited tokens, OAuth apps
API reference
POST /v1/carts
Create a cart
POST /v1/payments
Take a payment
GET /v1/subscriptions/{id}
Read a subscription
POST /v1/invoices
Create an invoice
Webhooks
How do I hear about events?
Subscribe to 49 event types, in JSON or XML. Every delivery is signed and retried up to 23 times over about 56 hours. The events log shows each delivery, and you can resend one or send a test.
- 49 event types
- Signed and retried
- Events log with resend
Events log
payment:created_success
200 · 120 ms
Delivered
subscription:renewal_success
500 · retry 2 of 23
Retrying
usage:threshold_reached
200 · 98 ms
Delivered
Resend · Send test
Buy button
What is the quickest way to take a payment?
Add one script tag and a button, and checkout opens over your page. Your page gets a callback when the order is paid.
- One script tag
- A callback when paid
- Works on phone
1<script2 src="https://your-shop.apps.comecero.com/popup.js"3 id="_popup_script"></script>4 5<button class="popup-buy-now"6 data-product_id="daily-serum">Buy now</button>
Daily Glow Serum
$38.00
Buy nowOpens the Comecero checkout on your page
AI tools
Can my AI assistant write the integration?
Connect Claude Code, Cursor, VS Code or ChatGPT to the docs MCP server. Your assistant searches the guides and reads every endpoint's fields while it writes code. Every docs page is also plain Markdown, and the docs publish an llms.txt.
- Docs MCP server
- Markdown pages
- llms.txt
Terminal
$ claude mcp add --transport http comecero-docs https://docs.comecero.com/mcp ✓ Added comecero-docs
How do I send token usage to Comecero?
Post a batch to POST /v1/events with a usage key. Give each event an operation_id, so a resend is counted once.
Source: docs.comecero.com · Usage meter API
- REST API
- Webhooks
- OpenAPI 3.1
- Docs MCP
- llms.txt
Good to know
Where the edges are, so nothing surprises you later.
- There are no published SDKs yet. Use the REST API and the OpenAPI description.
- There is no single sign-on (SAML) for the dashboard.
Questions
Your questions,
answered.
Is there a test mode?
Yes. Test mode keeps its own data and has a test gateway with cards that trigger each result.
Are there SDKs?
Not yet. The API is described in OpenAPI 3.1, so you can generate a client, or let your AI assistant write calls from the docs MCP server.
How are webhooks secured?
Every delivery is signed, so you can check it came from Comecero, and failed deliveries are retried up to 23 times over about 56 hours.
Ready when you are
Grow in every market, on every model.
See how Comecero fits your billing, your processors and the markets you sell in. Book a demo with the team, or start free.
Your revenue review
SampleRevenue slipping away each month
$22,700
Each line comes with the fix that wins it back.



















