コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
財務の自動化
プラットフォームおよびマーケットプレイス
資金管理
開発者向けのツール
始める
支払い
財務の自動化
始める
支払い
財務の自動化
プラットフォームおよびマーケットプレイス
資金管理
概要
バージョン管理
変更ログ
API バージョンのアップグレード
SDK バージョンをアップグレードする
開発者向けのツール
SDK
API
    API v2
    API キー
    Stripe-Context ヘッダー
    日次の変更ログ
    レート制限
    自動化されたテスト
    メタデータ
    レスポンスの拡張
      ユースケース
    ページ分割
    ドメインと IP アドレス
    検索
    各地域への適応
    エラー処理
    エラーコード
テスト
ワークベンチ
イベントの送信先
ワークフロー
Stripe CLI
Stripe Shell
開発者ダッシュボード
エージェントツールキット
LLM を使用した構築Visual Studio Code をご利用の場合Stripe 健全性アラートファイルのアップロード
Security and privacy
セキュリティ
プライバシー
Stripe を拡張する
Stripe Apps
Stripe のコネクター
パートナー
Partner Ecosystem
パートナー認定
ホーム開発者向けのツールAPIExpanding responses

レスポンス拡張のユースケース

拡張属性を使用して一般的なタスクを実行する方法をご紹介します。

ページをコピー

特定の支払いに対する Stripe 手数料を確認する

支払いが処理され、取引残高が作成された後で、支払いの処理手数料を確認できます。Stripe は、この取引残高をバックグラウンドで自動作成します。charge.updated イベントには、balance_transaction プロパティ (txn_123 など) を介した取引残高への参照が含まれており、これは取引残高が作成され、利用可能な状態であることを示します。

取引残高を個別に検索する代わりに、expand を使用して 1 回のコールで取得できます。以下はその例です。

Command Line
curl
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "expand[]"="latest_charge.balance_transaction" \ -G

API バージョン 2022-08-01 以前のユーザー:

Command Line
curl
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "expand[]"="charges.data.balance_transaction" \ -G

注

PaymentIntent がキャプチャーされ、ステータスが succeeded になると、Stripe 手数料が表示されます。

入金に含まれる支払いを確認する

各自動入金は、Stripe アカウントの残高の履歴変更に結びついています。この API はこれらの履歴変更を Balance Transaction (取引残高) として記録します。これは、List Balance Transactions API を使用して取得できます。取引残高のリストから、source プロパティを展開し、何 (支払い、返金、送金など) がアカウント残高の変化を引き起こしたのか、情報を集めることができます。以下に例を挙げます。

Command Line
curl
curl https://api.stripe.com/v1/balance_transactions \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d payout=po_1Gl3ZLLHughnNhxyDrOia0vI \ -d type=charge \ -d "expand[]"="data.source" \ -G

注

「自動」入金に関してのみ、取引残高履歴を取得できます。手動の入金が有効になっている場合には、ご自身で残高履歴を追跡する必要があります。

入金の照合で詳細をご覧ください。

デスティネーション支払いで Connect を使用している場合、連結アカウントの代わりに同じ情報を取得することができます。唯一の違いは、デスティネーション支払いでは、売上を連結アカウントに移動するために、送金および関連付けられた支払い (Charge オブジェクトの形式で) の両方が関与します。このため、連結アカウントの入金にバンドルされた取引残高をリストアップする際、各取引のソースは元の Charge ではなく、送金の支払いに関連付けられます。元の Charge を取得するには、source_transfer プロパティを使用して、支払いに関連付けられた送金を拡張する必要があります。そこから、送金の source_transaction プロパティを拡張します。

Command Line
curl
curl https://api.stripe.com/v1/balance_transactions \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \ -d type=payment \ -d "expand[]"="data.source.source_transfer.source_transaction" \ -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \ -G
このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc