You need to enable JavaScript to run this app. Google Apps Script调用Stripe API发发票报parameter_invalid_integer错误的due_date格式问题
优惠活动
大模型
产品
解决方案
定价
更多

Google Apps Script调用Stripe API发发票报parameter_invalid_integer错误的due_date格式问题

Stripe API due_date 参数格式错误修复指南

核心报错根因

parameter_invalid_integer报错和日期的字面写法无关,本质是传入的due_date触发了Stripe的类型校验规则,结合Google Apps Script(GAS)的运行特性,之前尝试的三种写法全部踩了校验红线:

  • 直接传Date.now():该方法返回毫秒级Unix时间戳,数值规模远超过合法的秒级时间戳范围,被判定为无效整数
  • 传任意格式的日期字符串:当collection_method设置为send_invoice时,due_date不接受字符串类型输入,哪怕字符串的日期格式写得再规范,也会直接触发类型报错
  • 手动除以1000转换时间戳:计算完成后没有做取整操作,得到的是带小数的浮点值,Stripe强制要求该参数为无小数的整数类型,哪怕浮点值的数值是完全正确的,也会被识别为非整数触发报错

正确的参数要求

当开启send_invoice收款方式发送发票时,due_date必须同时满足两个条件:

  • 数据类型为纯整数,不能是浮点数、字符串、原生日期对象
  • 数值为从1970-01-01 UTC起点计算的秒级Unix时间戳,不能使用毫秒级时间戳

可直接复用的修正代码

// 1. 构造UTC时区的到期日对象,避免GAS默认时区导致的日期偏移
const targetDueDate = new Date('2022-01-01T00:00:00Z');
// 2. 关键处理:毫秒转秒后用Math.floor取整,得到纯整数的秒级时间戳
const dueDateTimestamp = Math.floor(targetDueDate.getTime() / 1000);

var url3 = "https://api.stripe.com/v1/invoices";
var params3 = {
  method: "post",
  headers: {Authorization: "Basic " + Utilities.base64Encode("sk_test_XXXXX:")},
  payload: {
    customer: responseValue.id,
    collection_method : "send_invoice",
    due_date: dueDateTimestamp
  }
};
var res3 = UrlFetchApp.fetch(url3, params3);
Logger.log(res3.getContentText());

GAS场景专属踩坑提醒

  • 原代码中如果responseValue2.date是其他来源的日期值(比如表格单元格的日期、接口返回的日期字段),必须先经过上述“转Date对象→毫秒转秒→取整为整数”的步骤,不能直接把原始值传入参数
  • 构造日期对象时尽量带上UTC时区标识(T00:00:00Z),不要依赖GAS服务器的默认时区,否则很容易出现日期差一天的问题
  • 不要把原生Date对象直接塞进payload,UrlFetchApp序列化参数时会自动把对象转成字符串,必然触发类型校验错误

内容的提问来源于stack exchange,提问作者Ginxxx

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 18:06:05