Connect WeChat Store with Open Flow
Keep approved selling categories and qualification follow-ups easy to review.
20,000 free app calls per month (paid services billed separately)
What you can do
Check which categories a connected WeChat Store may sell, then submit the required qualification materials for a chosen category when needed. Application reviews can be checked for progress and requested corrections.
Review Selling Permissions
List category permissions with the intended status.
Submit a Category Application
Upload qualification images and submit the prepared categoryInfo.
All actions
Get Product Qr Code
Get a QR-code image URL for an on-sale self-operated product, optionally as standard or gift artwork. Optional bound WeCom ids attribute resulting orders. This does not publish the image.
weixin_store.get_product_qr_codeGet Product Tag Link
Get the WeChat sharing token for an on-sale self-operated product, with optional bound WeCom attribution. The returned token only opens inside WeChat; it is not an ordinary HTTPS link.
weixin_store.get_product_tag_linkGet Compass Shop Overview
Read daily shop-wide product clicks, transactions and refunds. T+1 historical data only; no same-day traffic inference. Counts and monetary values retain upstream strings, with money in fen.
weixin_store.get_compass_shop_overviewGet Funds Balance
Read the store's available and pending-settlement balances. Does not withdraw funds or change the settlement account. Amounts retain the upstream units.
weixin_store.get_funds_balanceList Funds Flows
List funds-flow ids for reconciliation; inspect each with get_funds_flow. Daily flows become available after 16:00 the following day. Continue while has_more using the returned next_key, incrementing page and keeping pageSize unchanged. nextKey is required when page * pageSize >= 10000.
weixin_store.list_funds_flowsGet Funds Flow
Read one funds flow, including income/expense, fees and related order/after-sale ids. Preserve the upstream amount units; an unavailable flow is an error, not a zero balance.
weixin_store.get_funds_flowList Order Settlements
Read order settlement, refund and fee breakdowns, in fen. Uses stable page-context pagination by default: pass the returned page_ctx until it is empty. Set usePageContext false to use offsets. Expected settlement is not actual profit or received cash.
weixin_store.list_order_settlementsList Merchant Tickets
List merchant complaint tickets and response deadlines. WeChat currently exposes shipping-reminder tickets (class 9) only; this is not a general platform-notification inbox. Paginate with start/limit and total; omitted state includes all states.
weixin_store.list_merchant_ticketsGet Merchant Ticket
Read one merchant complaint ticket, including its deadline and merchant/platform response history.
weixin_store.get_merchant_ticketList Aftersale Reasons
Read the current after-sale reason codes and labels instead of guessing their meanings.
weixin_store.list_aftersale_reasonsList Aftersale Reject Reasons
Read current rejection reasons, applicable after-sale scenes and need_proof. If a chosen reason requires proof, upload images with upload_aftersale_image and pass mediaFiles to reject_aftersale.
weixin_store.list_aftersale_reject_reasonsGet Aftersale Complaint
Read an after-sale dispute by its complaint id, including state and evidence history. This does not submit evidence, accept a refund or resolve the dispute.
weixin_store.get_aftersale_complaintUpdate Delivery Info
Correct express-package logistics using old/new package identities (change_infos), including split shipments where supported. WeChat permits at most three corrections before order completion and rejects virtual-goods corrections. Confirm the actual shipment before changing its carrier or waybill.
weixin_store.update_delivery_infoSend Exchange Delivery
Record shipment of a replacement in an exchange after receiving the buyer's return. Requires an actual carrier and waybill. Do not submit shipments for multiple after-sales of the same order within one minute.
weixin_store.send_exchange_deliveryUpload Aftersale Image
Upload a JPEG, PNG, BMP or GIF transit file up to 10 MB as after-sale evidence (scene 170). Returns a C2C image URL for reject_aftersale mediaFiles. Keep the complete URL including query parameters; ordinary product-image URLs cannot substitute for this upload.
weixin_store.upload_aftersale_imageGet Product H5 Url
Get a shareable H5 purchase link for an on-sale, self-operated store product. Optional linked WeCom company and member ids attribute orders to that company. Only WeChat Store accounts support this API.
weixin_store.get_product_h5_urlList League Promoters
List the connected merchant's alliance talents. This is not a platform-wide talent search; follow continue_flag to paginate.
weixin_store.list_league_promotersGet League Promoter
Read a known alliance talent's profile, sales metrics and blacklist status. Supply exactly one talent identifier, not a nickname.
weixin_store.get_league_promoterGet Compass Product Data
Read historical Compass product click and transaction data. T+1 only: date must be yesterday or earlier in Asia/Shanghai. Monetary values and counts retain upstream string units.
weixin_store.get_compass_product_dataGet Product Restricted Info
Read restricted sales scenes for 1 to 50 products, including alliance and talent-window restrictions. This does not change product status. Merchant quota: 100 calls per minute.
weixin_store.get_product_restricted_infoList League Promoter Products
Read a known cooperating talent's current window products or products sold in the last 30 days. This does not discover new talents or add products to a window.
weixin_store.list_league_promoter_productsList Product Promotion Talents
Read talents related to one existing product promotion plan and their promotion relationship status. This is not platform-wide discovery and does not prove that a product is in a talent's window.
weixin_store.list_product_promotion_talentsGet Product Audit Strategy
Read store-wide product listing policy switches. This is not a historical delisting-reason log and does not change any policy.
weixin_store.get_product_audit_strategyList Product Promotion Plans
List an existing product's alliance promotion plan identifiers before inspecting or changing a specific plan. Filtered audience type 200 is supported by this list only, not get_league_plan or update_league_plan.
weixin_store.list_product_promotion_plansList League Products
List existing alliance products and eligibility status. Pagination is bounded by pageSize multiplied by pageIndex <= 5000; no undocumented cursor is sent.
weixin_store.list_league_productsGet League Plan
Read an existing alliance plan's activation, eligibility and commission. The returned item.type uses legacy values 1/2/3; do not reuse it as request type 100/300.
weixin_store.get_league_planInvite League Promoter
Invite one known talent to cooperate with the shop. This sends an external invitation: obtain approval for the exact recipient first. Supply promoterId or the deprecated finderId, never infer promoterId from talent_appid. Do not retry blindly after a timeout; WeChat rejects duplicate invitations within 24 hours and already-cooperating talents.
weixin_store.invite_league_promoterUpdate League Plan
Change one existing alliance promotion plan: edit commission and activate (1), delist (2), or activate (4). Obtain approval for the exact plan and change first; activation or commission changes can incur commission spending. Read the plan before and after; no automatic fallback, audience changes, new plan creation or deletion is provided.
weixin_store.update_league_planUpload Qualification Image
Upload a qualification image (up to 2 MB) and return the file_id required for category and brand applications. Product images from upload_image cannot be used here.
weixin_store.upload_qualification_imageApply Category
Apply for permission to sell in a leaf category using the new category tree and certificate groups. Returns an audit id; check the audit and effective permission before publishing products.
weixin_store.apply_categoryGet Category Application
Get the status and any rejection reason of a category application by audit id.
weixin_store.get_category_applicationList Category Permissions
List the store's category permissions. Filter to status 1 to find categories currently allowed for sale.
weixin_store.list_category_permissionsPrecheck Product Category
Check whether the store may publish in a leaf category, including category permission, deposit, freight insurance, and store restrictions. Omit catId for store-wide checks only.
weixin_store.precheck_product_categoryGet Category Product Rule
Get the category's product attribute, sale attribute, qualification, price, and other publishing rules for the chosen release mode.
weixin_store.get_category_product_ruleUpload Image
Ask WeChat to fetch and host a public image URL for use in product image fields. At most 10 MB per image.
weixin_store.upload_imageGet Shop Info
Get the basic information of the connected WeChat Store: name, avatar, subject type, and status.
weixin_store.get_shop_infoList Categories
Get the full category tree of the store, including the qualifications each category requires. Use the leaf cat_id values from cats_v2 for add_product and get_category.
weixin_store.list_categoriesGet Category
Get the publishing rules of one leaf category: required product and sale attributes, brand restrictions, deposit, and qualifications.
weixin_store.get_categoryList Valid Brands
List the brand qualifications currently in effect for the store, paginated by cursor. Use a returned brand_id when adding a product in a brand-restricted category.
weixin_store.list_valid_brandsAdd Product
Create a product. All image fields must be WeChat-hosted URLs from upload_image. By default the product is saved as a draft; pass listing 1 to submit it for review and list it directly. Nested objects and arrays keep their WeChat snake_case fields as documented per field.
weixin_store.add_productUpdate Product
Replace a product's editable data. This is a full overwrite: every field of add_product applies, SKUs that carry an existing sku_id are updated, SKUs without one are added, and previously existing SKUs missing from the list are deleted.
weixin_store.update_productGet Product
Get one product by product_id. Products keep a draft and an online copy; dataType selects which.
weixin_store.get_productList Products
List the product ids of the store, paginated by cursor.
weixin_store.list_productsListing Product
Submit a product for review and list it once approved.
weixin_store.listing_productDelisting Product
Take a listed product off the shelf.
weixin_store.delisting_productDelete Product
Permanently delete a product by product_id. A product under review cannot be deleted. This cannot be undone.
weixin_store.delete_productUpdate Product Stock
Update the stock of a product's SKUs. This does not consume the product review quota.
weixin_store.update_product_stockList Orders
List the order ids of the store, paginated by cursor. At least one time range is required, as a pair of Unix timestamps in seconds spanning at most 7 days.
weixin_store.list_ordersGet Order
Get one order by order_id, including its products, payment, price, and delivery details. Buyer address fields are masked.
weixin_store.get_orderUpdate Order Merchant Notes
Replace the merchant note of one order, optionally with a tag color.
weixin_store.update_order_merchant_notesSend Delivery
Ship an order, in one or more packages. Each package either ships by express with a waybill (deliverType 1, needs waybillId and deliveryId from list_delivery_companies, or OTHER when the company is not listed) or delivers virtual goods without logistics (deliverType 3, only for orders whose products use the phone-number delivery method).
weixin_store.send_deliveryList Delivery Companies
List the delivery companies the store can ship with, including each company's delivery_id.
weixin_store.list_delivery_companiesList Freight Templates
List the freight template ids of the store.
weixin_store.list_freight_templatesGet Freight Template
Get one freight template by template_id, including its valuation type, shipping method, sender address, and freight rules. Freight templates bind to products through expressInfo on add_product.
weixin_store.get_freight_templateList Addresses
List the merchant address ids of the store. After-sale returns need one of these address ids when accepting a return.
weixin_store.list_addressesGet Address
Get one merchant address by address_id, including its contact, region, and send/recv flags. Accepting an after-sale return needs one of these address ids.
weixin_store.get_addressList Aftersale Orders
List the after-sale order ids of the store, paginated by cursor. At least one time range pair is required, as Unix timestamps in seconds spanning at most 24 hours.
weixin_store.list_aftersale_ordersGet Aftersale Order
Get one after-sale order by its id, including its status, type, products, and refund details.
weixin_store.get_aftersale_orderAccept Aftersale
Accept a buyer's after-sale request. Accepting a return needs a merchant address id from list_addresses; acceptType chooses between accepting the return (1) and accepting the refund (2), and is chosen automatically when omitted.
weixin_store.accept_aftersaleReject Aftersale
Reject a buyer's after-sale request using a current reason from list_aftersale_reject_reasons. Check reject_scene and need_proof; when proof is required, supply mediaFiles with complete C2C URLs (upload_aftersale_image for images).
weixin_store.reject_aftersaleNo actions match your search.
Connect WeChat Store with Open Flow
20,000 free app calls per month (paid services billed separately)