async-stripe Connect 平台实战多商户收款、转账与分账完整教程【免费下载链接】async-stripeAsync (and blocking!) Rust bindings for the Stripe API项目地址: https://gitcode.com/gh_mirrors/as/async-stripeasync-stripe 是 Stripe API 的异步也支持阻塞式Rust 绑定库而Stripe Connect 多商户收款正是它最强大的应用场景之一一个平台账号可以管理成千上万个商户Connected Account完成收款、转账与分账。本教程将带你从零搭建一个完整的 Connect 平台涵盖商户入驻、收款、自动分账、手动转账与退款五个核心环节全部使用 async-stripe 的官方风格代码新手也能跟着一步步跑通。一、为什么用 async-stripe 做 Connect 平台Stripe Connect 解决的是一类经典问题平台型业务电商 SaaS、聚合支付、众包平台需要代收商户资金再按规则分账。原生 REST API 需要手写大量样板代码而 async-stripe 把这一切封装成了类型安全的 Rust 结构体平台能力async-stripe 对应模块说明商户入驻stripe_connect::account创建/更新/检索 Connected Account入驻引导stripe_connect::account_link生成对账、KYC 的 Onboarding 链接平台收款stripe_core::payment_intent带transfer_data的收款单自动分账CreatePaymentIntentTransferData收款时自动把资金划给商户手动转账stripe_connect::transfer从平台余额转账给商户退款stripe_connect::transfer_reversal冲正已完成的转账整个仓库采用 workspace 结构主 crate 是async-stripe业务模块分布在generated/async-stripe-connect、generated/async-stripe-core、generated/async-stripe-payment等子 crate 中按领域拆分配置清晰。二、最快配置方法3 步搭好项目环境第 1 步创建项目并添加依赖在Cargo.toml中引入 async-stripe记得开启需要的 feature。Connect 相关能力默认已包含[dependencies] async-stripe 0.41 tokio { version 1, features [full] }第 2 步初始化客户端async-stripe 的入口是Client只需传入 Stripe 密钥。测试阶段强烈建议使用sk_test_开头的测试密钥use stripe::Client; let secret_key std::env::var(STRIPE_TEST_SECRET_KEY).expect(缺少测试密钥); let client Client::new(secret_key);参考官方示例 examples/endpoints/src/main.rs它从环境变量读取密钥并复用了同一个Client跑完全部示例。第 3 步启用 Connect 并配置品牌信息在 Stripe Dashboard 的 Connect 设置中启用平台功能并配置品牌图标与品牌色——这一步缺失会导致 Onboarding 链接生成失败。配置好后我们就可以开始写核心代码了。三、商户入驻从创建账户到 Onboarding 链接多商户收款的第一步是为每个商户创建 Connected Account。参考官方示例 examples/endpoints/src/connect.rs创建 Express 类型账户并申请刷卡收款与转账能力use stripe_connect::account::{ CreateAccount, CreateAccountCapabilities, CreateAccountCapabilitiesCardPayments, CreateAccountCapabilitiesTransfers, CreateAccountType, }; use stripe_connect::account_link::{CreateAccountLink, CreateAccountLinkType}; // 1. 创建商户账户 let account CreateAccount::new() .type_(CreateAccountType::Express) .capabilities(CreateAccountCapabilities { card_payments: Some(CreateAccountCapabilitiesCardPayments { requested: Some(true) }), transfers: Some(CreateAccountCapabilitiesTransfers { requested: Some(true) }), ..Default::default() }) .send(client) .await?; // 2. 生成入驻链接跳转给商户完成 KYC let link CreateAccountLink::new(account.id.clone(), CreateAccountLinkType::AccountOnboarding) .refresh_url(https://your-app.com/refresh) .return_url(https://your-app.com/return) .send(client) .await?; // 3. 把 link.url 重定向给商户浏览器几个关键点账户类型Express推荐Stripe 托管 KYC 流程、Standard商户自己登录 Stripe或Custom平台全托管。capabilities必须显式请求card_payments和transfers否则商户无法收款与提现。refresh_url / return_url用户在入驻中途离开或完成后Stripe 会跳转到这两个地址务必保证可访问。商户完成入驻后把account.id保存到你的数据库后续所有收款、分账都依赖这个 ID。四、多商户收款用 transfer_data 实现自动分账这是 Connect 平台最核心的一步顾客付款 → 平台收手续费 → 剩余资金自动划给商户。async-stripe 中只需在创建 PaymentIntent 时附加transfer_data和application_fee_amount即可use stripe_core::payment_intent::CreatePaymentIntent; use stripe_types::Currency; // 订单金额 1000 分$10平台抽 100 分$1商户得 $9 let intent CreatePaymentIntent::new(1000, Currency::USD) .transfer_data( CreatePaymentIntentTransferData::new(account.id) // 目标商户 .amount(900) // 可选只划 900 分 ) .application_fee_amount(100) // 平台手续费 .send(client) .await?;这条请求完成三件事顾客支付成功后900 分自动进入商户的 Stripe 余额100 分作为平台手续费进入你的平台余额资金流全程由 Stripe 撮合平台无需自己记账划款。transfer_data与application_fee_amount的定义可以在 generated/async-stripe-core/src/payment_intent/requests.rs 中看到支持创建、更新、捕获三个阶段分别设置。完整的收款流程创建客户、绑定银行卡、确认支付可参考 examples/endpoints/src/payment_intent.rs。五、转账与分账灵活的资金调度方案自动分账适合固定抽成的场景但有时你需要灵活调度资金例如结算给供应商、发放奖励或补充分账。这时使用transfer模块手动发起转账use stripe_connect::transfer::CreateTransfer; // 从平台余额转账 $50 给指定商户 let transfer CreateTransfer::new(Currency::USD, account.id) .amount(5000) .transfer_group(order_12345) // 归组便于对账 .send(client) .await?;手动转账的注意事项余额充足转账金额不能超过平台可用余额否则会收到 Insufficient Funds 错误transfer_group把一笔订单的多笔转账归到同一分组方便在 Dashboard 里统一对账分账到多个商户循环调用CreateTransfer即可把一笔收入拆给多个商户分摊比例由你的业务规则决定。查询转账记录也很方便ListTransfer支持按destination、transfer_group和创建时间过滤还可以用内置的paginate()分页拉取。六、退款与转账冲正完整的资金闭环资金管理不止“进”还有“出”。当订单退款或转账出错时订单退款对原 PaymentIntent 发起 Refund若该笔款项已通过transfer_data自动划给商户Stripe 会自动从商户余额扣回转账冲正对已完成的CreateTransfer调用CreateTransferReversal将资金从商户余额退回平台余额。use stripe_connect::transfer_reversal::CreateTransferReversal; // 冲正一笔转账 CreateTransferReversal::new(transfer.id) .send(client) .await?;退款冲正逻辑务必与你的业务状态机联动避免重复冲正导致余额异常。七、测试与上线避坑清单Connect 平台的调试建议从测试模式开始测试密钥即可创建真实的测试商户与测试卡号如4000008260000000无需真实资金环节常见坑解决方案商户入驻未配置品牌图标/颜色先在 Dashboard 的 Connect 设置中配置自动分账忘记申请 transfers 能力创建账户时显式requested: Some(true)手动转账余额不足报错先收款到平台余额再转账回调地址refresh/return URL 不可达使用 HTTPS 且支持公网访问生产环境误用测试密钥上线前切换sk_live_密钥并二次确认最后提醒上线前务必阅读MIGRATION.md与CHANGELOG.mdasync-stripe 的 API 会随 Stripe 官方接口升级保持版本更新能避免接口字段变更带来的编译错误。八、小结通过 async-stripe一个多商户收款、转账与分账的完整 Connect 平台只需要四个核心 APICreateAccount入驻、CreateAccountLink引导、CreatePaymentIntent transfer_data自动分账、CreateTransfer手动转账。Rust 的类型系统在编译期就帮你挡住了字段拼写错误和金额单位错误配合官方示例 examples/endpoints 目录下的完整代码从 Demo 到生产只需要替换密钥和回调地址。现在就动手用测试密钥跑通你的第一个多商户收款流程吧【免费下载链接】async-stripeAsync (and blocking!) Rust bindings for the Stripe API项目地址: https://gitcode.com/gh_mirrors/as/async-stripe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
