开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
凯发app官方网站的技术支持 & 案例 faq 
当面付
刷脸付
app支付
手机网站支付
电脑网站支付
案例分析
sdk & demo下载
常见问题
常用工具
直付通
花呗分期
支付能力 >  >  > timeout_express与time_expire参数详解
收藏
我的文档
设置
支付接口的 timeout_express 与 time_expire 参数区别说明如下。
参数区别
对比
timeout_express
time_expire
参数说明
支付超时参数(相对超时参数):在订单创建后开始生效,超时未支付订单将关闭
绝对超时参数:用户支付订单的最晚时间。
接口请求和用户支付都不可超过 time_expire 时间。
支持产品
支持当面付、电脑网站支付、手机网站支付和 app 支付等产品。
支持当面付、电脑网站支付、手机网站支付和 app 支付等产品。
设置要求
取值范围:1m~15d。
m-分钟,h-小时,d-天,1c-当天(在“1c-当天”的情况下,无论交易何时创建,都将在 0 点关闭)。
该参数数值不接受小数点,如 1.5h,可转换为 90m。

(1)当面付默认超时时间为 3h,timeout_express<=3h。
注意当面付设置 timeout_express>3h 时,接口不报错,但是订单将在 3 小时关闭。
(2)电脑网站支付、手机网站支付和 app 支付默认订单超时时间为 15d,timeout_express<=15d。
取值范围:不可大于订单默认的超时时间。

(1)当面付默认超时时间为 3h,time_expire 结束时间不可大于订单创建后的 3h。
注意:当面付设置 time_expire>3h 时,接口不报错,但是订单将在 3 小时关闭。
(2)电脑网站支付、手机网站支付和 app 支付默认订单超时时间为 15d,time_expire<=15d。

格式:
(1)手机网站支付和 app 支付参数格式精确到分和秒都可以。
(2)当面付、电脑网站支付只支持精确到秒,固定格式:yyyy-mm-dd hh:mm:ss。
建议接口请求参数设置精确到秒。
生效时间
详情请见下方 timeout_express 生效时
time_expire 为固定时间节点,接口请求和用户支付时间都不可超过 time_expire。
注意事项
(1)以支付宝系统时间为准。
(2)参数优先级:qr_code_timeout_express > time_expire > timeout_express。
(3)订单创建后超时,交易关闭的订单无法支付,只能更换订单号重新发起支付请求。
(4)绝对超时时间(time_expire)内部处理是按照整分钟数计算的,建议参数值设置时间差不可过小。
如请求参数:expiretime=wed feb 24 17:14:39
请求到达时间:2021-02-24 17:12:45,980
两者相减= 1分44秒= 1m 最终超时时间是 1min
timeout_express 生效时间
电脑网站支付
唤起收银台开始计时 (这里的计时是本次收银台的倒计时,使用相同的订单重新唤起收银台将会重新计时)。
注意:电脑网站支付接口比较特殊,实际超时时间是需要买家扫码成功或是登录账号成功才开始计算,这里显示的都为收银台时间。

超时订单关闭(关闭使用相同的订单需要重新唤起收银台再次发起支付)。

手机网站
输入支付密码订单创建超时时间开始计算,如果用户余额不足,才会在手机端显示等待买家付款,超时后关闭。 

当面付 
统一收单交易支付接口(条码支付):输入支付密码订单创建超时时间开始计算,如果用户余额不足,才会在手机端显示等待买家付款,超时后关闭。 
统一收单线下交易预创建(扫码支付):商家生成订单二维码,用户使用支付宝客户端扫码以后,开始计算订单超时时间。
统一收单交易创建接口:商家成功创建订单时开始计算订单超时时间,超时订单关闭。
app 支付
输入支付密码订单创建超时时间开始计算,如果用户余额不足,才会在手机端显示等待买家付款, 超时后关闭。
time_expire 超时案例
与 timeout_express 参数不同的是,time_expire 是绝对的时间。
例如设置此参数值为:2018-01-15 16:03:00 时,在这个时间之前正确地去请求手机网站接口,是不出现任何报错,并且可以正常支付。
1如果在 2018-01-15 16:03:00 之后去支付,将会报错“订单参数异常,请重新下单后再发起付款”。
2如果在 2018-01-15 16:03:00 之前请求支付宝,唤起了支付页面或者支付宝 app 后,不进行支付,直到超过 time_expire 的时间后去支付也将会报错“订单已超时,不能付款”。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图