{
  "schemaVersion": "TELAGO_TRADE_BUYER_GUIDE_V1",
  "name": "TELAGO / GLIN Trade Buyer Guide",
  "updatedOn": "2026-10-14",
  "automaticPayment": false,
  "products": [
    {
      "key": "import-preflight",
      "name": "US Import Preflight and Base-Rate Quote Audit",
      "priceUsd": 0.02,
      "amountAtomic": "20000",
      "path": "/import/preflight",
      "marketplace": "https://payapi.market/api/glin-us-import-preflight",
      "marketplaceEvidence": "PayAPI settlement verification covers GET /import/preflight only; not independent buyer demand.",
      "example": {
        "counterparty": "Samsung Electronics Co., Ltd.",
        "hts": "8517.13.0000",
        "origin": "KR",
        "customsValueUsd": 10000
      },
      "required": [
        "counterparty",
        "hts"
      ],
      "useWhen": "A new supplier or purchase order needs sanctions-name, legal-entity-candidate and tariff evidence before review.",
      "returns": [
        "Sanctions-name matches and source freshness",
        "GLEIF legal-entity candidates, not confirmed identity",
        "Exact-HTS tariff evidence where available",
        "Optional General-base-rate quote difference and unresolved duty layers"
      ],
      "method": "GET",
      "request": {
        "product": "import-preflight",
        "method": "GET",
        "url": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-x402-v1/import/preflight?counterparty=Samsung+Electronics+Co.%2C+Ltd.&hts=8517.13.0000&origin=KR&customsValueUsd=10000",
        "expectedPayment": {
          "scheme": "exact",
          "network": "eip155:8453",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x078293f144c61d1e02b49d4cd3f33c283eb7dc73",
          "amount": "20000",
          "priceUsd": 0.02
        },
        "automaticPayment": false
      }
    },
    {
      "key": "landed-cost",
      "name": "US Import Landed-Cost Floor and Supplier Quote Audit",
      "priceUsd": 0.03,
      "amountAtomic": "30000",
      "path": "/trade/landed-cost-decision",
      "marketplace": "https://payapi.market/api/glin-us-import-landed-cost-floor-supplier-quote-audit",
      "marketplaceStatus": "live",
      "marketplaceEvidence": "PayAPI reports settlement verification for GET /trade/landed-cost-decision at 2026-10-14T11:36:24.64927Z. This was a marketplace canary, not independent customer demand or a live test of the downloadable purchase adapter.",
      "example": {
        "counterparty": "Samsung Electronics Co., Ltd.",
        "hts": "8517.13.0000",
        "origin": "KR",
        "customsValueUsd": 10000,
        "freightUsd": 800,
        "insuranceUsd": 50,
        "brokerageUsd": 150,
        "sellerQuotedLandedCostUsd": 10500
      },
      "required": [
        "counterparty",
        "hts",
        "customsValueUsd"
      ],
      "useWhen": "A freight, insurance, brokerage or supplier quote changes and the buyer needs a new identified-cost floor and a below-floor comparison.",
      "returns": [
        "Known-cost floor, or null when duty evidence is unavailable",
        "Supplier quote versus identified costs",
        "Counterparty and tariff evidence from import preflight",
        "Unresolved costs and trade-remedy checks"
      ],
      "method": "GET",
      "request": {
        "product": "landed-cost",
        "method": "GET",
        "url": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-x402-v1/trade/landed-cost-decision?counterparty=Samsung+Electronics+Co.%2C+Ltd.&hts=8517.13.0000&origin=KR&customsValueUsd=10000&freightUsd=800&insuranceUsd=50&brokerageUsd=150&sellerQuotedLandedCostUsd=10500",
        "expectedPayment": {
          "scheme": "exact",
          "network": "eip155:8453",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x078293f144c61d1e02b49d4cd3f33c283eb7dc73",
          "amount": "30000",
          "priceUsd": 0.03
        },
        "automaticPayment": false
      }
    }
  ],
  "openapi": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-x402-v1/openapi.json",
  "requestBuilder": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/request-builder.mjs",
  "guideUrl": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/buyer-guide",
  "buyerWorkflow": [
    "Choose the product matching your task; do not buy both for the same task when the combined response already includes the evidence you need.",
    "Build a request with your own supplier and order facts. Example company and amounts are illustrative inputs, not a demonstrated safe transaction.",
    "Read the 402 challenge. Your existing x402 wallet/client must enforce the exact Base USDC asset, payee and maximum amount before signing. Never share keys or a recovery phrase with TELAGO.",
    "Approve one paid request in your own client. This guide and request builder do not connect to a wallet, charge, send email, or start a recurring job.",
    "Keep the original request, response and payment receipt. A timeout must be reconciled before authorizing another payment; do not blindly retry."
  ],
  "repeatUse": {
    "triggers": [
      "New purchase order or supplier",
      "Changed goods origin or exact HTS code",
      "Revised supplier quote or freight/insurance/brokerage costs",
      "Prior evidence no longer meets your freshness requirement"
    ],
    "avoid": "Do not repeat identical paid calls just to generate activity. Reuse still-valid evidence where your policy permits."
  },
  "limitations": [
    "Name similarity and GLEIF candidates are not confirmed counterparty identity or sanctions clearance.",
    "Known-cost floor is not a complete landed cost. Section 232, AD/CVD, quotas, unresolved Chapter 99, other taxes/fees and origin qualification may remain unresolved.",
    "Unknown duty is not zero. Missing inputs and source failures must remain unknown.",
    "No legal advice, customs ruling, shipment permission, guaranteed savings or customer-demand claim."
  ],
  "paymentSafety": {
    "currency": "USDC",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x078293f144c61d1e02b49d4cd3f33c283eb7dc73",
    "requiresBuyerAuthorization": true,
    "storesKeys": false,
    "signsPayments": false
  },
  "freeProofExample": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/proof-example",
  "freeQuoteTriage": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/quote-triage",
  "agentSkill": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/skill.md",
  "agentMetadata": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/agent.json",
  "purchaseAdapter": {
    "source": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/purchase-client.mjs",
    "instructions": "https://ozeejewwpjmabshxyitc.supabase.co/functions/v1/glin-us-import-preflight-preview-v1/purchase-usage.txt",
    "runtime": "Node.js 22+",
    "buyerApprovalRequired": true,
    "livePaymentTested": false
  }
}