RETROSPECTIVE RECORD · PREPARED 16 SEPTEMBER 2026The ledger archive · 100 retrospective records ↗
Vertical Ledger
Issue 01 / 14 Sep 2026

The ledger archive / Production economics

Production economics / Ledger note · Ledger note · prepared 16 September 2026

WeChat's own docs define the coin charge, not its cut

The mini-program payment API distinguishes coin top-ups from direct item purchases but does not publish the service fee it charges.

Visual for this record: WeChat's own docs define the coin charge, not its cut
Visual published by steamory-agent-kit.oss-us-east-1.aliyuncs.com, shown for identification of the record. Credit: steamory-agent-kit.oss-us-east-1.aliyuncs.com · source page ↗ Rights: owner-review-pending.

The figure or the record

Micro-dramas distributed as WeChat mini-programs charge for episodes through a specific payment call, wx.requestVirtualPayment, part of Tencent's "米大师" (Midas) virtual-payment system, as documented on WeChat's open-platform site and retrieved on 16 September 2026. The reference names two payment modes built for exactly this content type: short_series_coin, described as 代币充值 ("token top-up"), and short_series_goods, described as 道具直购 ("direct item purchase"). The parameters required for the second mode, productId and goodsPrice, exist, in the document's own words, "to verify that the price matches the backend item price, avoiding complaints caused by a mismatch between the price a user sees in the shop page and the actual price." This sits inside the broader mini-program developer guide, which frames the payment API as one module within the wider framework documentation.

What the documents establish

The naming of the two modes confirms that WeChat's platform engineers built distinct code paths for coin recharges and for one-off purchases inside short-series content, which means the coin-ladder pattern seen in dedicated drama apps has a direct mini-program equivalent, not an improvised workaround. The price-matching parameter also establishes that WeChat, not just the distributor, checks the price a user is shown against a backend record before the transaction completes, a consumer-protection control documented at the API level rather than left to the distributor's own goodwill.

Scope and caveats

What the documentation does not state, in either page opened for this record, is the percentage WeChat Pay retains as a service fee on these virtual-payment transactions, or the settlement schedule paid out to the distributor. Published mini-program guides describe mechanism and required fields, not commercial terms; a service-fee rate, if disclosed at all, would sit in a merchant-facing settlement agreement rather than the public developer reference, and no such rate appears in either source opened here. The absence of a published figure should be read as exactly that, not as evidence for any specific rate reported elsewhere.

What to watch

Editorially, the useful signal would be a rate stated in WeChat Pay's own merchant fee schedule or a settlement notice addressed to virtual-goods providers; short of that, any commission percentage attached to mini-program micro-dramas should be treated as unverified against WeChat's own public documentation.

  • Does WeChat Pay's merchant-facing fee schedule state a rate specific to virtual goods or short-series content, distinct from its general transaction fee?
  • How does the price-matching check in short_series_goods interact with promotional pricing, given the separate activitySellingPrice field the API also defines?
  • Do distributors report a settlement lag between a coin purchase and the funds reaching the content owner, and where would that be documented?

The API reference is precise about mechanism and silent about money: it tells a developer exactly how to charge for an episode and says nothing about what the platform keeps. That gap is itself the fact worth recording here.

Sources & reading trail

wx.requestVirtualPayment(Object object) ↗

Defines the short_series_coin and short_series_goods payment modes and required price-matching fields.

Source published: Not established · Retrieved: 16 September 2026

小程序开发指南 (Mini Program Developer Guide) ↗

Places the payment API within WeChat's public mini-program framework documentation.

Source published: Not established · Retrieved: 16 September 2026

Filings, releases and official documents establish the record; the scope reading and the questions are Vertical Ledger editorial analysis. This retrospective draft does not imply the site published on the event date.