API console

Every endpoint, raw.

The full facilitator surface — run the real GET endpoints and see the actual JSON come back. POST endpoints are shown illustratively; use the guided demo to trigger a real payment.

GET /health

Liveness check — service status, uptime, catalog size, current commit.

GET https://vellar-facilitator.onrender.com/health

GET /supported

Advertises the schemes, networks, and settlement signers this facilitator supports.

GET https://vellar-facilitator.onrender.com/supported

GET /discovery/resources

Lists the live Bazaar catalog — every resource this facilitator has seen paid for.

GET https://vellar-facilitator.onrender.com/discovery/resources

GET /discovery/search

Keyword search over the Bazaar catalog. Takes a `query` param.

GET https://vellar-facilitator.onrender.com/discovery/search

POST /verify

Re-simulates a payment to check it's valid, without settling it on-chain. Free to call.

POST https://vellar-facilitator.onrender.com/verify

Illustrative request body

RequestPOST

{
  "paymentPayload": {
    "x402Version": 2,
    "resource": { "url": "https://vellar-seller-demo.onrender.com/quote" },
    "accepted": {
      "scheme": "exact",
      "network": "stellar:testnet",
      "amount": "1000000",
      "asset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
      "payTo": "GAATVGLRHZXFC66GEN5QNKD56HC5JJZVHQ3P7ZJNVCCI4WKLN44FICSC",
      "maxTimeoutSeconds": 120,
      "extra": { "areFeesSponsored": true }
    },
    "payload": "<scheme-specific: signed Stellar transaction envelope + auth entry, base64 XDR>"
  },
  "paymentRequirements": {
    "scheme": "exact",
    "network": "stellar:testnet",
    "amount": "1000000",
    "asset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
    "payTo": "GAATVGLRHZXFC66GEN5QNKD56HC5JJZVHQ3P7ZJNVCCI4WKLN44FICSC",
    "maxTimeoutSeconds": 120,
    "extra": { "areFeesSponsored": true }
  }
}

Use the guided demo page to trigger these → Go to the demo

POST /settle

Submits a signed payment on-chain and sponsors the network fee.

POST https://vellar-facilitator.onrender.com/settle

Illustrative request body

RequestPOST

{
  "paymentPayload": {
    "x402Version": 2,
    "resource": { "url": "https://vellar-seller-demo.onrender.com/quote" },
    "accepted": {
      "scheme": "exact",
      "network": "stellar:testnet",
      "amount": "1000000",
      "asset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
      "payTo": "GAATVGLRHZXFC66GEN5QNKD56HC5JJZVHQ3P7ZJNVCCI4WKLN44FICSC",
      "maxTimeoutSeconds": 120,
      "extra": { "areFeesSponsored": true }
    },
    "payload": "<scheme-specific: signed Stellar transaction envelope + auth entry, base64 XDR>"
  },
  "paymentRequirements": {
    "scheme": "exact",
    "network": "stellar:testnet",
    "amount": "1000000",
    "asset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
    "payTo": "GAATVGLRHZXFC66GEN5QNKD56HC5JJZVHQ3P7ZJNVCCI4WKLN44FICSC",
    "maxTimeoutSeconds": 120,
    "extra": { "areFeesSponsored": true }
  }
}

Use the guided demo page to trigger these → Go to the demo