Xcotton developer docs
This is the V2 documentation:
- Guides: authentication, onboarding, and business flow. Each API guide covers when to call, required conditions, common pitfalls, and JSON examples. Field names, types, and descriptions live in the API reference.
- API reference: interactive OpenAPI documentation. Outbound
pathscan be tried against our servers.webhooksare inbound (Xcotton POSTs to your URL)—payload reference only; do not send test requests to OpenAPI hosts.
Start here
Section titled “Start here”Onboarding and authentication
Section titled “Onboarding and authentication”- Authentication and common rules — signing, headers, environment domains, replay protection
- Request an access token
- Shipping protection integration
- Product protection integration
- API reference
Shopify Headless SDK
Section titled “Shopify Headless SDK”- Before you integrate — responsibilities, credentials, and store settings
- Quick start
- SDK Reference
Frequently used endpoints
Section titled “Frequently used endpoints”- Cart quote — shipping / warranty quotes before checkout
- Sync platform order (enroll) — sync after order creation (pending or paid); syncing after successful payment is generally recommended
- Sync shipment — push shipment info after dispatch, for both shipping protection and warranty
- File a claim — start a claim
- Cancel coverage (by service order) — pre-shipment cancellation for both coverages
- Query service orders — paginated query by merchant order number or update time
Appendix
Section titled “Appendix”Environments
Section titled “Environments”| Environment | Base URL |
|---|---|
| Beta (test) | https://betaxcottons.xmhhulu.com |
| Production (US) | https://openapi.xcottons.com |