api.xfuel.app

{
  "properties": {
    "accounting": {
      "description": "USDC/x402 internal accounting inside the settled amount. Not an on-chain deduction. route_margin_bps is live pricing (default 100).",
      "type": "object"
    },
    "fee_amount": {
      "description": "Legacy TFUEL rail only. Absent on USDC/x402.",
      "type": "string"
    },
    "fee_bps": {
      "description": "Legacy TFUEL protocol fee in bps. Absent on USDC/x402.",
      "type": "integer"
    },
    "gross_amount": {
      "description": "Charged amount. On USDC/x402 this is the amount the payee receives.",
      "type": "string"
    },
    "net_amount": {
      "description": "Legacy TFUEL rail only. Absent on USDC/x402.",
      "type": "string"
    },
    "payment_rail": {
      "enum": [
        "usdc",
        "tfuel"
      ],
      "type": "string"
    },
    "payment_ref": {
      "description": "network:txHash settlement reference",
      "type": [
        "string",
        "null"
      ]
    },
    "settled_amount": {
      "description": "USDC/x402: the on-chain Transfer to the payee. Equals gross_amount once payment_ref exists; null while a rolling bill is unpaid.",
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "enum": [
        "accepted"
      ],
      "type": "string"
    },
    "task_id": {
      "type": "string"
    },
    "verify_url": {
      "description": "public, no-auth receipt page",
      "type": "string"
    }
  },
  "required": [
    "task_id",
    "status",
    "verify_url"
  ],
  "type": "object"
}