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

60 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_code

Get 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_link

Get 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_overview

Get 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_balance

List 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_flows

Get 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_flow

List 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_settlements

List 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_tickets

Get Merchant Ticket

Read one merchant complaint ticket, including its deadline and merchant/platform response history.

weixin_store.get_merchant_ticket

List Aftersale Reasons

Read the current after-sale reason codes and labels instead of guessing their meanings.

weixin_store.list_aftersale_reasons

List 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_reasons

Get 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_complaint

Update 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_info

Send 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_delivery

Upload 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_image

Get 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_url

List 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_promoters

Get 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_promoter

Get 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_data

Get 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_info

List 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_products

List 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_talents

Get 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_strategy

List 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_plans

List 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_products

Get 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_plan

Invite 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_promoter

Update 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_plan

Upload 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_image

Apply 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_category

Get Category Application

Get the status and any rejection reason of a category application by audit id.

weixin_store.get_category_application

List Category Permissions

List the store's category permissions. Filter to status 1 to find categories currently allowed for sale.

weixin_store.list_category_permissions

Precheck 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_category

Get 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_rule

Upload 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_image

Get Shop Info

Get the basic information of the connected WeChat Store: name, avatar, subject type, and status.

weixin_store.get_shop_info

List 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_categories

Get Category

Get the publishing rules of one leaf category: required product and sale attributes, brand restrictions, deposit, and qualifications.

weixin_store.get_category

List 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_brands

Add 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_product

Update 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_product

Get Product

Get one product by product_id. Products keep a draft and an online copy; dataType selects which.

weixin_store.get_product

List Products

List the product ids of the store, paginated by cursor.

weixin_store.list_products

Listing Product

Submit a product for review and list it once approved.

weixin_store.listing_product

Delisting Product

Take a listed product off the shelf.

weixin_store.delisting_product

Delete Product

Permanently delete a product by product_id. A product under review cannot be deleted. This cannot be undone.

weixin_store.delete_product

Update Product Stock

Update the stock of a product's SKUs. This does not consume the product review quota.

weixin_store.update_product_stock

List 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_orders

Get Order

Get one order by order_id, including its products, payment, price, and delivery details. Buyer address fields are masked.

weixin_store.get_order

Update Order Merchant Notes

Replace the merchant note of one order, optionally with a tag color.

weixin_store.update_order_merchant_notes

Send 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_delivery

List Delivery Companies

List the delivery companies the store can ship with, including each company's delivery_id.

weixin_store.list_delivery_companies

List Freight Templates

List the freight template ids of the store.

weixin_store.list_freight_templates

Get 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_template

List 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_addresses

Get 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_address

List 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_orders

Get Aftersale Order

Get one after-sale order by its id, including its status, type, products, and refund details.

weixin_store.get_aftersale_order

Accept 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_aftersale

Reject 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_aftersale

Connect WeChat Store with Open Flow

Connect WeChat Store

20,000 free app calls per month (paid services billed separately)