商家扣款
用户与商户签署商家扣款协议后，商户可通过本接口做后续免密代扣操作
公共请求参数
业务请求参数
out_trade_no必选string(64)
【描述】商户订单号。
由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。
由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。
【示例值】20150320010101001
total_amount必选price(11)
【描述】订单总金额。
单位为元，精确到小数点后两位，取值范围：[0.01,100000000] 。
单位为元，精确到小数点后两位，取值范围：[0.01,100000000] 。
【示例值】88.88
subject必选string(256)
【描述】订单标题。
注意：不可使用特殊字符，如 /，=，& 等。
注意：不可使用特殊字符，如 /，=，& 等。
【示例值】iphone6 16g
product_code必选string(64)
【描述】产品码。
商家和支付宝签约的产品码。
注意：本参数必填，且固定值为general_withholding。
商家和支付宝签约的产品码。
注意：本参数必填，且固定值为general_withholding。
【示例值】general_withholding
agreement_params必选agreementparams
【描述】代扣信息。
代扣业务需要传入的协议相关信息，使用本参数传入协议号后scene和auth_code不需要再传值。
代扣业务需要传入的协议相关信息，使用本参数传入协议号后scene和auth_code不需要再传值。
agreement_no可选string(64)
【描述】支付宝系统中用以唯一标识用户签约记录的编号（用户签约成功后的协议号 ）
【示例值】20170322450983769228
auth_confirm_no可选string(10)
【描述】鉴权确认码，在需要做支付鉴权校验时，该参数不能为空
【示例值】423979
apply_token可选string(64)
【描述】鉴权申请token，其格式和内容，由支付宝定义。在需要做支付鉴权校验时，该参数不能为空。
【示例值】mdeduct0068292ca377d1d44b65fa24ec9cd89132f
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
goods_detail可选goodsdetail[]
【描述】订单包含的商品列表信息，json格式。
goods_id必选string(32)
【描述】商品的编号
【示例值】apple-01
goods_name必选string(256)
【描述】商品名称
【示例值】ipad
quantity必选number(32)
【描述】商品数量
【示例值】1
price必选price(9)
【描述】商品单价，单位为元
【示例值】2000
goods_category可选string(24)
【描述】商品类目
【示例值】34543238
categories_tree可选string(128)
【描述】商品类目树，从商品类目根节点到叶子节点的类目id组成，类目id值使用|分割
【示例值】124868003|126232002|126252004
show_url可选string(400)
【描述】商品的展示地址
【示例值】http://www.alipay.com/xxx.jpg
extend_params可选extendparams
【描述】业务扩展参数，二级参数字段会动态新增
sys_service_provider_id可选string(64)
【描述】系统商编号
该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的pid
该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的pid
【示例值】2088511833207846
card_type可选string(64)
【描述】卡类型
【枚举值】
s0jp0000: s0jp0000
【示例值】s0jp0000
promo_params可选promoparam
【描述】优惠明细参数，通过此属性补充营销参数
actual_order_time可选string(32)
【描述】存在延迟扣款这一类的场景，用这个时间表明用户发生交易的时间，比如说，在公交地铁场景，用户刷码出站的时间，和商户上送交易的时间是不一样的。
【示例值】2018-09-25 22:47:33
pay_params可选payparams
【描述】支付相关参数
async_type可选string(64)
【描述】普通异步支付, 传入该参数时，如果满足受理条件，会先同步受理支付，然后在异步调度推进支付
normal_async: 普通异步，受理成功之后，会在交易关单之前通过一定的策略重试
near_real_time_async: 准实时异步，受理成功之后，会准实时发起1次调度
normal_async: 普通异步，受理成功之后，会在交易关单之前通过一定的策略重试
near_real_time_async: 准实时异步，受理成功之后，会准实时发起1次调度
【示例值】normal_async
query_options可选string[](1024)
【描述】返回参数选项。
商户通过传递该参数来定制同步需要额外返回的信息字段，数组格式。包括但不限于：["fund_bill_list","voucher_detail_list","enterprise_pay_info","discount_goods_detail","discount_amount","mdiscount_amount"]
商户通过传递该参数来定制同步需要额外返回的信息字段，数组格式。包括但不限于：["fund_bill_list","voucher_detail_list","enterprise_pay_info","discount_goods_detail","discount_amount","mdiscount_amount"]
【枚举值】
资金明细信息: fund_bill_list
优惠券信息: voucher_detail_list
因公付金额信息: enterprise_pay_info
【示例值】voucher_detail_list
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.trade.pay&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",
"total_amount":"88.88",
"subject":"iphone6 16g",
"product_code":"general_withholding",
"agreement_params":{
"agreement_no":"20170322450983769228",
"apply_token":"mdeduct0068292ca377d1d44b65fa24ec9cd89132f",
"auth_confirm_no":"423979"
},
"seller_id":"2088102146225135",
"goods_detail":[
{
"goods_name":"ipad",
"quantity":1,
"price":"2000",
"goods_id":"apple-01",
"goods_category":"34543238",
"categories_tree":"124868003|126232002|126252004",
"show_url":"http://www.alipay.com/xxx.jpg"
}
],
"extend_params":{
"sys_service_provider_id":"2088511833207846",
"card_type":"s0jp0000"
},
"promo_params":{
"actual_order_time":"2018-09-25 22:47:33"
},
"pay_params":{
"async_type":"normal_async"
},
"query_options":[
"voucher_detail_list"
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
trade_no必选string(64)
【描述】支付宝交易号
【注意事项】在未生成真实交易时，不返回，需要商户调用交易查询接口或接入支付通知，获取最终的交易号
【示例值】2013112011001004330000121536
out_trade_no必选string(64)
【描述】商户订单号
【示例值】6823789339978248
buyer_logon_id必选string(100)
【描述】买家支付宝账号
【注意事项】在未生成真实交易时，不返回，需要商户调用交易查询接口或接入支付通知，获取最终的用户信息
【示例值】159****5620
total_amount必选price(11)
【描述】交易金额
【示例值】120.88
receipt_amount必选string(11)
【描述】实收金额
【示例值】88.88
gmt_payment必选date(32)
【描述】交易支付时间
【示例值】2014-11-27 15:45:57
fund_bill_list必选tradefundbill[]
【描述】交易支付使用的资金渠道。
只有在签约中指定需要返回资金明细，或者入参的query_options中指定时才返回该字段信息。
只有在签约中指定需要返回资金明细，或者入参的query_options中指定时才返回该字段信息。
fund_channel必选string(32)
【描述】交易使用的资金渠道，详见 支付渠道列表
【示例值】alipayaccount
amount必选price(32)
【描述】该支付工具类型所使用的金额
【示例值】10
real_amount可选price(11)
【描述】渠道实际付款金额
【示例值】11.21
以下参数 二选一
buyer_user_idstring(28)
【描述】买家在支付宝的用户id
新商户建议使用buyer_open_id替代该字段。对于新商户，buyer_user_id字段未来计划逐步回收，存量商户可继续使用。如使用buyer_open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【注意事项】在未生成真实交易时，不返回，需要商户调用交易查询接口或接入支付通知，获取最终的用户信息
【示例值】2088101117955611
buyer_open_idstring(128)
【描述】买家支付宝用户唯一标识 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
buyer_pay_amount特殊可选price(11)
【描述】买家付款的金额
【示例值】8.88
point_amount特殊可选price(11)
【描述】使用集分宝付款的金额
【示例值】8.12
invoice_amount特殊可选price(11)
【描述】交易中可给用户开具发票的金额
【示例值】12.50
store_name特殊可选string(512)
【描述】发生支付交易的商户门店名称
【示例值】证大五道口店
discount_goods_detail特殊可选string(5120)
【描述】本次交易支付所使用的单品券优惠的商品优惠信息。
只有在query_options中指定时才返回该字段信息。
只有在query_options中指定时才返回该字段信息。
【示例值】[{"goods_id":"standard1026181538","goods_name":"雪碧","discount_amount":"100.00","voucher_id":"2015102600073002039000002d5o"}]
async_payment_mode特殊可选string(20)
【描述】异步支付模式，目前有五种值：
async_delay_pay(异步延时付款);
async_realtime_pay(异步准实时付款);
sync_direct_pay(同步直接扣款);
normal_async_pay(纯异步付款);
quota_occupyied_async_pay(异步支付并且预占了先享后付额度);
async_delay_pay(异步延时付款);
async_realtime_pay(异步准实时付款);
sync_direct_pay(同步直接扣款);
normal_async_pay(纯异步付款);
quota_occupyied_async_pay(异步支付并且预占了先享后付额度);
【枚举值】
异步延时付款: async_delay_pay
异步准实时付款: async_realtime_pay
同步直接扣款: sync_direct_pay
【示例值】sync_direct_pay
voucher_detail_list特殊可选voucherdetail[]
【描述】本交易支付时使用的所有优惠券信息。
只有在query_options中指定时才返回该字段信息。
只有在query_options中指定时才返回该字段信息。
id必选string(32)
【描述】券id
【示例值】2015102600073002039000002d5o
name必选string(64)
【描述】券名称
【示例值】xx超市5折优惠
type必选string(32)
【描述】券类型
【枚举值】
全场代金券: alipay_fix_voucher
折扣券: alipay_discount_voucher
单品优惠券: alipay_item_voucher
【注意事项】不排除将来新增其他类型的可能，商家接入时注意兼容性避免硬编码
【示例值】alipay_fix_voucher
amount必选price(8)
【描述】优惠券面额，它应该会等于商家出资加上其他出资方出资
【示例值】10.00
merchant_contribute可选price(8)
【描述】商家出资（特指发起交易的商家出资金额）
【示例值】9.00
other_contribute可选price(8)
【描述】其他出资方出资金额，可能是支付宝，可能是品牌商，或者其他方，也可能是他们的一起出资
【示例值】1.00
memo可选string(256)
【描述】优惠券备注信息
【示例值】学生专用优惠
template_id可选string(64)
【描述】券模板id
【示例值】20171030000730015359000emzp0
purchase_buyer_contribute可选price(8)
【描述】如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时用户实际付款的金额
【示例值】2.01
purchase_merchant_contribute可选price(8)
【描述】如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时商户优惠的金额
【示例值】1.03
purchase_ant_contribute可选price(8)
【描述】如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时平台优惠的金额
【示例值】0.82
advance_amount特殊可选string(11)
【描述】先享后付2.0垫资金额,不返回表示没有走垫资，非空表示垫资支付的金额
【示例值】88.8
charge_flags特殊可选string(64)
【描述】费率活动标识。
当交易享受特殊行业或活动费率时，返回该场景的标识。具体场景如下：
trade_special_00：订单优惠费率；
industry_special_on_00：线上行业特殊费率0；
industry_special_on_01：线上行业特殊费率1；
industry_special_00：线下行业特殊费率0；
industry_special_01：线下行业特殊费率1；
bluesea_1：蓝海活动优惠费率标签；
注：只在机构间联模式下返回，其它场景下不返回该字段；
当交易享受特殊行业或活动费率时，返回该场景的标识。具体场景如下：
trade_special_00：订单优惠费率；
industry_special_on_00：线上行业特殊费率0；
industry_special_on_01：线上行业特殊费率1；
industry_special_00：线下行业特殊费率0；
industry_special_01：线下行业特殊费率1；
bluesea_1：蓝海活动优惠费率标签；
注：只在机构间联模式下返回，其它场景下不返回该字段；
【示例值】industry_special_00
mdiscount_amount特殊可选string(11)
【描述】商家优惠金额
【示例值】88.88
discount_amount特殊可选string(11)
【描述】平台优惠金额
【示例值】88.88
响应示例
正常示例
异常示例
{
"alipay_trade_pay_response": {
"code": "10000",
"msg": "success",
"trade_no": "2013112011001004330000121536",
"out_trade_no": "6823789339978248",
"buyer_logon_id": "159****5620",
"total_amount": "120.88",
"receipt_amount": "88.88",
"buyer_pay_amount": "8.88",
"point_amount": "8.12",
"invoice_amount": "12.50",
"gmt_payment": "2014-11-27 15:45:57",
"fund_bill_list": [
{
"fund_channel": "alipayaccount",
"amount": "10",
"real_amount": "11.21"
}
],
"store_name": "证大五道口店",
"discount_goods_detail": "[{\"goods_id\":\"standard1026181538\",\"goods_name\":\"雪碧\",\"discount_amount\":\"100.00\",\"voucher_id\":\"2015102600073002039000002d5o\"}]",
"buyer_open_id": "074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"buyer_user_id": "2088101117955611",
"async_payment_mode": "sync_direct_pay",
"voucher_detail_list": [
{
"id": "2015102600073002039000002d5o",
"name": "xx超市5折优惠",
"type": "alipay_fix_voucher",
"amount": "10.00",
"merchant_contribute": "9.00",
"other_contribute": "1.00",
"memo": "学生专用优惠",
"template_id": "20171030000730015359000emzp0",
"purchase_buyer_contribute": "2.01",
"purchase_merchant_contribute": "1.03",
"purchase_ant_contribute": "0.82"
}
],
"advance_amount": "88.8",
"charge_flags": "industry_special_00",
"mdiscount_amount": "88.88",
"discount_amount": "88.88"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| acq.access_forbidden | 无权限使用接口 | 未签约对应的产品合约；
1、请校验传入的product_code参数是否正确；
2、确认请求商户是否签约了对应的产品合约； |
| acq.agreement_error | 协议信息异常 | 请检查传入的协议信息是否正确 |
| acq.agreement_invalid | 用户协议失效 | 代扣业务传入的协议号对应的用户协议已经失效，需要用户重新签约 |
| acq.agreement_not_exist | 用户协议不存在或已解约 | 协议号传递错误或用户已经解约，请重新引导用户进行签约，使用新生成的协议号发起代扣请求。 |
| acq.agreement_status_not_normal | 用户协议状态非normal | 代扣业务用户协议状态非正常状态，需要用户解约后重新签约 |
| acq.amount_or_currency_error | 订单金额或币种信息错误 | 检查订单传入的金额信息是否有误，或者是不是当前币种未签约 |
| acq.auth_amount_not_enough | 授权金额不足 | 订单金额大于授权剩余金额，请检查授权单剩余金额信息 |
| acq.auth_no_error | 预授权号错误或状态不对 | 1、确认预授权单号（auth_no）是否正确；2、确认预授权订单的参与方与支付单的参与方是否一致；3、确认预授权订单的状态是否为已授权状态； |
| acq.auth_order_has_closed | 预授权订单已关闭 | 预授权订单已撤销、解冻或未支付超时关闭，授权单状态已关闭，不能再发起转交易扣款 |
| acq.auth_order_has_finished | 预授权订单已经完结 | 预授权订单已经转交易支付成功，授权单状态已完结，不能再发起转交易扣款 |
| acq.auth_order_not_paid | 预授权订单未支付 | 先引导用户完成预授权订单的支付，再重新请求转交易支付接口 |
| acq.auth_token_is_not_exist | 支付授权码为空 | 请检查请求参数是否正确，支付授权码、协议信息或预授权号是否正确传入 |
| acq.beyond_pay_restriction | 商户收款额度超限 | 联系支付宝小二提高限额（联系电话：4007585858） |
| acq.beyond_per_receipt_day_restriction | 订单金额超过当日累计限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| acq.beyond_per_receipt_restriction | 商户收款金额超过月限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| acq.beyond_per_receipt_single_restriction | 订单金额超过单笔限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| acq.buyer_balance_not_enough | 买家余额不足 | 买家绑定新的银行卡或者支付宝余额有钱后再发起支付 |
| acq.buyer_bankcard_balance_not_enough | 用户银行卡余额不足 | 建议买家更换支付宝进行支付或者更换其它付款方式 |
| acq.buyer_enable_status_forbid | 买家状态非法 | 用户联系支付宝小二（联系支付宝文档右边的客服头像或到支持中心咨询），确认买家状态为什么非法 |
| acq.buyer_not_exist | 买家不存在 | 联系支付宝小二，确认买家是否已经注销账号 |
| acq.buyer_not_mainland_cert | 买家证件类型非大陆身份证 | 该服务仅支持中国大陆身份证实名制用户,建议买家完善实名信息或者更换其它付款方式 |
| acq.buyer_payment_amount_day_limit_error | 买家付款日限额超限 | 更换买家进行支付 |
| acq.buyer_payment_amount_month_limit_error | 买家付款月额度超限 | 让买家更换账号后，重新付款或者更换其它付款方式 |
| acq.buyer_seller_equal | 买卖家不能相同 | 交易的买家和卖家不能相同，请更换买家后重新发起支付请求。 |
| acq.buyer_unsupport_advance | 先享后付2.0准入失败,买家不满足垫资条件 | 先享后付2.0准入失败,买家不满足垫资条件 |
| acq.card_type_error | 卡类型错误 | 检查传入的卡类型 |
| acq.card_user_not_match | 脱机记录用户信息不匹配 | 请检查传入的进展出站记录是否正确 |
| acq.cert_expired | 凭证过期 | 凭证已经过期 |
| acq.context_inconsistent | 订单信息不一致 | 商户订单号已经创建交易成功，且本次请求的交易关键信息（如订单金额、订单标题等）与已存交易的信息不一致，请检查传入的订单参数是否正确。
如原有交易未支付成功，请更换订单号重新发起支付请求。 |
| acq.currency_not_support | 订单币种不支持 | 请检查是否签约对应的币种 |
| acq.cycle_pay_date_not_match | 扣款日期不在签约时的允许范围之内 | 对于商家扣款产品，签约时会约定扣款的周期。如果发起扣款的日期不符合约定的周期，则不允许扣款。请重新检查扣款日期，在符合约定的日期发起扣款。 |
| acq.cycle_pay_single_fee_exceed | 商家扣款的单笔金额超过签约时限制 | 对于商家扣款产品，签约时会约定单笔扣款的最大金额。如果发起扣款的金额大于约定上限，则不允许扣款。请在允许的金额范围内扣款。 |
| acq.cycle_pay_total_fee_exceed | 商家扣款的累计金额超过签约时限制 | 对于商家扣款产品，签约时可以约定多次扣款的累计金额限制。如果发起扣款的累计金额大于约定上限，则不允许扣款。请在允许的金额范围内扣款。 |
| acq.cycle_pay_total_times_exceed | 商家扣款的总次数超过签约时限制 | 对于商家扣款产品，签约时可以约定多次扣款的总次数限制。如果发起扣款的总次数大于约定上限，则不允许扣款。请在允许的次数范围内扣款 |
| acq.error_balance_payment_disable | 余额支付功能关闭 | 用户打开余额支付开关后，再重新进行支付 |
| acq.error_buyer_certify_level_limit | 买家未通过人行认证 | 让用户联系支付宝小二并更换其它付款方式（联系电话：4007585858） |
| acq.exist_forbidden_word | 订单信息中包含违禁词 | 请检查订单标题和订单描述是否包含敏感词，修改订单信息后，重新发起请求 |
| acq.invalid_parameter | 参数无效 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起请求 |
| acq.invalid_receive_account | 收款账户不支持 | seller_id不在请求商户设置的收款账户限制集中，请确认是否需要收款到指定的支付宝账户，如需要联系支付宝小二进行配置处理。
如果不需要，则seller_id不需要传递，资金默认收款到签约商户账户中。 |
| acq.invalid_store_id | 商户门店编号无效 | 检查传入的门店编号是否有效 |
| acq.merchant_agreement_invalid | 商户协议已失效 | 商户与支付宝合同已失效，需要重新签约 |
| acq.merchant_agreement_not_exist | 商户协议不存在 | 确认商户与支付宝是否已签约 |
| 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.merchant_unsupport_advance | 先享后付2.0准入失败,商户不支持垫资支付产品 | 先享后付2.0准入失败,商户不支持垫资支付产品 |
| acq.mobile_payment_switch_off | 用户的无线支付开关关闭 | 用户在pc上打开无线支付开关后，再重新发起支付 |
| acq.not_certified_user | 买家非实名认证用户 | 建议买家完善实名信息后再重试或者更换其它付款方式 |
| acq.not_support_payment_inst | 不支持的钱包版本 | 业务不支持使用该客户端支付，建议买家更换客户端进行支付或者更换其它付款方式 |
| acq.now_time_after_expire_time_error | 当前时间已超过允许支付的时间 | 请检查传入的支付超时时间是否正确 |
| acq.no_payment_instruments_available | 没有可用的支付工具 | 更换其它付款方式 |
| acq.order_unsupport_advance | 订单不支持先享后付垫资 | 订单不支持先享后付垫资 |
| acq.partner_error | 应用app_id填写错误 | 联系支付宝小二（联系支付宝文档右边的客服头像或到支持中心咨询），确认app_id的状态 |
| acq.payer_unmatched | 付款人不匹配 | 建议用户更换为指定的支付宝账号进行支付 |
| acq.payment_auth_code_invalid | 付款码无效 | 1、请确认auth_code参数传递正确；
2、请用户刷新付款码后，重新扫码发起请求； |
| acq.payment_fail | 支付失败 | 用户刷新条码后，重新发起请求，如果重试一次后仍未成功，更换其它方式付款 |
| acq.payment_request_has_risk | 支付有风险 | 更换其它付款方式 |
| acq.platform_business_acquire_mode_must_merchant_id | 二级商户编码为空 | 二级商户编号(sub_merchant.merchant_id)不能为空。
直付通模式下，二级商户信息为必填项，如果不使用直付通模式接入，请联系支付宝小二改签。 |
| acq.pre_auth_prod_code_inconsistent | 预授权产品码不一致 | 请检查预授权订单和转交易订单传入的产品码是否一致 |
| acq.product_amount_limit_error | 产品额度超限 | 联系支付宝小二提高限额（联系电话：4007585858） |
| acq.pull_mobile_cashier_fail | 唤起移动收银台失败 | 用户刷新条码后，重新扫码发起请求 |
| acq.request_amount_exceed | 请求金额超限 | 请检查传入的订单金额是否正确，预授权订单场景下请检查订单金额是否大于冻结金额 |
| acq.restricted_merchant_industry | 行业信息交易受限 | 订单金额超过所属行业支持的最大金额 |
| acq.risk_merchant_ip_not_exist | 当前交易未传入ip信息，创单失败，请传入ip后再发起支付 | 检查请求参数是否已经传入用户ip信息 |
| acq.royalty_account_not_exist | 分账收款方账号不存在 | 请确认分账收款方账号是否正确 |
| acq.secondary_merchant_alipay_account_invalid | 二级商户账户异常 | 确认传入的二级商户结算账户是否与进件时设置的结算账户一致，如果一致可联系支付宝小二确认是否商户的账号信息有变更 |
| acq.secondary_merchant_id_blank | 二级商户编号错误 | 请检查是否正确传入二级商户编号 |
| acq.secondary_merchant_id_invalid | 二级商户不存在 | 请检查传入的二级商户编号是否正确 |
| acq.secondary_merchant_isv_punish_indirect | 商户状态异常 | 请联系对应的服务商咨询 |
| acq.secondary_merchant_not_match | 二级商户信息不匹配 | 1、请检查发起支付请求的商户账号是否与请求创建二级商户接口所使用的商户账号一致；
2、如果接入的是直付通模式，请联系bd确认是否签约了直付通收单模式； |
| acq.secondary_merchant_status_error | 商户状态异常 | 请联系对应的服务商咨询 |
| acq.seller_been_blocked | 商家账号被冻结 | 联系支付宝小二，解冻账号（联系电话：4007585858） |
| acq.seller_not_exist | 卖家不存在 | 确认卖家信息是否传递正确 |
| acq.smile_pay_merchant_not_match | 请求支付和刷脸服务的商户身份不一致 | 请检查请求支付和刷脸服务使用的pid是否一致 |
| acq.sub_goods_size_max_count | 子商品明细超长 | 请检查子商品明细是否超过了150条 |
| acq.sub_merchant_create_fail | 二级商户创建失败 | 检查上送的二级商户信息是否有效 |
| acq.sub_merchant_type_invalid | 二级商户类型非法 | 检查上传的二级商户类型是否有效 |
| acq.system_error | 系统异常 | 系统异常错误下该笔交易可能成功也可能失败，请调用查询订单api，查询当前订单的状态，并根据订单状态决定下一步的操作，如果多次调用依然报此错误码，请联系支付宝客服 |
| acq.total_fee_exceed | 订单总金额超过限额 | 订单金额不能小于等于0，且不能大于100000000元，请修改订单金额后重新发起支付请求。 |
| acq.trade_buyer_not_match | 交易买家不匹配 | 请确认该订单号是否重复支付，如果是新订单，请更换商户订单号后重新提交支付。 |
| acq.trade_has_close | 交易已经关闭 | 商户订单号对应的交易已经关闭（超时未支付或者已全额退款），请更换商户订单号后重新发起支付请求。 |
| acq.trade_has_success | 交易已被支付 | 请确认该订单号是否重复支付，如果是新订单，请更换商户订单号后重新提交支付。 |
| acq.trade_settle_error | 交易结算异常 | 请检查传入的结算项信息是否正确，如果正确请联系支付宝小二 |
| acq.trade_status_error | 交易状态异常 | 请检查订单状态是否已经支付成功 |
| acq.un_support_trade_scene | 不支持该交易场景 | 改签合约，勾选支持对应的交易场景 |
| acq.user_face_payment_switch_off | 用户当面付付款开关关闭 | 让用户在手机上打开当面付付款开关 |
| acq.user_logonid_dup | 用户账号重复 | 用户手机账户名与他人重复，无法进行收付款。为了保障资金安全，建议您通知对方修改账户名，并与对方核对后更新对方账户名 |
| acq.zm_auth_amount_exceed | 先用后付场景下超过约定的免密支付金额 | 超过约定的免密支付金额，需要商户调用支付宝sdk唤起收银台，用户确认后付款 |
| acq.zm_auth_rule_limit | 调用芝麻做先用后付鉴权芝麻授权失败，命中先用后付场景限制规则 | 请更换调用 alipay.trade.app.pay服务，继续信用下单流程 |
| acq.zm_credit_auth_fail | 综合评估不通过 | 建议用户按时履约，提升芝麻信用等级 |
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| 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=&app_id=2088102146225135&merchant_app_id=2088102146225135&trade_no=2013112011001004330000121536&out_trade_no=6823789339978248&out_biz_no=85478536823789339978248&buyer_logon_id=159****5620&seller_id=2088102146225135&trans_currency=usd&seller_email=aa@mail.sa.com&settle_trans_rate=1&trans_pay_rate=6.5261&buyer_open_id=074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5&total_amount=120.88&buyer_id=2088202954065786&settle_currency=usd&settle_amount=88.88&pay_currency=cny&pay_amount=580.04&trade_status=trade_success&invoice_amount=88.88&receipt_amount=88.88&point_amount=88.88&refund_fee=10.23&buyer_pay_amount=88.88&subject=iphone6 16g&body=iphone6 16g&gmt_create=2014-11-27 15:45:57&gmt_payment=2014-11-27 15:45:57&gmt_refund=2014-11-27 14:15:57&gmt_close=2014-11-27 17:45:57&fund_bill_list="[{\"amount\":\"10000.00\",\"fundchannel\":\"alipayaccount\"}]"&voucher_detail_list="[{\"id\":\"20170307000730026487005x1m6v\",\"name\":\"全仓5折优惠券\"}]"&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&advance_amount=11.11¤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&discount_amount=88.88&mdiscount_amount=88.88&unfreeze_amount=18.18&auth_trade_pay_mode=credit_preauth_pay&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":"xxxxxxxxxxxxxx","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"}]&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\"}]"&tap_pay_info={"payment_medium_type":"tap_pay"}