Settle an x402 v2 payment (co-sign + submit to Solana)
curl --request POST \
--url https://facilitator.x84.ai/settle \
--header 'Content-Type: application/json' \
--data '
{
"paymentPayload": {
"x402Version": 1,
"accepted": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": [
"atomic",
"attestation",
"delegated"
]
}
},
"payload": {
"transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm..."
},
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"extensions": {
"mode": "atomic",
"receiptPda": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
"delegationPda": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"delegate": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"signature": "<string>",
"timestamp": 1708700000,
"paymentId": "a1b2c3d4e5f6",
"txSignature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"payer": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"amount": "1000000"
}
},
"paymentRequirements": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": [
"atomic",
"attestation",
"delegated"
]
}
}
}
'import requests
url = "https://facilitator.x84.ai/settle"
payload = {
"paymentPayload": {
"x402Version": 1,
"accepted": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": ["atomic", "attestation", "delegated"]
}
},
"payload": { "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm..." },
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"extensions": {
"mode": "atomic",
"receiptPda": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
"delegationPda": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"delegate": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"signature": "<string>",
"timestamp": 1708700000,
"paymentId": "a1b2c3d4e5f6",
"txSignature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"payer": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"amount": "1000000"
}
},
"paymentRequirements": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": ["atomic", "attestation", "delegated"]
}
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
paymentPayload: {
x402Version: 1,
accepted: {
scheme: 'exact',
network: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
asset: 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
amount: '1000000',
payTo: '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
maxTimeoutSeconds: 60,
resource: 'https://api.x84.ai/a2a/agent-abc/tasks/send',
description: 'Query agent-abc for market analysis',
extra: {
feePayer: '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
name: 'Agent Query Fee',
agentMint: '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
programId: 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
settlementModes: ['atomic', 'attestation', 'delegated']
}
},
payload: {
transaction: 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...'
},
resource: 'https://api.x84.ai/a2a/agent-abc/tasks/send',
extensions: {
mode: 'atomic',
receiptPda: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
delegationPda: '9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin',
delegate: 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
signature: '<string>',
timestamp: 1708700000,
paymentId: 'a1b2c3d4e5f6',
txSignature: '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW',
payer: 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
amount: '1000000'
}
},
paymentRequirements: {
scheme: 'exact',
network: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
asset: 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
amount: '1000000',
payTo: '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
maxTimeoutSeconds: 60,
resource: 'https://api.x84.ai/a2a/agent-abc/tasks/send',
description: 'Query agent-abc for market analysis',
extra: {
feePayer: '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
name: 'Agent Query Fee',
agentMint: '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
programId: 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
settlementModes: ['atomic', 'attestation', 'delegated']
}
}
})
};
fetch('https://facilitator.x84.ai/settle', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://facilitator.x84.ai/settle",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'paymentPayload' => [
'x402Version' => 1,
'accepted' => [
'scheme' => 'exact',
'network' => 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
'asset' => 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
'amount' => '1000000',
'payTo' => '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
'maxTimeoutSeconds' => 60,
'resource' => 'https://api.x84.ai/a2a/agent-abc/tasks/send',
'description' => 'Query agent-abc for market analysis',
'extra' => [
'feePayer' => '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
'name' => 'Agent Query Fee',
'agentMint' => '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
'programId' => 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
'settlementModes' => [
'atomic',
'attestation',
'delegated'
]
]
],
'payload' => [
'transaction' => 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...'
],
'resource' => 'https://api.x84.ai/a2a/agent-abc/tasks/send',
'extensions' => [
'mode' => 'atomic',
'receiptPda' => '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
'delegationPda' => '9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin',
'delegate' => 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
'signature' => '<string>',
'timestamp' => 1708700000,
'paymentId' => 'a1b2c3d4e5f6',
'txSignature' => '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW',
'payer' => 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
'amount' => '1000000'
]
],
'paymentRequirements' => [
'scheme' => 'exact',
'network' => 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
'asset' => 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
'amount' => '1000000',
'payTo' => '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
'maxTimeoutSeconds' => 60,
'resource' => 'https://api.x84.ai/a2a/agent-abc/tasks/send',
'description' => 'Query agent-abc for market analysis',
'extra' => [
'feePayer' => '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
'name' => 'Agent Query Fee',
'agentMint' => '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
'programId' => 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
'settlementModes' => [
'atomic',
'attestation',
'delegated'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://facilitator.x84.ai/settle"
payload := strings.NewReader("{\n \"paymentPayload\": {\n \"x402Version\": 1,\n \"accepted\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n },\n \"payload\": {\n \"transaction\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...\"\n },\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"extensions\": {\n \"mode\": \"atomic\",\n \"receiptPda\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n \"delegationPda\": \"9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin\",\n \"delegate\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"signature\": \"<string>\",\n \"timestamp\": 1708700000,\n \"paymentId\": \"a1b2c3d4e5f6\",\n \"txSignature\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW\",\n \"payer\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"amount\": \"1000000\"\n }\n },\n \"paymentRequirements\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://facilitator.x84.ai/settle")
.header("Content-Type", "application/json")
.body("{\n \"paymentPayload\": {\n \"x402Version\": 1,\n \"accepted\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n },\n \"payload\": {\n \"transaction\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...\"\n },\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"extensions\": {\n \"mode\": \"atomic\",\n \"receiptPda\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n \"delegationPda\": \"9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin\",\n \"delegate\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"signature\": \"<string>\",\n \"timestamp\": 1708700000,\n \"paymentId\": \"a1b2c3d4e5f6\",\n \"txSignature\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW\",\n \"payer\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"amount\": \"1000000\"\n }\n },\n \"paymentRequirements\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://facilitator.x84.ai/settle")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"paymentPayload\": {\n \"x402Version\": 1,\n \"accepted\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n },\n \"payload\": {\n \"transaction\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...\"\n },\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"extensions\": {\n \"mode\": \"atomic\",\n \"receiptPda\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n \"delegationPda\": \"9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin\",\n \"delegate\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"signature\": \"<string>\",\n \"timestamp\": 1708700000,\n \"paymentId\": \"a1b2c3d4e5f6\",\n \"txSignature\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW\",\n \"payer\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"amount\": \"1000000\"\n }\n },\n \"paymentRequirements\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"transaction": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"payer": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu"
}x402
Settle an x402 v2 payment (co-sign + submit to Solana)
Verifies the payment payload, then co-signs the transaction as fee payer and submits it to Solana.
Settlement flow:
- Runs the same verification as POST /verify
- Checks for idempotency (dedup by transaction hash or paymentId)
- Deserializes the VersionedTransaction and co-signs with the facilitator keypair (fee payer)
- Submits the fully-signed transaction to Solana via
sendRawTransaction - Confirms the transaction on-chain
- Persists the settlement record to the database
x84 extension modes:
- atomic/attestation: Transaction is already on-chain — the facilitator just records the settlement
- delegated (server-side): Vault settlement via the x84 on-chain program (pending deployment)
Response guarantees (x402 v2):
transactionis always present (empty string on failure)networkis always present (CAIP-2 identifier)
POST
/
settle
Settle an x402 v2 payment (co-sign + submit to Solana)
curl --request POST \
--url https://facilitator.x84.ai/settle \
--header 'Content-Type: application/json' \
--data '
{
"paymentPayload": {
"x402Version": 1,
"accepted": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": [
"atomic",
"attestation",
"delegated"
]
}
},
"payload": {
"transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm..."
},
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"extensions": {
"mode": "atomic",
"receiptPda": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
"delegationPda": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"delegate": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"signature": "<string>",
"timestamp": 1708700000,
"paymentId": "a1b2c3d4e5f6",
"txSignature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"payer": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"amount": "1000000"
}
},
"paymentRequirements": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": [
"atomic",
"attestation",
"delegated"
]
}
}
}
'import requests
url = "https://facilitator.x84.ai/settle"
payload = {
"paymentPayload": {
"x402Version": 1,
"accepted": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": ["atomic", "attestation", "delegated"]
}
},
"payload": { "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm..." },
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"extensions": {
"mode": "atomic",
"receiptPda": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
"delegationPda": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"delegate": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"signature": "<string>",
"timestamp": 1708700000,
"paymentId": "a1b2c3d4e5f6",
"txSignature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"payer": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu",
"amount": "1000000"
}
},
"paymentRequirements": {
"scheme": "exact",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"asset": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
"amount": "1000000",
"payTo": "8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9",
"maxTimeoutSeconds": 60,
"resource": "https://api.x84.ai/a2a/agent-abc/tasks/send",
"description": "Query agent-abc for market analysis",
"extra": {
"feePayer": "7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX",
"name": "Agent Query Fee",
"agentMint": "6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS",
"programId": "X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi",
"settlementModes": ["atomic", "attestation", "delegated"]
}
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
paymentPayload: {
x402Version: 1,
accepted: {
scheme: 'exact',
network: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
asset: 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
amount: '1000000',
payTo: '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
maxTimeoutSeconds: 60,
resource: 'https://api.x84.ai/a2a/agent-abc/tasks/send',
description: 'Query agent-abc for market analysis',
extra: {
feePayer: '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
name: 'Agent Query Fee',
agentMint: '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
programId: 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
settlementModes: ['atomic', 'attestation', 'delegated']
}
},
payload: {
transaction: 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...'
},
resource: 'https://api.x84.ai/a2a/agent-abc/tasks/send',
extensions: {
mode: 'atomic',
receiptPda: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
delegationPda: '9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin',
delegate: 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
signature: '<string>',
timestamp: 1708700000,
paymentId: 'a1b2c3d4e5f6',
txSignature: '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW',
payer: 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
amount: '1000000'
}
},
paymentRequirements: {
scheme: 'exact',
network: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
asset: 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
amount: '1000000',
payTo: '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
maxTimeoutSeconds: 60,
resource: 'https://api.x84.ai/a2a/agent-abc/tasks/send',
description: 'Query agent-abc for market analysis',
extra: {
feePayer: '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
name: 'Agent Query Fee',
agentMint: '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
programId: 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
settlementModes: ['atomic', 'attestation', 'delegated']
}
}
})
};
fetch('https://facilitator.x84.ai/settle', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://facilitator.x84.ai/settle",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'paymentPayload' => [
'x402Version' => 1,
'accepted' => [
'scheme' => 'exact',
'network' => 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
'asset' => 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
'amount' => '1000000',
'payTo' => '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
'maxTimeoutSeconds' => 60,
'resource' => 'https://api.x84.ai/a2a/agent-abc/tasks/send',
'description' => 'Query agent-abc for market analysis',
'extra' => [
'feePayer' => '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
'name' => 'Agent Query Fee',
'agentMint' => '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
'programId' => 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
'settlementModes' => [
'atomic',
'attestation',
'delegated'
]
]
],
'payload' => [
'transaction' => 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...'
],
'resource' => 'https://api.x84.ai/a2a/agent-abc/tasks/send',
'extensions' => [
'mode' => 'atomic',
'receiptPda' => '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
'delegationPda' => '9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin',
'delegate' => 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
'signature' => '<string>',
'timestamp' => 1708700000,
'paymentId' => 'a1b2c3d4e5f6',
'txSignature' => '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW',
'payer' => 'D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu',
'amount' => '1000000'
]
],
'paymentRequirements' => [
'scheme' => 'exact',
'network' => 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
'asset' => 'Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr',
'amount' => '1000000',
'payTo' => '8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9',
'maxTimeoutSeconds' => 60,
'resource' => 'https://api.x84.ai/a2a/agent-abc/tasks/send',
'description' => 'Query agent-abc for market analysis',
'extra' => [
'feePayer' => '7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX',
'name' => 'Agent Query Fee',
'agentMint' => '6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS',
'programId' => 'X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi',
'settlementModes' => [
'atomic',
'attestation',
'delegated'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://facilitator.x84.ai/settle"
payload := strings.NewReader("{\n \"paymentPayload\": {\n \"x402Version\": 1,\n \"accepted\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n },\n \"payload\": {\n \"transaction\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...\"\n },\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"extensions\": {\n \"mode\": \"atomic\",\n \"receiptPda\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n \"delegationPda\": \"9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin\",\n \"delegate\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"signature\": \"<string>\",\n \"timestamp\": 1708700000,\n \"paymentId\": \"a1b2c3d4e5f6\",\n \"txSignature\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW\",\n \"payer\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"amount\": \"1000000\"\n }\n },\n \"paymentRequirements\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://facilitator.x84.ai/settle")
.header("Content-Type", "application/json")
.body("{\n \"paymentPayload\": {\n \"x402Version\": 1,\n \"accepted\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n },\n \"payload\": {\n \"transaction\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...\"\n },\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"extensions\": {\n \"mode\": \"atomic\",\n \"receiptPda\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n \"delegationPda\": \"9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin\",\n \"delegate\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"signature\": \"<string>\",\n \"timestamp\": 1708700000,\n \"paymentId\": \"a1b2c3d4e5f6\",\n \"txSignature\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW\",\n \"payer\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"amount\": \"1000000\"\n }\n },\n \"paymentRequirements\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://facilitator.x84.ai/settle")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"paymentPayload\": {\n \"x402Version\": 1,\n \"accepted\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n },\n \"payload\": {\n \"transaction\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABjwuBdojnm...\"\n },\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"extensions\": {\n \"mode\": \"atomic\",\n \"receiptPda\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n \"delegationPda\": \"9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin\",\n \"delegate\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"signature\": \"<string>\",\n \"timestamp\": 1708700000,\n \"paymentId\": \"a1b2c3d4e5f6\",\n \"txSignature\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW\",\n \"payer\": \"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu\",\n \"amount\": \"1000000\"\n }\n },\n \"paymentRequirements\": {\n \"scheme\": \"exact\",\n \"network\": \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\",\n \"asset\": \"Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr\",\n \"amount\": \"1000000\",\n \"payTo\": \"8VF2ZAp9C1RKeV2XmKBnCQdbhGuNZaLZ1x7mTCSGsMH9\",\n \"maxTimeoutSeconds\": 60,\n \"resource\": \"https://api.x84.ai/a2a/agent-abc/tasks/send\",\n \"description\": \"Query agent-abc for market analysis\",\n \"extra\": {\n \"feePayer\": \"7iRiHRnj1NofyEZVuj86Z4s5MJwVFZVR71XuAsLnwLYX\",\n \"name\": \"Agent Query Fee\",\n \"agentMint\": \"6s1irFAQHoiK7VLwrUQEGpN5E1MrLoo5dZVWZCAwsDZS\",\n \"programId\": \"X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi\",\n \"settlementModes\": [\n \"atomic\",\n \"attestation\",\n \"delegated\"\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"transaction": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
"payer": "D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu"
}Body
application/json
Response
Settlement result — check success to determine outcome
Whether the settlement succeeded
Example:
true
Solana transaction signature (empty string on failure). REQUIRED per x402 v2.
Example:
"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW"
CAIP-2 network identifier where settlement occurred. REQUIRED per x402 v2.
Example:
"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"
Machine-readable error reason code
Example:
"SETTLEMENT_FAILED"
Human-readable error message
Example:
"Transaction simulation failed: insufficient funds"
Wallet address of the payer
Example:
"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu"
Additional extension data
Example:
{ "mode": "atomic" }
⌘I