调至内容部分
创建账户
或
登录
Stripe 文档徽标
/
询问人工智能
创建账户
登录
开始
付款
财务自动化
平台和交易市场
资金管理
开发人员工具
开始
付款
财务自动化
开始
付款
财务自动化
平台和交易市场
资金管理
概览
版本管理
更改日志
升级您的 API 版本
升级 SDK 版本
开发人员工具
SDK
API
    API v2
    API 密钥
    Stripe-Context 标头
    每日变更日志
    速率限制
    自动化测试
    元数据
    扩展响应
      用例
    分页
    域名和 IP 地址
    搜索
    本地化
    错误处理
    错误代码
测试
Workbench
事件接收端
工作流程
Stripe CLI
Stripe Shell
开发人员管理平台
代理工具包
使用大语言模型构建Stripe for Visual Studio CodeStripe 健康警报文件上传
Security and privacy
安全
隐私
扩展 Stripe
Stripe 应用程序
Stripe Connector
合作伙伴
合作伙伴生态
合作伙伴认证
首页开发人员工具APIExpanding responses

扩展响应用例

了解如何利用扩展属性执行常见任务。

复制页面

查看特定付款的 Stripe 费用

您可以在处理付款并创建余额交易记录后查看付款的处理费用。Stripe 在后台自动创建此 余额交易。该 charge.updated 事件包括通过 balance_transaction 属性(例如,txn_123)对余额交易的引用,指示余额交易已创建并可供使用。

不用单独检索余额交易,可以用 expand 在一个单独的调用中检索它:例如:

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

注意

要想看到 Stripe 费用,必须要捕获 Payment Intent 且状态必须是 succeeded。

查看提现中包含的收款

每笔自动提现都会与您的 Stripe 账户余额的历史变化有关。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 进行定向收款,则可以代您的 Connect 子账户检索同一信息。不同之处在于,向 Connect 子账户转移资金时,定向收款涉及转账和关联的付款(以 Charge 对象的形式)。因此,在列示特定于您的 Connect 子账户的提现的余额交易时,每笔余额交易的来源都会关联到转账的 Payment,而非原始 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? Read llms.txt.
Powered by Markdoc