curl https://api.xenarch.dev/v1/links/JJjIwDyV4N1CG9g8AHMxfdJ9
{
"link_id": "JJjIwDyV4N1CG9g8AHMxfdJ9",
"params": {
"to": {"state": "lit", "value": "0xYourWalletAddress"},
"amount": {"state": "lit", "value": "25.00"},
"currency": {"state": "lit", "value": "USDC"},
"network": {"state": "lit", "value": "base"},
"kind": {"state": "lit", "value": "checkout"},
"product_name": {"state": "lit", "value": "Consulting hour"}
},
"signed_params": "0x...",
"status": "active",
"kind": "checkout",
"created_at": "2026-11-17T12:00:00Z",
"expires_at": null,
"paid_and_single_use": false,
"latest_state": "CONFIRMED",
"latest_payment": {
"tx_hash": "0x...",
"block_number": 38120455,
"status": "confirmed",
"value_usdc": "25.00",
"expected_usdc": "25.00",
"from_address": "0xBuyerWallet...",
"confirmed_at": "2026-11-17T12:04:10Z",
"reference_id": null
},
"cap_min_micro": null,
"cap_suggested_micro": null,
"period_cap_suggested_micro": null,
"period_count_suggested": null
}
Links
Get Link
Read one pay link. The owner’s dashboard session gets full detail with stats. Any other caller gets the public subset the hosted checkout renders.
GET
/
v1
/
links
/
{link_id}
curl https://api.xenarch.dev/v1/links/JJjIwDyV4N1CG9g8AHMxfdJ9
{
"link_id": "JJjIwDyV4N1CG9g8AHMxfdJ9",
"params": {
"to": {"state": "lit", "value": "0xYourWalletAddress"},
"amount": {"state": "lit", "value": "25.00"},
"currency": {"state": "lit", "value": "USDC"},
"network": {"state": "lit", "value": "base"},
"kind": {"state": "lit", "value": "checkout"},
"product_name": {"state": "lit", "value": "Consulting hour"}
},
"signed_params": "0x...",
"status": "active",
"kind": "checkout",
"created_at": "2026-11-17T12:00:00Z",
"expires_at": null,
"paid_and_single_use": false,
"latest_state": "CONFIRMED",
"latest_payment": {
"tx_hash": "0x...",
"block_number": 38120455,
"status": "confirmed",
"value_usdc": "25.00",
"expected_usdc": "25.00",
"from_address": "0xBuyerWallet...",
"confirmed_at": "2026-11-17T12:04:10Z",
"reference_id": null
},
"cap_min_micro": null,
"cap_suggested_micro": null,
"period_cap_suggested_micro": null,
"period_count_suggested": null
}
curl https://api.xenarch.dev/v1/links/JJjIwDyV4N1CG9g8AHMxfdJ9
{
"link_id": "JJjIwDyV4N1CG9g8AHMxfdJ9",
"params": {
"to": {"state": "lit", "value": "0xYourWalletAddress"},
"amount": {"state": "lit", "value": "25.00"},
"currency": {"state": "lit", "value": "USDC"},
"network": {"state": "lit", "value": "base"},
"kind": {"state": "lit", "value": "checkout"},
"product_name": {"state": "lit", "value": "Consulting hour"}
},
"signed_params": "0x...",
"status": "active",
"kind": "checkout",
"created_at": "2026-11-17T12:00:00Z",
"expires_at": null,
"paid_and_single_use": false,
"latest_state": "CONFIRMED",
"latest_payment": {
"tx_hash": "0x...",
"block_number": 38120455,
"status": "confirmed",
"value_usdc": "25.00",
"expected_usdc": "25.00",
"from_address": "0xBuyerWallet...",
"confirmed_at": "2026-11-17T12:04:10Z",
"reference_id": null
},
"cap_min_micro": null,
"cap_suggested_micro": null,
"period_cap_suggested_micro": null,
"period_count_suggested": null
}
Two views
- Public subset. No authentication. This is what the hosted checkout at
pay.xenarch.comreads: the signed params, status, expiry, the latest payment and, for metered subscriptions, the suggested spending caps. Each public read counts as a view of the link. - Owner detail. Returned when the request carries the
xen_sessioncookie of the wallet that owns the link. It addsstats(views, paid count, revenue, payer wallets, last payment time),metadata,suggested_cap_usdcandsuggested_period_cap_usdc. A merchant API key does not return owner detail on this endpoint.
signed_params against params on every read and returns 403 if they no longer match.
Fields
| Field | Description |
|---|---|
status | active, expired or revoked. An active link past expires_at reads as expired. |
latest_state | Where the checkout should land: AWAIT_PAY, TX_SUBMITTED, CONFIRMED, UNDERPAID, OVERPAID, EXPIRED, REVOKED or PAID |
latest_payment | The most recent payment on the link, or null. status is confirmed, underpaid or overpaid. Amounts are decimal USDC strings. reference_id is the invoice number on auto-numbered invoices. |
paid_and_single_use | true once a single-use link has been paid |
latest_payment to show state in your UI. To fulfill orders, rely on a verified webhook.
Errors
| Status | Meaning |
|---|---|
403 | The stored params no longer match the signature |
404 | No link with this id |
Response
Successful Response
- PayLinkDetailResponse
- PublicPayLinkResponse