jsapi支付
通过jsapi支付下单接口完成交易的创建，获取交易号，使用支付宝提供的小程序方法（my.tradepay）完成支付流程
公共请求参数
业务请求参数
out_trade_no必选string(64)
【描述】商户订单号。
由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。
由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。
【示例值】20150320010101001
total_amount必选price(9)
【描述】订单总金额。
单位为元，精确到小数点后两位，取值范围：[0.01,100000000] 。
单位为元，精确到小数点后两位，取值范围：[0.01,100000000] 。
【示例值】88.88
subject必选string(256)
【描述】订单标题。
注意：不可使用特殊字符，如 /，=，& 等。
注意：不可使用特殊字符，如 /，=，& 等。
【示例值】iphone6 16g
product_code必选string(64)
【描述】产品码。
商家和支付宝签约的产品码。
小程序场景支付：jsapi_pay。
商家和支付宝签约的产品码。
小程序场景支付：jsapi_pay。
【示例值】jsapi_pay
op_app_id必选string(32)
【描述】小程序支付中，商户实际经营主体的小程序应用的appid，也即最终唤起收银台支付所在的小程序的应用id
【注意事项】商户需要先在产品管理中心绑定该小程序appid，否则下单会失败
【示例值】2014072300007148
以下参数 二选一 传入
buyer_idstring(28)
【描述】买家支付宝用户id。
2088开头的16位纯数字，小程序场景下获取用户id请参考：用户授权;
注：交易的买家与卖家不能相同。
2088开头的16位纯数字，小程序场景下获取用户id请参考：用户授权;
注：交易的买家与卖家不能相同。
新商户建议使用buyer_open_id替代该字段。对于新商户，buyer_id字段未来计划逐步回收，存量商户可继续使用。如使用buyer_open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088102146225135
buyer_open_idstring(128)
【描述】买家支付宝用户唯一标识 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
op_buyer_open_id特殊可选string(128)
【描述】买家支付宝用户唯一标识（商户实际经营主体的小程序应用关联的买家open_id）
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
seller_id可选string(28)
【描述】卖家支付宝用户id。
当需要指定收款账号时，通过该参数传入，如果该值为空，则默认为商户签约账号对应的支付宝用户id。
收款账号优先级规则：门店绑定的收款账户>请求传入的seller_id>商户签约账号对应的支付宝用户id；
注：直付通和机构间联场景下seller_id无需传入或者保持跟pid一致；
如果传入的seller_id与pid不一致，需要联系支付宝小二配置收款关系；
当需要指定收款账号时，通过该参数传入，如果该值为空，则默认为商户签约账号对应的支付宝用户id。
收款账号优先级规则：门店绑定的收款账户>请求传入的seller_id>商户签约账号对应的支付宝用户id；
注：直付通和机构间联场景下seller_id无需传入或者保持跟pid一致；
如果传入的seller_id与pid不一致，需要联系支付宝小二配置收款关系；
【示例值】2088102146225135
body可选string(128)
【描述】订单附加信息。
如果请求时传递了该参数，将在异步通知、对账单中原样返回，同时会在商户和用户的pc账单详情中作为交易描述展示
如果请求时传递了该参数，将在异步通知、对账单中原样返回，同时会在商户和用户的pc账单详情中作为交易描述展示
【示例值】iphone6 16g
goods_detail可选goodsdetail[]
【描述】订单包含的商品列表信息，json格式。
【示例值】[{"goods_id":"apple-01","goods_name":"ipad","goods_category":"7788230","price":"2000.00","quantity":"1"}]
goods_id必选string(32)
【描述】商品的编号，该参数传入支付券上绑定商品goods_id，倘若无支付券需要消费，该字段传入商品最小粒度的商品 id（如：若商品有 sku 粒度，则传商户 sku 粒度的id）。
当前接口的extend_params.trade_component_order_id 字段不为空时，该字段需与交易组件订单参数保持一致
当前接口的extend_params.trade_component_order_id 字段不为空时，该字段需与交易组件订单参数保持一致
【示例值】apple-01
goods_name必选string(256)
【描述】商品名称
【示例值】ipad
quantity必选number(32)
【描述】商品数量，支持小数，精确到小数点后两位
【示例值】1、1.50
price必选price(9)
【描述】商品单价，单位为元
【示例值】2000
out_item_id特殊可选string(100)
【描述】商家侧小程序商品id，指商家提报给小程序商品库的商品。当前接口的extend_params.trade_component_order_id字段不为空时该字段必填，且与交易组件订单参数保持一致。了解小程序商品请参考：https://opendocs.alipay.com/mini/06uila?pathhash=63b6fba7
【示例值】outitem_01
out_sku_id特殊可选string(64)
【描述】商家侧小程序商品sku id，多个sku时则需传入，无多个sku时无需传入。当前接口的extend_params.trade_component_order_id字段不为空时该字段必须与交易组件订单参数保持一致。
【示例值】outsku_01
alipay_goods_id可选string(32)
【描述】支付宝定义的统一商品编号
【示例值】20010001
goods_category可选string(24)
【描述】商品类目
【示例值】34543238
categories_tree可选string(128)
【描述】商品类目树，从商品类目根节点到叶子节点的类目id组成，类目id值使用|分割
【示例值】124868003|126232002|126252004
body可选string(1000)
【描述】商品描述信息
【示例值】特价手机
show_url可选string(400)
【描述】商品的展示地址
【示例值】http://www.alipay.com/xxx.jpg
time_expire可选string(32)
【描述】订单绝对超时时间。
格式为yyyy-mm-dd hh:mm:ss。
注：time_expire和timeout_express两者只需传入一个或者都不传，如果两者都传，优先使用time_expire。
格式为yyyy-mm-dd hh:mm:ss。
注：time_expire和timeout_express两者只需传入一个或者都不传，如果两者都传，优先使用time_expire。
【示例值】2021-12-31 10:05:00
timeout_express可选string(100)
【描述】订单相对超时时间。从交易创建时间开始计算。
该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。 该参数数值不接受小数点， 如 1.5h，可转换为 90m。
当面付场景默认值为3h。
注：time_expire和timeout_express两者只需传入一个或者都不传，如果两者都传，优先使用time_expire。
该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。 该参数数值不接受小数点， 如 1.5h，可转换为 90m。
当面付场景默认值为3h。
注：time_expire和timeout_express两者只需传入一个或者都不传，如果两者都传，优先使用time_expire。
【示例值】90m
extend_params可选extendparams
【描述】业务扩展参数
【示例值】{“sys_service_provider_id”:” 2088511833207846”}
sys_service_provider_id可选string(64)
【描述】系统商编号
该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的pid
该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的pid
【示例值】2088511833207846
hb_fq_num可选string(5)
【描述】使用花呗分期要进行的分期数
【示例值】3
hb_fq_seller_percent可选string(3)
【描述】使用花呗分期需要卖家承担的手续费比例的百分值，传入100代表100%
【示例值】100
trade_component_order_id可选string(128)
【描述】公域商品交易业务订单id
【示例值】2023060801502300000008810000005657
business_params可选businessparams
【描述】商户传入业务信息，具体值要和支付宝约定，应用于安全，营销等参数直传场景，格式为json格式
【示例值】{"data":"123"}
enterprise_pay_info可选string(1024)
【描述】因公付业务信息
【示例值】{"category_list":[{"price":"10.24","name":"餐饮服务","category":"3070401000000000000"}]}
enterprise_pay_amount可选string(32)
【描述】因公付金额
【示例值】10.00
mc_create_trade_ip可选string(128)
【描述】商户端创建订单的 ip，须上传正确的用户端外网 ip，支持 ipv4/ipv6 格式；
mc_create_trade_ip和mccreatetradeip（旧）参数描述相同，首选mc_create_trade_ip入参，请勿重复入参；
如已入参mccreatetradeip（旧），无需新增入参mc_create_trade_ip。
mc_create_trade_ip和mccreatetradeip（旧）参数描述相同，首选mc_create_trade_ip入参，请勿重复入参；
如已入参mccreatetradeip（旧），无需新增入参mc_create_trade_ip。
【示例值】127.0.0.1
tiny_app_merchant_biz_type｜小程序细分业务场景可选string(64)
【描述】当需要在 商家平台（b.alipay.com）—数据中心 中查看对应业务场景下的数据明细可以通过该参数传入
支持传入的值：
支持传入的值：
【示例值】kx_shopping
passback_params可选string(512)
【描述】公用回传参数。
如果请求时传递了该参数，支付宝会在异步通知时将该参数原样返回。
如果请求时传递了该参数，支付宝会在异步通知时将该参数原样返回。
【示例值】merchantbiztype=3c&merchantbizno=2016010101111
discountable_amount可选price(9)
【描述】可打折金额。
参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。
如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】，则必须满足如下条件：【订单总金额】=【可打折金额】 【不可打折金额】。
如果订单金额全部参与优惠计算，则【可打折金额】和【不可打折金额】都无需传入。
参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。
如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】，则必须满足如下条件：【订单总金额】=【可打折金额】 【不可打折金额】。
如果订单金额全部参与优惠计算，则【可打折金额】和【不可打折金额】都无需传入。
【示例值】80.00
undiscountable_amount可选price(9)
【描述】不可打折金额。
不参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。
如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】，则必须满足如下条件：【订单总金额】=【可打折金额】 【不可打折金额】。
如果订单金额全部参与优惠计算，则【可打折金额】和【不可打折金额】都无需传入。
不参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。
如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】，则必须满足如下条件：【订单总金额】=【可打折金额】 【不可打折金额】。
如果订单金额全部参与优惠计算，则【可打折金额】和【不可打折金额】都无需传入。
【示例值】8.88
store_id可选string(32)
【描述】商户门店编号。
指商户创建门店时输入的门店编号。
指商户创建门店时输入的门店编号。
【示例值】nj_001
alipay_store_id可选string(32)
【描述】支付宝店铺编号。
指商户创建门店后支付宝生成的门店id。
指商户创建门店后支付宝生成的门店id。
【示例值】2016041400077000000003314986
disable_pay_channels可选string(128)
【描述】禁用渠道,用户不可用指定渠道支付，多个渠道以逗号分割
注，与enable_pay_channels互斥
注，与enable_pay_channels互斥
【示例值】pcredit,moneyfund,debitcardexpress
enable_pay_channels可选string(128)
【描述】指定支付渠道。
用户只能使用指定的渠道进行支付，多个渠道以逗号分割。
与disable_pay_channels互斥，支持传入的值：。
注：如果传入了指定支付渠道，则用户只能用指定内的渠道支付，包括营销渠道也要指定才能使用。该参数可能导致用户支付受限，慎用。
用户只能使用指定的渠道进行支付，多个渠道以逗号分割。
与disable_pay_channels互斥，支持传入的值：。
注：如果传入了指定支付渠道，则用户只能用指定内的渠道支付，包括营销渠道也要指定才能使用。该参数可能导致用户支付受限，慎用。
【示例值】pcredit,moneyfund,debitcardexpress
query_options可选string[](1024)
【描述】返回参数选项。 商户通过传递该参数来定制需要额外返回的信息字段，数组格式。包括但不限于：["enterprise_pay_info","hyb_amount"]
【枚举值】
因公付金额信息: enterprise_pay_info
惠营宝回票金额信息: hyb_amount
【示例值】["enterprise_pay_info","hyb_amount"]
agreement_sign_params可选signparams
【描述】签约参数。如果希望使用支付并签约，需要在这里传入签约信息。
product_code｜收单产品码必选string(64)
【描述】商家和支付宝签约的产品码。 商家扣款产品传入固定值：general_withholding
【示例值】general_withholding
personal_product_code必选string(64)
【描述】个人签约产品码，商户和支付宝签约时确定。
【示例值】cycle_pay_auth_p
sign_scene必选string(64)
【描述】协议签约场景，商户和支付宝签约时确定，商户可咨询凯发app官方网站的技术支持。
【示例值】industry|digital_media
access_params必选accessparams
【描述】请按当前接入的方式进行填充，且输入值必须为文档中的参数取值范围。
channel必选string(20)
【描述】目前支持以下值：
1. alipayapp （钱包h5页面签约）
2. qrcode(扫码签约)
3. qrcodeorsms(扫码签约或者短信签约)
1. alipayapp （钱包h5页面签约）
2. qrcode(扫码签约)
3. qrcodeorsms(扫码签约或者短信签约)
【示例值】alipayapp
external_agreement_no可选string(32)
【描述】商户签约号，代扣协议中标示用户的唯一签约号（确保在商户系统中唯一）。 格式规则：支持大写小写字母和数字，最长32位。 商户系统按需传入，如果同一用户在同一产品码、同一签约场景下，签订了多份代扣协议，那么需要指定并传入该值。
【示例值】test20190701
external_logon_id可选string(100)
【描述】用户在商户网站的登录账号，用于在签约页面展示，如果为空，则不展示
【示例值】13888888888
sub_merchant可选signmerchantparams
【描述】此参数用于传递子商户信息，无特殊需求时不用关注。目前商户代扣、海外代扣、淘旅行信用住产品支持传入该参数（在销售方案中“是否允许自定义子商户信息”需要选是）。
sub_merchant_id可选string(20)
【描述】子商户的商户id
【示例值】2088123412341234
sub_merchant_name可选string(50)
【描述】子商户的商户名称
【示例值】滴滴出行
sub_merchant_service_name可选string(50)
【描述】子商户的服务名称
【示例值】滴滴出行免密支付
sub_merchant_service_description可选string(150)
【描述】子商户的服务描述
【示例值】免密付车费，单次最高500
period_rule_params可选periodruleparams
【描述】周期管控规则参数period_rule_params，在签约周期扣款产品（如cycle_pay_auth_p）时必传，在签约其他产品时无需传入。 周期扣款产品，会按照这里传入的参数提示用户，并对发起扣款的时间、金额、次数等做相应限制。
period_type必选string(10000)
【描述】周期类型period_type是周期扣款产品必填，枚举值为day和month。
day即扣款周期按天计，month代表扣款周期按自然月。
与另一参数period组合使用确定扣款周期，例如period_type为day，period=30，则扣款周期为30天；period_type为month，period=3，则扣款周期为3个自然月。
自然月是指，不论这个月有多少天，周期都计算到月份中的同一日期。例如1月3日到2月3日为一个自然月，1月3日到4月3日为三个自然月。注意周期类型使用month的时候，计划扣款时间execute_time不允许传28日之后的日期（可以传28日），以此避免有些月份可能不存在对应日期的情况。
day即扣款周期按天计，month代表扣款周期按自然月。
与另一参数period组合使用确定扣款周期，例如period_type为day，period=30，则扣款周期为30天；period_type为month，period=3，则扣款周期为3个自然月。
自然月是指，不论这个月有多少天，周期都计算到月份中的同一日期。例如1月3日到2月3日为一个自然月，1月3日到4月3日为三个自然月。注意周期类型使用month的时候，计划扣款时间execute_time不允许传28日之后的日期（可以传28日），以此避免有些月份可能不存在对应日期的情况。
【枚举值】
自然日: day
自然月: month
【示例值】day
period必选number(32)
【描述】周期数period是周期扣款产品必填。与另一参数period_type组合使用确定扣款周期，例如period_type为day，period=90，则扣款周期为90天。
【示例值】3
execute_time必选string(10000)
【描述】首次执行时间execute_time是周期扣款产品必填，即商户发起首次扣款的时间。精确到日，格式为yyyy-mm-dd
结合其他必填的扣款周期参数，会确定商户以后的扣款计划。发起扣款的时间需符合这里的扣款计划。
结合其他必填的扣款周期参数，会确定商户以后的扣款计划。发起扣款的时间需符合这里的扣款计划。
【示例值】2019-01-23
single_amount必选price(32)
【描述】单次扣款最大金额single_amount是周期扣款产品必填，即每次发起扣款时限制的最大金额，单位为元。商户每次发起扣款都不允许大于此金额。
【示例值】10.99
total_amount可选price(16)
【描述】总金额限制，单位为元。如果传入此参数，商户多次扣款的累计金额不允许超过此金额。
【示例值】600
total_payments可选number(8)
【描述】总扣款次数。如果传入此参数，则商户成功扣款的次数不能超过此次数限制（扣款失败不计入）。
【示例值】12
sign_notify_url可选string(3000)
【描述】签约成功后商户用于接收异步通知的地址。如果不传入，签约与支付的异步通知都会发到外层notify_url参数传入的地址；如果外层也未传入，签约与支付的异步通知都会发到商户appid配置的网关地址。
【示例值】http://www.merchant.com/receivesignnotify
常见请求示例
接入交易组件场景
不接入交易组件场景
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.trade.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"out_trade_no":"20150320010101001",
"product_code":"jsapi_pay",
"op_app_id":"2014072300007148",
"total_amount":"88.88",
"extend_params":{
"trade_component_order_id":"2023060801502300000008810000005657"
},
"discountable_amount":"80.00",
"subject":"iphone6 16g",
"body":"iphone6 16g",
"buyer_id":"2088102146225135",
"buyer_open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"store_id":"nj_001"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
out_trade_no必选string(64)
【描述】商户订单号
【示例值】20150423001001
trade_no必选string(64)
【描述】支付宝交易号
【示例值】2015042321001004720200028594
响应示例
正常示例
异常示例
{
"alipay_trade_create_response": {
"code": "10000",
"msg": "success",
"out_trade_no": "20150423001001",
"trade_no": "2015042321001004720200028594"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| acq.access_forbidden | 无权限使用接口 | 未签约对应的产品合约； 1、请校验传入的product_code参数是否正确； 2、确认请求商户是否签约了 产品合约 |
| acq.beyond_per_receipt_single_restriction | 订单金额超过单笔限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| acq.biz_product_not_allowed | 公域订单场景下不支持使用该产品码 | 公域场交易需要切换使用jsapi支付产品。1、请确认签约jsapi支付产品；2、product_code改成jsapi_pay产品码 |
| acq.buyer_enable_status_forbid | 买家状态非法 | 用户联系支付宝小二，确认买家状态为什么非法 |
| acq.buyer_not_exist | 买家不存在 | 确认买家账号信息传递是否正确，如果正确可联系支付宝小二，确认买家账号是否已经注销 |
| acq.buyer_seller_equal | 买卖家不能相同 | 更换买家重新付款 |
| acq.context_inconsistent | 交易信息被篡改 | 更换商家订单号后，重新发起请求 |
| acq.customer_validate_error | 客户校验出错 | 请确认结算账号是否完成实名信息认证，如还有问题联系支付宝小二处理 |
| acq.default_settle_rule_not_exist | 默认结算条款不存在 | 请确认二级商户进件是已经设置了默认结算账户 |
| acq.error_buyer_certify_level_limit | 买家未通过人行认证 | 让用户联系支付宝小二并更换其它付款方式 |
| acq.error_seller_certify_level_limit | 卖家未通过人行认证 | 根据国家相关法规要求，收款账户资金变动超过一定数额，需补充实名认证资料后，才能进行收付款 |
| acq.exist_forbidden_word | 订单信息中包含违禁词 | 修改订单信息后，重新发起请求 |
| acq.illegal_argument | 参数错误 | 请确认请求传参是否正确 |
| acq.invalid_parameter | 参数无效 | 检查请求参数，修改后重新发起请求 |
| acq.invalid_receive_account | 收款账户不支持 | 确认seller_id信息是否传递正确，如正确请确认seller_id是否在签约中设置了收款权限 |
| acq.invalid_store_id | 商户门店编号无效 | 检查传入的门店编号是否有效 |
| acq.merchant_perm_receipt_day_limit | 超过单日累计收款额度 | 联系支付宝小二处理（联系电话：4007585858） |
| acq.merchant_perm_receipt_single_limit | 超过单笔收款限额 | 联系支付宝小二处理（联系电话：4007585858） |
| acq.merchant_perm_receipt_suspend_limit | 商户暂停收款 | 联系支付宝小二处理（联系电话：4007585858） |
| acq.merchant_status_not_normal | 商户状态异常 | 因商户超过三个月未产生交易，需重新激活后可正常收单。1、进入支付宝商家中心，重新确认激活商家信息 或2、联系支付宝小二处理（联系电话：4007585858） |
| acq.now_time_after_expire_time_error | 当前时间已超过允许支付的时间 | 请检查传入的支付超时时间是否正确 |
| acq.open_id_not_tiny_app | 请求的应用id非小程序应用类型 | 1、接口需要传入op_app_id，且该应用id是小程序应用类型；
2、商户需要先在商家平台-凯发k8官方网娱乐官方的产品中心- 关联该小程序appid；
3、如果未传入op_app_id，则默认发起请求的appid即唤起收银台所在的小程序应用id，该appid需要是小程序应用类型。 |
| acq.partner_error | 应用app_id填写错误 | 联系支付宝小二，确认app_id的状态 |
| acq.payer_unmatched | 付款人不匹配 | 建议用户更换为指定的支付宝账号进行支付 |
| acq.platform_business_acquire_mode_must_merchant_id | 二级商户编码为空 | 请检查是否正确传入二级商户编号 |
| acq.product_not_support_in_tiny_app | 小程序内不支持使用该产品码交易 | 1、请确认签约jsapi支付产品；2、product_code改成jsapi_pay产品码 |
| acq.risk_merchant_ip_not_exist | 当前交易未传入ip信息，创单失败，请传入ip后再发起支付 | 检查请求参数是否已经传入用户ip信息 |
| acq.secondary_merchant_alipay_account_invalid | 二级商户账户异常 | 确认传入的二级商户结算账户是否与进件时设置的结算账户一致，如果一致可联系支付宝小二确认是否商户的账号信息有变更 |
| acq.secondary_merchant_card_alias_no_invalid | 二级商户银行卡编号错误 | 请确认是否正确传入二级商户的银行卡信息，以及银行卡信息是否与商户进件是设置的卡信息一致 |
| acq.secondary_merchant_id_blank | 二级商户编号错误 | 请检查是否正确传入二级商户编号 |
| acq.secondary_merchant_id_invalid | 二级商户不存在 | 请检查传入的二级商户编号是否正确 |
| acq.secondary_merchant_isv_punish_indirect | 商户状态异常 | 请联系对应的服务商咨询 |
| acq.secondary_merchant_not_match | 二级商户信息不匹配 | 1、请检查发起支付请求的二级商户账号是否正确或是否进件；
2、如果使用的是直付通平台商模式，请确认是否签约了直付通收单模式； |
| acq.secondary_merchant_status_error | 商户状态异常 | 请联系对应的服务商咨询 |
| acq.seller_been_blocked | 商家账号被冻结 | 联系支付宝小二，解冻账号 |
| acq.seller_not_exist | 卖家不存在 | 确认卖家信息是否传递正确 |
| acq.store_info_invalid | 门店信息错误 | 请校验传入的结算门店信息是否正确 |
| acq.sub_goods_size_max_count | 子商品明细超长 | 请检查子商品明细是否超过了150条 |
| acq.system_error | 接口返回错误 | 请立即调用查询订单api，查询当前订单的状态，并根据订单状态决定下一步的操作 |
| acq.total_fee_exceed | 订单总金额超过限额 | 修改订单金额再发起请求 |
| acq.trade_buyer_not_match | 交易买家不匹配 | 更换商家订单号后，重新发起请求 |
| acq.trade_has_close | 交易已经关闭 | 更换商家订单号后，重新发起请求 |
| acq.trade_has_success | 交易已被支付 | 确认该笔交易信息是否为当前买家的，如果是则认为交易付款成功，如果不是则更换商家订单号后，重新发起请求 |
| acq.unbound_application | 未绑定小程序appid | 1、确认op_app_id为唤起收银台支付的小程序appid；2、商户需要先在商家平台-凯发k8官方网娱乐官方的产品中心- 关联该小程序appid，具体可参考:商户号关联小程序appid，多商家收款参考 小程序支付如何实现多商家收款。 |
| acq.user_logonid_dup | 用户账号重复 | 用户手机账户名与他人重复，无法进行收付款。为了保障资金安全，建议您通知对方修改账户名，并与对方核对后更新对方账户名 |
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| tradestatus.trade_closed | 交易关闭 | 0 |
| tradestatus.trade_finished | 交易完结 | 0 |
| tradestatus.trade_success | 支付成功 | 1 |
| tradestatus.wait_buyer_pay | 交易创建 | 0 |
触发通知示例
https://www.merchant.com/receive_notify.htm?notify_type=trade_status_sync¬ify_id=91722adff935e8cfa58b3aabf4dead6ibe¬ify_time=2017-02-16 21:46:15&sign_type=rsa2&sign=wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey=&out_biz_no=null&app_id=null&trade_no=null&voucher_detail_list=null&buyer_id=null&point_amount=null&buyer_pay_amount=null&invoice_amount=null&receipt_amount=null&fund_bill_list=null&gmt_close=null&gmt_refund=null&buyer_open_id=074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5&seller_email=null&merchant_app_id=2088102146225135&out_trade_no=null&buyer_logon_id=null&seller_id=null&trade_status=null&total_amount=null&refund_fee=null&subject=null&body=null&gmt_create=null&gmt_payment=null&discount_goods_detail="[{\"goodsid\":\"standard1026181538\",\"goodsname\":\"雪碧\",\"discountamount\":\"10.00\"}]"&refund_preset_paytool_list=[{"amount":"1.00","assert_type_code":"hema"}]&charge_amount=8.88&charge_flags=bluesea_1&settlement_id=2018101610032004620239146945¤t_seller_received_amount=88.88&seller_received_total_amount=88.88&total_from_seller_fee=88.88&ff_current_period=1¬ify_action_type=paybyaccountaction/closetradeaction/reverseaction/finishfpaction/confirmdisburseaction/financingreceiptaction&passback_params=merchantbiztype=3c&merchantbizno=2016010101111&hb_fq_pay_info={"user_install_num":"3"}&receipt_currency_type=dc&enterprise_pay_info={"invoice_amount":"28.00"}&hyb_amount=10.24&bkagent_resp_info={"bindtrxid":"xxxxxx xxxxxxxx","bindclrissrid":"01","bindpyeracctbkid":"xxxxxxxxxxxxxx","bkpyerusercode":"xxxxxxxxxxxxxx","estterlocation":" xxxxxxxxxxxxxx"}&charge_info_list=[{"charge_fee":"0.01","original_charge_fee":"0.02","switch_fee_rate":"0.03","is_rating_on_trade_receiver":"y","is_rating_on_switch":"y"}]&biz_settle_mode=period&period_scene=yimei&refund_voucher_detail_list="[{\"amount\": \"2.00\",\"id\": \"202404170007300200950064oz8b\",\"memo\": \"{\\\"certificateserialnos\\\":\\\"{\\\\\\\"2024022700445016365674959279\\\\\\\":{\\\\\\\"saleprice\\\\\\\":\\\\\\\"50\\\\\\\"},\\\\\\\"2024022700445016365674959278\\\\\\\":{\\\\\\\"saleprice\\\\\\\":\\\\\\\"60\\\\\\\"}}\\\"}\",\"merchant_contribute\": \"2.00\",\"name\": \"自提卡a: sku1 两次 减至0 封顶4\",\"other_contribute\": \"0.00\",\"template_id\": \"20230913000730013057000d7w7v\",\"type\": \"alipay_common_item_voucher\"}]"