WM Tech Solutions REST API

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API key from the WM Tech dashboard under Settings → API Keys. Keys are scoped per store and per permission level.

// All requests require this header
Authorization: Bearer wmtech_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Key types

Key Prefix	Environment	Description
wmtech_live_	Production	Full access. Triggers real refunds and fraud holds.
wmtech_test_	Sandbox	No real actions. All responses are simulated. Safe for development.

Error Codes

All errors return a JSON object with a code and message field.

HTTP Status	Code	Meaning
400	invalid_request	Missing or malformed request parameters.
401	unauthorized	Invalid or missing API key.
403	forbidden	Your plan does not include this endpoint.
404	not_found	Order ID, store ID, or resource not found.
429	rate_limited	Too many requests. Retry after the Retry-After header value.
500	server_error	Unexpected error. Contact support with your request ID.

Rate Limits

Starter: 60 requests/min. Growth: 300 requests/min. Enterprise: Custom — negotiated per contract. Rate limit status is included in every response header: X-RateLimit-Remaining and X-RateLimit-Reset.

SDKs & Libraries

Official SDKs available for Node.js, Python, and PHP. Community SDKs for Ruby and Go maintained on GitHub.

# Install Node.js SDK
npm install wmtech-sdk

# Install Python SDK
pip install wmtech

# Install PHP SDK (Composer)
composer require wmtech/sdk

POST /returns/analyze

Submit a return request with an attached photo URL for AI analysis. The model checks product identity, visible condition, and policy compliance. Returns a decision, reason, and refund amount if approved.

Request Parameters

Parameter	Type	Description
order_id	string	Your platform order ID. Required.
store_id	string	Your WM Tech store identifier. Required.
photo_url	string	Public HTTPS URL to the return photo. JPEG or PNG, max 8MB. Required.
reason	string	Customer's stated reason for the return. Optional but improves accuracy.
sku	string	Product SKU for catalog cross-reference. Optional.

Response

POST /fraud/score

Submit a order for real-time fraud risk scoring before dispatch. Returns a 0–100 risk score, detected signals, and a recommended action based on your configured threshold.

Request Parameters

Parameter	Type	Description
order_id	string	Platform order ID. Required.
store_id	string	WM Tech store identifier. Required.
customer_phone	string	E.164 format phone number. Required for phone reuse signals.
shipping_address	object	Full address object. Required for address velocity signals.
order_value	number	Order total in your currency. Required.
order_time_utc	string	ISO 8601 UTC timestamp of order placement. Optional.

Response

POST /tickets/summarize

Submit a multi-message support thread for AI summarization. Returns a 3-line summary, sentiment score, urgency level, and a suggested action for your support agent.

Request Parameters

Parameter	Type	Description
thread	array	Array of message objects: [{role, content, timestamp}]. Required.
store_id	string	WM Tech store identifier. Required.
language	string	ISO 639-1 language code. Auto-detected if omitted.

Response

Webhooks

WM Tech fires outbound webhooks to your configured endpoint URL on every AI action. Register webhook URLs in the dashboard under Settings → Webhooks. All payloads are signed with HMAC-SHA256 using your webhook secret.

Available Events

Event	Triggered When
return.approved	Return photo approved by AI, refund issued.
return.rejected	Return rejected by AI, reason code attached.
fraud.flagged	order risk score exceeds your threshold.
ticket.resolved	Support ticket fully handled by AI.
ticket.escalated	Ticket outside AI confidence routed to human agent.