调至内容部分
创建账户或登录
Stripe 文档徽标
/
询问人工智能
创建账户登录
开始
付款
销售收入
平台和交易市场
资金管理
开发人员资源
API 和 SDK帮助
概览
版本管理
更改日志
    概览
    Clover
    Basil
    Acacia
    先前版本
升级您的 API 版本
升级 SDK 版本
基础功能
SDK
API
测试
Stripe CLI
项目示例
工具
Stripe 管理平台
Workbench
开发人员管理平台
Stripe for Visual Studio Code
Terraform
功能
工作流程
事件接收端
Stripe 健康警报文件上传
AI 解决方案
代理工具包
模型上下文协议构建代理式 AI SaaS 计费工作流
安全与隐私
安全
Stripebot 网络爬虫
扩展 Stripe
构建 Stripe 应用程序
使用 Stripe 的应用程序
合作伙伴
合作伙伴生态
合作伙伴认证
美国
简体中文
首页开发人员资源ChangelogAcacia2024-11-20.acacia

Trace payouts with a unique identifier

最新

Introduces a trace_id field on the Payout resource.

Trace IDs are unique identifiers for payouts that our banking partners create to help you track missing or delayed payouts. If an expected payout hasn’t settled in your bank account after 10 business days, contact your bank for an update and provide the trace ID.

For Connect users, you can provide your connected accounts their payout trace IDs by retrieving them from the Stripe API.

This enables your connected accounts to self-serve their late or missing payouts without the need for manual support intervention.

The trace_id contains two sub-fields: value and status:

  • value: The trace ID string that we retrieve from our banking partners when a payout is paid.
  • status: The current status of the trace ID during retrieval from our banking partners.
状态描述
pendingAfter you mark a payout as paid, Stripe attempts to retrieve the trace ID from the banking partner for up to 10 days. During this time the status becomes pending.
supportedAfter the banking partner provides the trace ID, the status becomes supported and Stripe updates the value.
unsupportedSome scenarios prevent providing the trace ID, such as a payout failure or an unsupported country and currency combination. In these cases the status is unsupported.

影响

You can get the trace ID for a specific payout by retrieving the payout.

For Connect users, providing the trace ID to your connected accounts allows you to:

  • Minimize support requests from your connected accounts relating to late or missing payouts.
  • Improve user satisfaction by letting your connected accounts self-serve their late or missing payout investigations with their bank.

变化

参数更改资源或 端点
trace_id已添加
Payout

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2024-11-20.acacia
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

此页面的内容有帮助吗?
是否
  • 需要帮助?联系支持。
  • 查看我们的更改日志。
  • 有问题?联系销售。
  • LLM? Read llms.txt.
  • Powered by Markdoc