更新时间:2023-04-04 10:07:20收藏我的文档设置返回文档支付接口的 timeout_express 与 time_expire 参数区别说明如下。参数区别对比timeout_expresstime_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 最终超时时间是 1mintimeout_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 的时间后去支付也将会报错“订单已超时,不能付款”。