pack-revenue.balancesモジュール 28プレーンのモジュール
プレーンのモジュールPack revenue ledger
誰がいくら稼ぎ、いくら未払いか。支払う前に、最小通貨単位まで1円も漏れなく確認できます。
pack-revenue.balances は、パックレジストリの背後にある収益台帳を読み取ります。収益ラインはプラットフォーム分と作成者分に一度だけ分割され、返金期間中は保留され、明細として締められます。balances は、各作成者キーの繰越額と受取人の状態を示します。
pack-revenue.balancesモジュール 28誰がいくら稼ぎ、いくら未払いか。支払う前に、最小通貨単位まで1円も漏れなく確認できます。
pack-revenue.balances は、パックレジストリの背後にある収益台帳を読み取ります。収益ラインはプラットフォーム分と作成者分に一度だけ分割され、返金期間中は保留され、明細として締められます。balances は、各作成者キーの繰越額と受取人の状態を示します。
© 2026 Intramedial. All rights reserved. IntramedialはTrustviceの製品です。 Secured and supercharged by Avonao Labs.
不正利用の報告支払いプロバイダーが未接続のため、close は明細を書き込み、各支払いを理由付きの paid: false として記録します。作成者への支払いはプレーンの外で payableMinor に基づいて行ってください。残高は送金ではなく記録です。
balancesauthorKeyIdunattributed。carriedForwardMinor0。terms は platformFeeBps、minimumPayoutMinor、holdDays を読み取り、または設定します。既定値は usd で 500、5000、30 です。
このモジュールの呼び出しは実際の状態を変更したり外部サービスに到達したりするため、共有デモでは実行しません。ご自身のワークスペースで実行するにはサインインしてください。 pack-revenue.balancesの資料
このモジュールの呼び出しは実際の状態を変更したり外部サービスに到達したりするため、共有デモでは実行しません。ご自身のワークスペースで実行するにはサインインしてください。
APIが受け付ける形のリクエストと、モジュールが返す形のレスポンス例です。
GET /api/v1/acp/pack-revenue/balances Authorization: Bearer av_workspace_•••• → 200 { balances, currency }
締めの後に balances を読み、誰が残高を持ち、その理由が何かを確認します。最低額に満たない残高は次の期間に繰り越されます。
各明細は broughtForwardMinor + earnedMinor - payableMinor = carriedForwardMinor を満たすため、争点の数字はラインまで追跡できます。
レジストリが認識しないキーのラインは、プラットフォーム分ではなく、注記付きで unattributed に計上されます。
モジュールは、狭い範囲について強く保証します。保証されることだけを頼ってください。
close が冪等であること。明細は作成者と期間をキーとし、支払い済みの明細はスキップされます。金額はすべて最小通貨単位の整数です。負の総額は record で拒否され、返金は専用のルートで行います。
収益はライン発生後 holdDays の間 heldMinor に留まり、明細の payableMinor は締め時点で確定した分だけを数えます。
繰越残高があってその期間にラインがない作成者にも明細が出るため、報告されなくなった残高が忘れられることはありません。
ワークスペースのAPIキーをBearerトークンとして認証します。ベースURLは https://api.intramedial.com です。
/api/v1/acp/pack-revenue/balances各作成者の繰越残高と受取人の状態を読み取ります。/api/v1/acp/pack-revenue/lines収益ラインを packId または authorKeyId で絞り込んで一覧表示します。packs.list25Signed pack registry外部からエージェント、付与、ドリルのパックを取り込み、誰が署名したか、途中で1バイトでも変わったかを把握します。metering.snapshot21Metered usage by workspaceプレーンがワークスペースについて数えたものを、メーターごとに、また各カウントが対応する課金メーターとともに確認できます。
payeenone、onboarding、payable、restricted。currencyusd です。withheldbelow-minimum、no-payee、payee-not-payable、negative-balance、unattributed のいずれか。payableMinorrecord は packId、grossMinor、kind(install、usage、adjustment)を持つラインを追加します。分割は一度だけ行われ、端数は作成者に有利に丸められます。
payee は作成者キーを none、onboarding、payable、restricted に設定します。payable には account の参照、restricted には reason が必要です。
close は from と to を受け取り、作成者ごとに明細を書き込み、各支払い試行を記録します。支払い済みの明細が二重に支払われることはありません。
{
"balances": [
{
"authorKeyId": "key_9f2a41",
"carriedForwardMinor": 1840,
"payee": "onboarding"
},
{
"authorKeyId": "unattributed",
"carriedForwardMinor": 950,
"payee": "none"
}
],
"currency": "usd"
}refund は、適用済みの分割を使ってラインを取り消します。冪等で、2回目の返金は alreadyReversed 付きで最初の結果を返します。
metering.snapshot を読んでください。packs.list の役割です。paid: false と示し、明細はそのまま残ります。unattributed の残高が作成者に届くこと。後でキーが信頼されても自動で付け替えるコードはなく、手作業が必要です。carriedForwardMinor は未締めのラインではなく、直近の明細に由来します。残高、ライン、明細、支払いの読み取りにロールは不要です。条件や受取人の書き込み、record、refund、close はワークスペース管理者向けです。
install、usage、refund、adjustment。record は refund 以外を受け付け、refund は refund ルートだけが作成します。
platformFeeBps は 0 から 10000 の整数です。minimumPayoutMinor と holdDays は 0 以上の整数でなければなりません。close には from と to が必要で、from は to より前でなければなりません。期間がない場合は 400 を返します。account のない payable の受取人は 400 を返します。reason のない restricted も同様です。stored が含まれます。/api/v1/acp/pack-revenue/record収益ラインを追加して分割します。/api/v1/acp/pack-revenue/refundラインを正確に一度だけ取り消します。/api/v1/acp/pack-revenue/payee作成者の支払い状態を読み取り、または設定します。/api/v1/acp/pack-revenue/terms手数料、最低額、保留期間を読み取り、または設定します。/api/v1/acp/pack-revenue/close期間を明細に締め、支払い試行を記録します。/api/v1/acp/pack-revenue/statements明細を一覧表示します(作成者を指定することもできます)。/api/v1/acp/pack-revenue/payoutsすべての支払い試行とその理由を一覧表示します。このモジュールにMCPアクションはありません。任意のエージェントやプログラムからRESTで呼び出してください。
mandates.compile03Mandate studio and replayエージェントの憲章をコードとして書き、誰に何を許すかがどう変わるかを確認し、マンデートの次のバージョンとして適用します。civics.settings23Workspace constitutionこのワークスペースで、緊急度ごとに、エージェントの質問へ人が答えるべき速さと当番を設定します。change-trains.list24Staged change trains変更をまずフリートの一部に展開し、計測したシグナルで確認しながら、段階的に進めます。lenses.run26Governance lenses渡したデータに固定のチェックを実行し、毎回同じ答えとして、証拠付きの合格または不合格を得ます。attestation.policy27Artifact build attestationポリシーのスナップショットと検出器パックで受け入れるビルダーを決め、信頼できる作者が署名しても別のビルドで作られたものは拒否します。