{"openapi":"3.1.0","info":{"title":"PAL Commerce Data x402 API","version":"1.4.0","description":"Deterministic utilities paid per call with x402 Base USDC: catalog audit, GTIN validation, product-feed diff, x402 declaration validation, and standard or batch prioritized catalog remediation."},"servers":[{"url":"https://pal-nano-catalog-audit.onrender.com"}],"paths":{"/v1/usdc/catalog-audit":{"post":{"operationId":"auditCatalogFeedIdentifiers","summary":"Shopify and Google Merchant Center product feed audit","tags":["ecommerce","shopify","merchant-feed","google-shopping","merchant-center","catalog-validation","feed-errors","gtin","upc","ean"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":true}}}},"example":{"records":[{"id":"sku-100","title":"Example Product","link":"https://example.com/products/sku-100","image_link":"https://example.com/images/sku-100.jpg","gtin":"4006381333931","brand":"Example","mpn":"SKU-100","price":"19.99 USD","availability":"in_stock","identifier_exists":true}]}}}},"responses":{"200":{"description":"Structured audit result after successful payment."},"400":{"description":"Invalid catalog payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/gtin-check-one":{"get":{"operationId":"validateSingleGtin","summary":"Validate one GTIN/UPC/EAN identifier","tags":["ecommerce","gtin","upc","ean","validation"],"parameters":[{"name":"gtin","in":"query","required":true,"schema":{"type":"string"},"example":"4006381333931"}],"responses":{"200":{"description":"Single GTIN validation result after successful payment."},"400":{"description":"Missing or invalid GTIN query."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/gtin-check":{"post":{"operationId":"validateGtins","summary":"Validate GTIN/UPC/EAN identifiers","tags":["ecommerce","gtin","upc","ean","validation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["gtins"],"properties":{"gtins":{"type":"array","minItems":1,"maxItems":100,"items":{"anyOf":[{"type":"string"},{"type":"number"}]}}}},"example":{"gtins":["4006381333931","036000291452"]}}}},"responses":{"200":{"description":"GTIN validation result after successful payment."},"400":{"description":"Invalid GTIN payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/feed-diff":{"post":{"operationId":"diffProductFeedSnapshots","summary":"Compare product-feed snapshots","tags":["ecommerce","product-feed","change-detection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["before","after"],"properties":{"before":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}},"after":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}}}},"example":{"before":[{"id":"sku-1","price":"19.99 USD","availability":"in_stock"}],"after":[{"id":"sku-1","price":"17.99 USD","availability":"in_stock"}]}}}},"responses":{"200":{"description":"Feed diff after successful payment."},"400":{"description":"Invalid feed-diff payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/catalog-remediation-batch":{"post":{"operationId":"remediateCatalogFeedBatch","summary":"Generate a prioritized remediation plan for up to 500 products","tags":["ecommerce","merchant-feed","google-shopping","catalog-remediation","batch"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"object","additionalProperties":true}}}},"example":{"records":[{"id":"sku-100","title":"Example Product","link":"https://example.com/products/sku-100","image_link":"https://example.com/images/sku-100.jpg","gtin":"4006381333931","brand":"Example","mpn":"SKU-100","price":"19.99 USD","availability":"in_stock","identifier_exists":true}]}}}},"responses":{"200":{"description":"Batch remediation plan after successful payment."},"400":{"description":"Invalid catalog payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"5000000","price":"$5.00","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/catalog-remediation":{"post":{"operationId":"remediateCatalogFeed","summary":"Generate a prioritized catalog remediation plan","tags":["ecommerce","merchant-feed","google-shopping","catalog-remediation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":true}}}},"example":{"records":[{"id":"sku-100","title":"Example Product","link":"https://example.com/products/sku-100","image_link":"https://example.com/images/sku-100.jpg","gtin":"4006381333931","brand":"Example","mpn":"SKU-100","price":"19.99 USD","availability":"in_stock","identifier_exists":true}]}}}},"responses":{"200":{"description":"Prioritized remediation plan after successful payment."},"400":{"description":"Invalid catalog payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000000","price":"$1.00","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/x402-validate":{"post":{"operationId":"validateX402Declaration","summary":"Validate an x402 v2 payment declaration","tags":["x402","payments","developer-tools","validation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"x402Version":2,"resource":{"url":"https://example.com/api/data"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF","maxTimeoutSeconds":60}]}}}},"responses":{"200":{"description":"Static x402 declaration findings after successful payment."},"400":{"description":"Invalid request wrapper."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"50000","price":"$0.05","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}}}}