Clarify accounting and window semantics of agent_wallet_spend_limits.used

オープン
#508 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
18/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
go, typescript
領域
documentation

調査の方向性

This is a request for the supported accounting and window contract behind daily.used and thirty_day.used in user-info retrieve, not a code change. Start from the linked Go SDK types in packages/sdk-go/types.go and the spend-request documentation, and check whether the CLI source defines any of the counting. Done means a maintainer-confirmed definition of counted amounts, window boundaries, currency and payment correlation fields, or a clear statement that some of it is server-defined.

索引モデルが issue の本文から書いたものです。

説明

I am integrating @stripe/[email protected] and need to interpret daily.used and thirty_day.used from user-info retrieve correctly.

The spend-request documentation describes these values in cents. The 1.0.0 Go SDK types describe both counters as rolling. I could not find the accounting definition needed to compare them with request/payment history.

Could you clarify or link to the supported contract for:

  1. Counted amounts: Do used values count requested, approved/reserved, authorized or completed payment amounts? When do cancellation, expiry, failure, refund and amount changes affect them?
  2. Windows and timing: Does daily mean the preceding 24 hours and thirty_day the preceding 720 hours? Which event timestamp and boundary rule determine membership? Is there an observation timestamp or documented update delay for the counters?
  3. Source scope and currency: Do these counters and spend-request list --include-history cover the same user/grants? What history retention or pagination limits apply? Is counter usage always USD cents, including requests in other currencies?
  4. Correlation: Which payment identity, amount and time fields should be used to explain usage in both windows without counting the same payment twice? In particular, what event and time unit does payment_status_details.created represent, and is the supported transaction ID at request level or inside payment details? Is request history sufficient, or is that reconciliation unsupported through these commands?

This is a documentation question, not an account-specific incident. No credentials, account lookup or payment reproduction are needed. If the behavior differs from CLI 1.0.0, please identify which semantics are version-specific and which are server-defined.

主要言語
TypeScript
スター
885
フォーク
156
平均マージ
1日 1時間
マージ済み PR(30日)
64

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

stripe/link-cli のほかの issue

stripe/link-cli の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。