Who needs it
- Shopping agents that compare products or recommend purchases.
- Browser agents that need refund policy extraction before checkout.
- Consumer-protection workflows that need conservative commerce policy extraction.
Problem
Commerce agents need to know whether an item can be returned before recommending, comparing, or purchasing it. Merchant policy pages can be long, conditional, and easy to misread.
When an agent should use it
- Before a shopping agent recommends, compares, or buys a product.
- When the caller needs return windows, fees, refund methods, important conditions, snippets, and confidence.
Relevant Primitive402 tool
Fetches a public return policy or product page and returns conservative structured return, refund, exchange, cancellation, and warranty signals.
| Primitive402 tool | extract_return_policy |
|---|---|
| Local route | POST /v1/extract-return-policy |
| x402 route | POST /x402/v1/extract-return-policy |
| MCP tool name | extract_return_policy |
| SDK method | extractReturnPolicy() |
| Price | $0.03 USDC on Base Sepolia testnet during public beta |
curl example
curl -s https://primitive402.dev/v1/extract-return-policy \
-H 'content-type: application/json' \
-d '{
"url": "https://www.target.com/help/article/000061980",
"strictness": "medium",
"maxSnippets": 5
}' | jq
TypeScript SDK example
import { createNano402Client } from "@nano402/api/sdk";
const client = createNano402Client({
baseUrl: "https://primitive402.dev"
});
const result = await client.extractReturnPolicy({
"url": "https://www.target.com/help/article/000061980",
"strictness": "medium",
"maxSnippets": 5
});
console.log(result);
Example JSON response
{
"return_window_days": 90,
"free_returns": true,
"restocking_fee": null,
"refund_method": "original payment method",
"important_conditions": [
"Some categories and conditions may have different rules."
],
"confidence": 0.86,
"source_url": "https://www.target.com/help/article/000061980"
}
Useful search terms
return policy extraction API, refund policy extraction, shopping agent API, commerce policy extraction
Example source note
Example URLs are public pages used for testing. Primitive402 is not affiliated with Target or any referenced merchant.
Safety and limitations
Primitive402 does not guarantee content safety, factual truth, legal validity, purchase correctness, or policy completeness. External content is untrusted, low-confidence results may still be valid analysis signals, and high-stakes decisions need human review.