更新时间：2023-03-30 10:39:05收藏我的文档设置返回文档目前开放平台多种产品在扣款时会涉及到 alipay.trade.pay（统一收单交易支付接口）。主要产品为当面付、刷脸付、支付宝预授权、新当面资金授权、周期扣款，这五类产品。由于不同产品设置参数要求不同，但是平台提供的 api 参数说明主要以当面付的条码付为准，因此各服务商或者开发技术人员在开发过程中出现关于参数的报错。为提高各开发人员对 alipay.trade.pay 参数的了解，该文档提供该接口的各产品的关键字段说明，其它参数建议仍然参考 api 文档。当面付当面付 的 alipay.trade.pay 关键参数可查看 条码支付快速接入。关键入参参数名称是否必传参数说明out_trade_no是商户订单号，商家自定义，需要保证不重复。scene是支付场景（条码支付）：固定传值 bar_code。auth_code是，25-30 开头的长度为 16-24 位的数字，实际字符串长度以开发者获取的付款码长度为准；付款码使用一次即失效（买家支付宝客户端中获取）。subject是订单标题total_amount是订单金额store_id否商户门店编号timeout_express否交易超时时间product_code否销售产品码（条码支付）：固定传值face_to_face_payment 关键出参参数名称是否必传参数说明trade_no是支付宝交易号biz_content 示例代码刷脸付 的 alipay.trade.pay 关键参数可查看 。关键入參参数名称是否必传参数说明out_trade_no是商户订单号，商家自定义，需要保证不重复。scene是支付场景（刷脸付）：固定传值 security_code。auth_code是刷脸支付传入人脸 zolozverify 接口返回的 ftoken刷脸付返回的 ftoken 为 fp 开头，如 fp0593e8d5c136277f13fd。subject是订单标题total_amount是订单金额store_id否商户门店编号timeout_express否交易超时时间product_code否销售产品码，该参数不要设置。关键出参参数名称是否必传参数说明trade_no是支付宝交易号biz_content 示例代码支付宝预授权 的 alipay.trade.pay 关键参数可查看 。关键入参参数名称是否必传参数说明out_trade_no是商户订单号，商家自定义。信用授权模式不可随意修改 out_trade_no，可查看 。auth_no是支付宝资金授权单号，冻结接口返回的冻结交易号auth_no。subject是订单标题total_amount是订单金额store_id否商户门店编号，建议与资金授权冻结接口中 extra_param 参数的 outstorecode 取值一致。timeout_express否交易超时时间。资金预授权，会按照接口传入的 timeout_express 进行设置。信用预授权，会无视接口传入的 timeout_express，按照默认的 15 天设置，建议商家通过 （统一收单交易关闭接口）关闭订单，根据需求，自己同步是否逾期记录。product_code是销售产品码（支付宝预授权），固定传值pre_auth_online。buyer_id是买家 uid，通过预授权冻结接口返回的 payer_user_id 字段获取（2088 开头）。seller_id是卖家 uid，即 pid 数据（2088 开头）。auth_confirm_mode是●auth_confirm_mode=complete，无需调用解冻接口，支付宝端在扣款成功后会自动解冻剩余金额，同时该笔授权订单完成。●auth_confirm_mode=not_complete，在收到支付成功通知后，商家自行调用解冻接口将余额进行解冻。关键出参参数名称是否必传参数说明trade_no是支付宝交易号biz_content 示例代码新当面资金授权 的 alipay.trade.pay 关键参数可查看 。关键入參参数名称是否必传参数说明out_trade_no是商户订单号，商家自定义。信用授权模式不可随意修改 out_trade_no，可查看 。auth_no是支付宝资金授权单号，冻结接口返回的冻结交易号auth_no。subject是订单标题total_amount是订单金额store_id否商户门店编号，建议与资金授权冻结接口中 extra_param 参数的 outstorecode 取值一致。timeout_express否交易超时时间。资金预授权，会按照接口传入的 timeout_express 进行设置。信用预授权，会无视接口传入的 timeout_express，按照默认的 15 天设置，建议商家通过 （统一收单交易关闭接口）关闭订单，根据需求，自己同步是否逾期记录。product_code是销售产品码（支付宝预授权），固定传值 pre_auth。buyer_id是买家 uid，通过预授权冻结接口返回的 payer_user_id 字段获取（2088 开头）。seller_id是卖家 uid，即 pid 数据（2088 开头）auth_confirm_mode是●auth_confirm_mode=complete，无需调用解冻接口，支付宝端在扣款成功后会自动解冻剩余金额，同时该笔授权订单完成。●auth_confirm_mode=not_complete，在收到支付成功通知后，商家自行调用解冻接口将余额进行解冻。关键出参参数名称是否必传参数说明trade_no是支付宝交易号biz_content 示例代码周期扣款周期扣款 的 alipay.trade.pay 关键参数可查看 后续扣款。注意：之前存在使用 agreement_params agreement_no 传参模式仍可使用，后续新接入代码推荐使用 scene auth_code。关键入参参数名称是否必传参数说明out_trade_no是商户订单号，商家自定义，需要保证不重复。subject是订单标题total_amount是订单金额store_id否商户门店编号，周期扣款不涉及门店，不要传。timeout_express否交易超时时间product_code是销售产品码（周期扣款）：固定传值cycle_pay_authscene是支付场景（周期扣款）：固定传值 deduct_pay。auth_code是用户授权码，周期扣款场景需传入签约成功后返回的。关键出参参数名称是否必传参数说明trade_no是支付宝交易号biz_content 示例代码iot收银 的 alipay.trade.pay 关键参数可查看 my.ix.startapp（刷脸支付/扫码支付）。关键入參参数名称是否必传参数说明out_trade_no是商户订单号，商家自定义，需要保证不重复。scene是支付场景（刷脸付）：固定传值 bar_code。auth_code是iot 客户端刷脸或者扫码返回的 barcode（付款码），barcode 付款码的有效期为 2 分钟。可以使用 my.request 将付款码传递给服务端。subject是订单标题total_amount是订单金额store_id否商户门店编号timeout_express否交易超时时间product_code否销售产品码，该参数不要设置。关键出参参数名称是否必传参数说明trade_no是支付宝交易号biz_content 示例代码如何区分刷脸付和扫付款码●当面付的条码付和刷脸付产品：○条码付的 auth_code 是用户支付宝客户端内的付款码，该信息为一串数字，如 28763443825664394。○刷脸付的 auth_code 是刷脸付客户端返回的 ftoken，该信息为 fp 开头，如 fp0593e8d5c136277f13fd。●iot 收银如何区分刷脸支付和扫码支付：○iot 收银无论是刷脸支付还是扫码支付，小程序客户端返回的 barcode 都为一串数字。○区分场景只能通过 my.ix.startapp 返回的关键出参 codetype 进行判断，f 代表刷脸，c 代表扫码。
