Xenodia Docs
API ReferenceGenerated Reference

Settle an x402 payment and credit its account

Without payment proof this returns HTTP 402 with x402 payment requirements. A successful settlement is credited once using the payment identity. GET is a protocol-compatible payment endpoint, not a safe speculative read.

POST
/v1/payments/topup

Query Parameters

amount_micro?integer
Default5000000
Range1 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.xenodia.xyz/v1/payments/topup"
{
  "status": "string",
  "account_id": 0,
  "wallet_address": "string",
  "amount_added": 0,
  "message": "string"
}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "error": "string",
  "message": "string",
  "request_id": "string"
}