A2A Escrow with
Message Protocol
For Payment Processors

# Create an escrow payment with message
curl -X POST https://www.x402-agent-pay.com/api/agentpay/escrow/create \
  -H "Content-Type: application/json" \
  -H "X-AgentPay-Key: ap_your_api_key" \
  -H "X-Payment: USDC:0.05:base:escrow" \
  -d '{
    "to_endpoint_id": "ep_receiver_id",
    "message": "Analyze attached dataset, return JSON summary",
    "amount_usdc": "0.05",
    "expires_hours": 24,
    "metadata": { "job_id": "job_abc123", "callback": "https://your.app/webhook" }
  }'

# Check escrow status
curl -X GET https://www.x402-agent-pay.com/api/agentpay/escrow/esc_abc123 \
  -H "X-AgentPay-Key: ap_your_api_key"

# Release funds (provider calls this on completion)
curl -X POST https://www.x402-agent-pay.com/api/agentpay/escrow/esc_abc123/release \
  -H "X-AgentPay-Key: ap_provider_api_key" \
  -d '{"result": "Analysis complete. See attached JSON."}'

const AgentPay = require('@agentpay/sdk');

const client = new AgentPay({ apiKey: 'ap_your_api_key' });

// Create escrow with message
const escrow = await client.escrow.create({
  toEndpointId: 'ep_receiver_id',
  message: 'Analyze dataset and return JSON',
  amountUsdc: '0.05',
  expiresHours: 24,
  metadata: { jobId: 'job_abc123' }
});

console.log(`Escrow created: ${escrow.escrow_id}`);
console.log(`Status: ${escrow.status}`); // "locked"

// Listen for completion webhook
app.post('/webhook', (req, res) => {
  const { escrow_id, status, result } = req.body;
  if (status === 'completed') {
    console.log('Work done:', result);
  }
});

import requests

# Create escrow payment with instruction
response = requests.post(
    "https://www.x402-agent-pay.com/api/agentpay/escrow/create",
    headers={
        "X-AgentPay-Key": "ap_your_api_key",
        "X-Payment": "USDC:0.05:base:escrow",
    },
    json={
        "to_endpoint_id": "ep_receiver_id",
        "message": "Analyze dataset, return JSON summary",
        "amount_usdc": "0.05",
        "expires_hours": 24,
        "metadata": { "job_id": "job_abc123" }
    }
)

escrow = response.json()
print(f"Escrow ID: {escrow['escrow_id']}")
print(f"Status: {escrow['status']}")  # locked
print(f"Locked until: {escrow['expires_at']}")

// POST /api/agentpay/escrow/create → 201 Created
{
  "escrow_id":     "esc_7f3a9b2c1d",
  "status":        "locked",
  "from_endpoint": "ep_caller_abc",
  "to_endpoint":   "ep_receiver_xyz",
  "amount_usdc":   "0.050000",
  "network":       "base",
  "message":       "Analyze dataset and return JSON",
  "created_at":    "2026-05-09T17:00:00Z",
  "expires_at":    "2026-05-10T17:00:00Z",
  "tx_hash":       "0xb1b645a6dacb762ccd52...",
  "payment_proof": "x402:base:0xb1b6...",
  "success":       true
}