Stripe发票下载链接中抵扣金额带负号的处理方案咨询

首先明确两个核心场景的处理方式：

1. 仅需获取不带负号的金额数值（用于业务逻辑/自定义展示） #

Stripe API返回的发票行项目中，抵扣项的amount字段为负数是官方用于标识贷方/退款类金额的逻辑，你可以直接在代码里对金额取绝对值后格式化。

Python示例 #

import stripe

stripe.api_key = "你的API密钥"
invoice = stripe.Invoice.retrieve("目标发票ID")

for line_item in invoice.lines.data:
    # 针对抵扣项（金额为负）做处理
    if line_item.amount < 0:
        # 取绝对值并转换为实际货币单位（Stripe金额以最小单位存储，比如美元为分）
        actual_amount = abs(line_item.amount) / 100
        # 格式化为带千分位的美元格式
        formatted_amount = f"${actual_amount:,.2f}"
        print(f"处理后金额: {formatted_amount}")

JavaScript示例 #

const stripe = require('stripe')('你的API密钥');

async function processInvoiceAmount(invoiceId) {
  const invoice = await stripe.invoices.retrieve(invoiceId);
  invoice.lines.data.forEach(lineItem => {
    if (lineItem.amount < 0) {
      const absAmount = Math.abs(lineItem.amount) / 100;
      // 用Intl API格式化货币
      const formattedAmount = new Intl.NumberFormat('en-US', {
        style: 'currency',
        currency: 'USD'
      }).format(absAmount);
      console.log(`处理后金额: ${formattedAmount}`);
    }
  });
}

processInvoiceAmount("目标发票ID");

2. 修改Stripe生成的发票PDF中的金额显示 #

Stripe默认发票PDF格式无法通过API参数直接去除负号，但可以通过自定义HTML发票模板实现：
在模板中使用Liquid语法判断金额正负，取绝对值后展示。示例片段：

{% for line_item in invoice.line_items %}
  <tr>
    <td>{{ line_item.description }}</td>
    <td>{{ line_item.quantity }}</td>
    <!-- 处理金额，取绝对值后格式化 -->
    <td>
      {% assign item_amount = line_item.amount | abs %}
      {{ item_amount | divided_by: 100 | money_with_currency }}
    </td>
  </tr>
{% endfor %}

你可以在Stripe后台的「设置 > 发票 > 发票模板」中上传自定义HTML模板，替换默认模板逻辑。

注意事项 #

• Stripe所有金额字段均以最小货币单位存储（如美元为分），处理时务必除以对应货币的进制转换为实际金额。
• 负号是Stripe区分借方/贷方金额的标准标识，修改显示前需确保业务逻辑中不会混淆金额的正负含义。

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