Django中Stripe支付分账优化需求：实现四部分资金拆分

核心调整方向 #

• 扩展分账规则，新增推荐人、物流方的资金划转逻辑
• 区分平台的两个Stripe API密钥，专门处理物流方的独立账户转账
• 加入推荐人资格校验，仅当卖家通过推荐码注册时触发对应分账

代码修改步骤 #

1. 配置双Stripe密钥 #

先在settings.py里添加两个密钥的配置，明确使用场景：

# settings.py
# 用于卖家、管理员、推荐人分账的主密钥
STRIPE_API_KEY_MAIN = "sk_live_your_main_key_here"
# 用于物流方账户转账的独立密钥
STRIPE_API_KEY_LOGISTICS = "sk_live_your_logistics_key_here"
# 物流方的固定Stripe账户ID
LOGISTICS_STRIPE_ACCOUNT_ID = "acct_your_logistics_account_id"

2. 重构AuctionPayment视图的分账逻辑 #

假设你的原视图代码类似下面的结构（基于常规Django Stripe支付视图推断）：

原代码参考：

class AuctionPayment(View):
    def post(self, request, *args, **kwargs):
        auction = Auction.objects.get(id=kwargs['auction_id'])
        total_amount = int(auction.final_price * 100)  # 转换为Stripe要求的分单位
        
        # 原分账：管理员抽10%，卖家拿剩余90%
        admin_fee = int(total_amount * 0.1)
        seller_amount = total_amount - admin_fee

        stripe.api_key = settings.STRIPE_API_KEY_MAIN
        intent = stripe.PaymentIntent.create(
            amount=total_amount,
            currency='usd',
            payment_method_types=['card'],
            transfer_data={
                'destination': auction.seller.stripe_account_id,
                'amount': seller_amount
            },
            application_fee_amount=admin_fee
        )
        return JsonResponse({'client_secret': intent.client_secret})

修改后的完整代码：

class AuctionPayment(View):
    def post(self, request, *args, **kwargs):
        auction = Auction.objects.get(id=kwargs['auction_id'])
        total_amount = int(auction.final_price * 100)
        # 从订单总金额中拆分出物流费用（假设你的Auction模型有logistics_fee字段）
        logistics_amount = int(auction.logistics_fee * 100)
        # 扣除物流费后的可分配金额
        distributable_amount = total_amount - logistics_amount

        # 1. 计算基础分账：管理员10%，卖家90%（基于扣除物流费后的金额）
        admin_base_fee = int(distributable_amount * 0.1)
        seller_amount = distributable_amount - admin_base_fee

        # 2. 处理推荐人分账：仅当卖家有推荐人时，从管理员份额中扣2%
        referrer_amount = 0
        referrer_stripe_id = None
        if hasattr(auction.seller, 'referrer') and auction.seller.referrer:
            # 推荐人拿管理员基础费用的2%
            referrer_amount = int(admin_base_fee * 0.02)
            referrer_stripe_id = auction.seller.referrer.stripe_account_id
            # 管理员最终所得 = 基础费用 - 推荐人提成
            admin_base_fee -= referrer_amount

        # 3. 创建主支付Intent，处理卖家、管理员、推荐人的分账
        stripe.api_key = settings.STRIPE_API_KEY_MAIN
        # 构建多笔分账列表
        transfer_items = [
            {
                'amount': seller_amount,
                'destination': auction.seller.stripe_account_id
            }
        ]
        # 如果有推荐人，添加对应的分账项
        if referrer_amount > 0 and referrer_stripe_id:
            transfer_items.append({
                'amount': referrer_amount,
                'destination': referrer_stripe_id
            })

        payment_intent = stripe.PaymentIntent.create(
            amount=total_amount,
            currency='usd',
            payment_method_types=['card'],
            application_fee_amount=admin_base_fee,  # 管理员最终所得
            transfer_group=f"auction_{auction.id}",  # 关联同一订单的所有转账，方便对账
            transfers=transfer_items  # 多笔分账配置
        )

        # 4. 单独处理物流方转账，使用专属API密钥
        stripe.api_key = settings.STRIPE_API_KEY_LOGISTICS
        stripe.Transfer.create(
            amount=logistics_amount,
            currency='usd',
            destination=settings.LOGISTICS_STRIPE_ACCOUNT_ID,
            transfer_group=f"auction_{auction.id}"
        )

        # 返回客户端所需的支付凭证
        return JsonResponse({
            'client_secret': payment_intent.client_secret,
            'status': 'success'
        })

关键细节说明 #

• 推荐人分账规则：严格按照需求，仅当卖家通过推荐码注册（即auction.seller.referrer存在）时，从管理员的基础提成中扣除2%给推荐人，确保总资金平衡
• 双密钥隔离：物流方转账使用独立的API密钥，避免与其他分账操作的密钥混淆，提升安全性
• transfer_group：用订单ID作为分组标识，让Stripe后台能关联同一订单的所有分账记录，方便后续对账和问题排查
• 字段适配：代码中假设了Auction模型有logistics_fee字段、Seller模型有referrer和stripe_account_id字段，你需要根据自己的实际模型结构调整这些字段名

必做的测试与异常处理 #

• 用Stripe测试密钥完成全流程测试，验证各主体的分账金额是否准确
• 添加异常捕获逻辑，处理Stripe API调用失败的情况（比如网络错误、账户无效等），避免订单状态异常
• 确保所有参与分账的主体都已完成Stripe账户的验证（尤其是接收转账的资格）

内容的提问来源于stack exchange，提问作者Tejinder Singh