使用Python对接Stripe时支付总额异常的问题排查

核心问题出在Stripe金额参数的处理方式，以及货币计算的精度控制上：

Stripe的PaymentIntent.create接口要求amount传入最小货币单位的整数（比如美元对应美分，29.19美元要传2919），你现在直接把Decimal转字符串后去掉小数点的操作，会在计算结果存在多位小数时出错——比如当计算出的总额是29.189美元时，转字符串后去掉小数点得到29189，传给Stripe就会被当成2918.90美元扣款。

具体修复步骤 #

1. 优化购物车总额计算，确保精度 #

先简化重复计算，同时强制保留2位小数（符合货币规则）：

# cart.py
def get_total(self):
    subtotal = sum(Decimal(item['price']) * int(item['quantity']) for item in self.cart.values())
    tax_rate = Decimal('0.10')
    tax_price = subtotal * tax_rate
    shipping_cost = Decimal('5.00')  # 统一用Decimal避免类型转换隐患
    total = subtotal + tax_price + shipping_cost
    # 四舍五入保留2位小数，确保结果符合货币精度
    return total.quantize(Decimal('0.00'))

2. 正确转换为Stripe要求的金额格式 #

别用字符串替换的方式，直接通过乘法转换为最小单位后转整数，这是最可靠的做法：

# Payment views.py
@login_required
def CartView(request):
    cart = Cart(request)
    total = cart.get_total()
    # 转换为美分（美元的最小单位），转整数传入Stripe
    stripe_amount = int(total * Decimal('100'))

    stripe.api_key = '你的Stripe密钥'  # 替换为实际密钥
    intent = stripe.PaymentIntent.create(
        amount=stripe_amount,
        currency='usd',
        metadata={'userid': request.user.id}
    )

3. 调整模型字段的精度限制 #

你的Order类total_paid字段的max_digits=5不够用（比如2918.90美元需要整数位4位+小数位2位，共6位），建议修改：

# Order类
total_paid = models.DecimalField(max_digits=6, decimal_places=2)

关键提醒 #

• 全程用Decimal处理货币计算，绝对不要用浮点数，避免精度丢失
• 处理支付接口的金额时，一定要用乘法转换为最小单位，别用字符串操作，防止多位小数导致的错误
• 货币计算后必须用quantize保留2位小数，确保四舍五入符合业务逻辑

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