扩展响应用例
了解如何利用扩展属性执行常见任务。
查看特定付款的 Stripe 费用
有时,您可能想查看某笔付款的处理费。您只有在付款成功且创建了余额交易后,才能看到这些 Stripe 费用。该余额交易是在后台自动创建的,charge.updated
事件将显示费用。
不用单独检索余额交易,可以用 expand
在一个单独的调用中检索它:例如:
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
-u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
-d "expand[]"="latest_charge.balance_transaction" \
-G
API 版本 2022-08-01 或更早版本的用户:
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
-u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
-d "expand[]"="charges.data.balance_transaction" \
-G
备注
要想看到 Stripe 费用,必须要捕获 Payment Intent 且状态必须是 succeeded
。
查看提现中包含的收款
每笔自动提现都会与您的 Stripe 账户余额的历史变化有关。API 以余额交易来记录这些历史变化,可通过余额交易列表来检索。您可以从余额交易列表中扩展 source 属性来收集触发账户余额变化的因素(收款、退款、转账,等)的信息。例如:
curl https://api.stripe.com/v1/balance_transactions \
-u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
-d payout=po_1Gl3ZLLHughnNhxyDrOia0vI \
-d type=charge \
-d "expand[]"="data.source" \
-G
备注
只能检索_自动_提现所涉及的余额交易记录。如果启用了手动提现,则必须自己跟踪交易记录。
了解有关提现对账的更多信息。。
如果您用 Connect 进行定向收款,则可以代您的 Connect 子账户检索同一信息。不同之处在于,向 Connect 子账户转移资金时,定向收款涉及转账和关联的付款(以 Charge 对象的形式)。因此,在列示特定于您的 Connect 子账户的提现的余额交易时,每笔余额交易的来源都会关联到转账的 Payment,而非原始 Charge。检索原始 Charge 时,需要通过 source_transfer 属性扩展付款关联的转账;从这里,扩展转账的 source_transaction 属性。
curl https://api.stripe.com/v1/balance_transactions \
-u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
-d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \
-d type=payment \
-d "expand[]"="data.source.source_transfer.source_transaction" \
-H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \
-G