Run one direct sandbox request against the seller's API
curl --request POST \
--url https://api.zeroclick.io/v1/sandbox/sellers/{sellerId}/direct \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({path: '<string>'})
};
fetch('https://api.zeroclick.io/v1/sandbox/sellers/{sellerId}/direct', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.zeroclick.io/v1/sandbox/sellers/{sellerId}/direct"
payload = { "path": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"outcome": {
"status": 123,
"error": "<string>",
"message": "<string>",
"body": "<string>",
"truncated": true,
"challenge": {},
"settlement": {
"txHash": "<string>",
"explorerUrl": "<string>"
}
},
"trace": [
{
"legId": "<string>",
"seq": 123,
"kind": "<string>",
"request": {
"method": "<string>",
"url": "<string>",
"headers": {}
},
"response": {
"status": 123,
"headers": {},
"bodyPreview": "<string>",
"truncated": true
},
"challenge": {
"challengeId": "<string>",
"amountUsd": "<string>",
"network": "<string>",
"payTo": "<string>",
"asset": "<string>",
"planSlug": "<string>"
},
"paymentSigned": {
"challengeId": "<string>",
"amountUsd": "<string>"
},
"settlement": {
"txHash": "<string>",
"network": "<string>",
"explorerUrl": "<string>"
},
"records": {
"proxyRequest": "<unknown>",
"agentPayment": "<unknown>",
"usageEvents": [
"<unknown>"
]
},
"error": "<string>"
}
],
"wallet": {
"address": "<string>",
"usdcBalance": "<string>",
"ethBalance": "<string>"
},
"receiver": {
"address": "<string>",
"usdcBalance": "<string>",
"recentTransfers": [
{
"txHash": "<string>",
"explorerUrl": "<string>",
"amountUsd": "<string>",
"from": "<string>",
"at": "<string>"
}
]
}
}{
"error": "organization_required"
}{
"error": "organization_required"
}{
"error": "sandbox_session_in_progress"
}{
"error": "organization_required"
}Sandbox
Run one direct sandbox request against the seller's API
Sends a single request to the seller’s pay host from the sandbox test wallet, with no agent in the loop, and returns the full protocol trace as JSON. With autoPay (the default), 402 challenges along the way are paid automatically, subject to the sandbox spend caps.
POST
/
v1
/
sandbox
/
sellers
/
{sellerId}
/
direct
Run one direct sandbox request against the seller's API
curl --request POST \
--url https://api.zeroclick.io/v1/sandbox/sellers/{sellerId}/direct \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({path: '<string>'})
};
fetch('https://api.zeroclick.io/v1/sandbox/sellers/{sellerId}/direct', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.zeroclick.io/v1/sandbox/sellers/{sellerId}/direct"
payload = { "path": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"outcome": {
"status": 123,
"error": "<string>",
"message": "<string>",
"body": "<string>",
"truncated": true,
"challenge": {},
"settlement": {
"txHash": "<string>",
"explorerUrl": "<string>"
}
},
"trace": [
{
"legId": "<string>",
"seq": 123,
"kind": "<string>",
"request": {
"method": "<string>",
"url": "<string>",
"headers": {}
},
"response": {
"status": 123,
"headers": {},
"bodyPreview": "<string>",
"truncated": true
},
"challenge": {
"challengeId": "<string>",
"amountUsd": "<string>",
"network": "<string>",
"payTo": "<string>",
"asset": "<string>",
"planSlug": "<string>"
},
"paymentSigned": {
"challengeId": "<string>",
"amountUsd": "<string>"
},
"settlement": {
"txHash": "<string>",
"network": "<string>",
"explorerUrl": "<string>"
},
"records": {
"proxyRequest": "<unknown>",
"agentPayment": "<unknown>",
"usageEvents": [
"<unknown>"
]
},
"error": "<string>"
}
],
"wallet": {
"address": "<string>",
"usdcBalance": "<string>",
"ethBalance": "<string>"
},
"receiver": {
"address": "<string>",
"usdcBalance": "<string>",
"recentTransfers": [
{
"txHash": "<string>",
"explorerUrl": "<string>",
"amountUsd": "<string>",
"from": "<string>",
"at": "<string>"
}
]
}
}{
"error": "organization_required"
}{
"error": "organization_required"
}{
"error": "sandbox_session_in_progress"
}{
"error": "organization_required"
}Authorizations
Body
application/json