Clinical codes · SMOKE
Payment smoke
Confirms the x402 gate and PAYMENT-RESPONSE. Returns {ok: true, service: magent} after settle.
Markdown: /docs/tools/ping.md · Canonical: https://magentlab.com/docs/tools/ping
Not a medical device. Not a diagnosis or dosing recommendation.
What it computes
Confirms the x402 gate and PAYMENT-RESPONSE. Returns {ok: true, service: magent} after settle.
When to use
Payment plumbing check. Not a product clinical tool.
When not to use
- Not a product tool.
- Not listed on Bazaar.
- Takes no clinical input.
Formula
n/a — payment smoke; returns {ok: true, service: magent}
Citation
- Title
- magent payment smoke
- Authors
- magent
- Source
- magent
- DOI
- none
Worked example
Settled ping
Given:
- Settle the x402 quote.
- Response is ok=true, service=magent.
Also searched as
- x402 ping
- payment smoke
- paywall test
Try
Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.
Full URL: https://api.magentlab.com/v1/tools/ping
Call
Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params
return HTTP 400 before any quote or charge.
curl -i -H "Accept: application/json" "https://api.magentlab.com/v1/tools/ping"
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
probe |
string | optional | Ignored. Payment smoke test takes no input. |
Response
| Field | Type | Description |
|---|---|---|
ok |
boolean | Always true after a successful settle |
service |
string | Product name |
Example JSON
Machine form of the same example. Frozen fixture. Not a live lookup.
{
"ok": true,
"service": "magent"
}
Client errors (HTTP 400)
Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.
| HTTP | Code | When |
|---|
Related tools
None.
Payment
Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. Magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64
PAYMENT-REQUIRED
header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake
and shared payment errors: Payments.
Guarantees
- HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON.
- exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
- HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
- Execution is timeout-bounded and concurrency-capped.
- Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.
- Not listed on Bazaar. Do not call this for production work.