Appearance
Seller Documentation
For seller business system integration, covering authorization, products, inventory, orders, messaging, after-sales, and order status callbacks.
Production Environment
| Property | Value |
|---|---|
| Base URL | https://paas-gateway.imetastore.io/merchant-api |
| Protocol | HTTPS |
| Data Format | JSON |
Authentication
| Scenario | Method | Description |
|---|---|---|
| Business APIs | Bearer Token | Authorization: Bearer <accessToken> |
| Order Callbacks | HMAC-SHA256 | Verify signature using the platform-assigned secretKey |
API Reference
Authentication
| Endpoint | Method | Description |
|---|---|---|
| Login Authorization | POST | Obtain a business API access token |
Product Management
| Endpoint | Method | Description |
|---|---|---|
| Get Product List | POST | Query product list with filters |
| Product Listing/Delisting | PUT | Batch update product listing status |
| Update SKU Inventory | PUT | Update SKU stock quantity |
| Update SKU Price | PUT | Update SKU price |
Order Management
| Endpoint | Method | Description |
|---|---|---|
| Get Order List | POST | Query order list by conditions |
| Submit Delivery | POST | Submit delivery information |
| Get Delivery Details | GET | Get delivery records for an order |
| Submit Delivery Error | POST | Report delivery error |
| Get Delivery Error Details | GET | Get delivery error records |
Messaging
| Endpoint | Method | Description |
|---|---|---|
| Send IM Message | POST | Send a message to a buyer |
| Get IM Contact List | POST | Get buyer session list |
| Get IM Messages | POST | Get message history with a buyer |
After-sales
| Endpoint | Method | Description |
|---|---|---|
| Submit Approval | POST | Approve or reject a refund request |
| Get After-sales Details | GET | Get after-sales details for an order |
Callback Notifications
| Endpoint | Method | Description |
|---|---|---|
| Order Status Callback | POST (platform push) | Platform notification when order status changes |
Quick Navigation
- Getting Started — Integrate with the Seller API from scratch
- Callback Overview — Callback notification mechanism
- Integration Checklist — Complete pre-launch checklist
