Technical Deep Dive: Implementing x402 Payments

The HTTP 402 Payment Required status code has existed since the dawn of the web, but it was rarely used—until the age of AI agents. Traditional credit cards don’t work for sub-cent microtransactions or autonomous machine-to-machine logic.

The x402 protocol (pioneered by Coinbase and utilized by AgentBureau) finally makes this status code functional.

How x402 Works

When an agent calls a protected API (like sending a physical fax), the server responds with a 402 status and a PAYMENT-LINK header.

The Request/Response Cycle

1. Agent Request: POST /v1/faxes
2. Server Response: 402 Payment Required
   • Header: PAYMENT-LINK: web3+base:0xContractAddress/transfer?amount=1.5&currency=USDC
3. Agent Action: The agent parses the URI, signs a transaction on the Base network, and submits it.
4. Verification: The agent retries the original request with the transaction hash in the X-TX-HASH header.

Python Example: Automated Settlement

import httpx
from web3 import Web3

# Initialize your wallet
w3 = Web3(Web3.HTTPProvider("https://mainnet.base.org"))
account = w3.eth.account.from_key("YOUR_PRIVATE_KEY")

def call_agent_bureau(endpoint, data):
    # 1. Initial Attempt
    resp = httpx.post(endpoint, json=data)

    if resp.status_code == 402:
        payment_uri = resp.headers.get("PAYMENT-LINK")
        # 2. Logic to sign and send USDC on Base
        tx_hash = settle_payment(payment_uri)

        # 3. Retry with proof of payment
        return httpx.post(endpoint, json=data, headers={"X-TX-HASH": tx_hash})

    return resp

Why x402 is Superior

• Zero Latency: No “Adding Credit” or “Billing Cycles.”
• Privacy: No need to link a personal identity or bank account to the agent.
• Precision: Pay exactly for what you use, down to the fraction of a cent.

AgentBureau is built on x402 because it is the only way to build truly autonomous economic actors. Check our x402 reference.