Transactions

Payment verification and settlement

Verify payment validity

post

Body

application/json

Responses

200

Payment verification completed

application/json

400

Bad request - Invalid payment data

application/json

post

/v1/verify

HTTPcURLJavaScriptPython

POST /v1/verify HTTP/1.1
Host: facilitator.x444.io
Content-Type: application/json
Accept: */*
Content-Length: 554

{
  "paymentPayload": {
    "x402Version": 1,
    "scheme": "exact",
    "network": "base-sepolia",
    "payload": null
  },
  "paymentRequirements": {
    "scheme": "exact",
    "network": "base-sepolia",
    "maxAmountRequired": "1000000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb8",
    "resource": "https://api.example.com/weather",
    "description": "Weather data API call",
    "mimeType": "application/json",
    "outputSchema": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "maxTimeoutSeconds": 300,
    "extra": {
      "feePayer": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
    }
  }
}

{
  "isValid": true,
  "payer": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb8",
  "invalidReason": "Insufficient balance"
}

Settle payment on blockchain

post

Body

application/json

Responses

200

Payment settlement completed

application/json

400

Bad request - Invalid settlement data

application/json

post

/v1/settle

HTTPcURLJavaScriptPython

POST /v1/settle HTTP/1.1
Host: facilitator.x444.io
Content-Type: application/json
Accept: */*
Content-Length: 554

{
  "paymentPayload": {
    "x402Version": 1,
    "scheme": "exact",
    "network": "base-sepolia",
    "payload": null
  },
  "paymentRequirements": {
    "scheme": "exact",
    "network": "base-sepolia",
    "maxAmountRequired": "1000000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb8",
    "resource": "https://api.example.com/weather",
    "description": "Weather data API call",
    "mimeType": "application/json",
    "outputSchema": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "maxTimeoutSeconds": 300,
    "extra": {
      "feePayer": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
    }
  }
}

{
  "success": true,
  "txHash": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7...",
  "errorReason": "Insufficient balance"
}