# 当面付 --- ## 1. ACQ.BUYER_PAYMENT_AMOUNT_DAY_LIMIT_ERROR（买家付款日限额超限） ### **问题原因** 买家账户单日额度超限。 ### **涉及接口** [alipay.trade.precreate](https://opendocs.alipay.com/open/02ekfg?ref=api&scene=19) (统一收单线下交易预创建)
[alipay.trade.pay](https://opendocs.alipay.com/open/02ekfp?ref=api&scene=32) (统一收单交易支付接口) ### **解决方案** 买家当天的付款金额已经达到每天的付款限额，请用户更换其它支付宝账号或者支付方式再重新付款。
是否可提升额度，可咨询 4007585858，服务时间为：8:00-24:00。 --- ## 2. 如何解决退款返回交易不存在的问题 1. 确认退款请求中的外部商户订单号是否正确。 2. 检查交易对应的支付宝交易号是否正确。 3. 确认调用接口的appid是否属于退款订单对应的商家账号名下的appid。 4. 如果问题依然存在，可以使用提供的工具查询请求记录，进一步排查问题。退款诊断工具：[https://opensupport.alipay.com/support/diagnostic-tools/ed086f6c-a4e1-4fa0-b9dd-96c739054458](https://opensupport.alipay.com/support/diagnostic-tools/ed086f6c-a4e1-4fa0-b9dd-96c739054458) --- ## 3. 服务商模式，商家申请支付产品后，接口交互是使用服务商的appid和密钥吗？ 服务商代调用模式，是使用服务商的第三方应用appid和密钥，接口需要传商家授权的app_auth_token信息来表示代哪个商家调用接口。 --- ## 4. 如何解决支付宝异步通知验签失败的问题 1. 检查接收到的异步通知数据完整性：确保从支付宝收到的信息完整无误，格式正确。 2. 验证签名：确认是否对支付宝发送的数据进行了验签操作。 3. 确保验签使用的支付宝公钥或者支付宝公钥证书准确。 4. 如果问题仍然存在，可以使用支付宝提供的工具：[https://opensupport.alipay.com/support/diagnostic-tools/897ea317-ce35-40dc-8440-2c8c068d3eb7](https://opensupport.alipay.com/support/diagnostic-tools/897ea317-ce35-40dc-8440-2c8c068d3eb7) 查询异步通知记录，并进行进一步排查。 --- ## 5. 间联场景如何进行沙箱测试 支付宝沙箱环境不支持调试间连支付，建议于正式环境对接调试间连支付。 --- ## 6. 扫码支付和商家中心后台下载的商家收钱码有什么区别 **扫码支付**：可以对接"订单码支付"产品，商家通过接口入参订单金额等信息，用户通过支付宝app扫码支付，该产品需要开发集成，接入流程可以参考：[https://opendocs.alipay.com/open/repo-020ex6](https://opendocs.alipay.com/open/repo-020ex6)
**商家收钱码**：是商家中心后台下载的是静态码，不需要开发集成。 --- ## 7. 已经申诉退回到 UID了，为什么还是返回的openid 申诉退回到 UID开发成功后，您需要检查对应应用后台openid配置处，是否切换到uid作为用户标识。需点击**使用uid标准开发。** --- ## 8. 下单返回缺少ContributeDetail优惠券其他出资明细字段的原因是什么 检查订单是否支付成功状态。 --- ## 9. 如何在支付宝收款码支付时判断客户是否使用企业支付宝账号付款，不允许客户使用个人支付宝账号 目前支付宝API默认不会返回账号类型（企业或个人），如需进一步帮助，可以联系支付宝商户客服电话：4007585858，或登录 b.alipay.com 点击右侧小蚂蚁头像中的（我的客服）进行咨询。 --- ## 10. 如何通过软件开发公司A开发当面付功能，将款项收到民营医院B的支付宝账号 通过服务商三方代调用的方式，A去创建一个三方应用，B签约当面付产品，然后B给A授权，A通过三方应用的appid+B的授权token去代调用接口，实现收款到B的账号。
详细解决方案请参考：[https://opendocs.alipay.com/support/01raxz](https://opendocs.alipay.com/support/01raxz。) --- ## 11. 退款涉及券的情况是怎么退的 消费者支付时使用了支付宝平台优惠券（如消费券、支付宝红包等），订单退款时整笔订单会按照"整单等比例退款"逻辑进行退款 ，（退款金额/总金额）这个是比例，然后实际支付的金额（非红包，非优惠券的），乘以这个的比例，就是实际退款的金额（非红包，非优惠券的）。
具体支付宝优惠券退款逻辑参考：[https://opendocs.alipay.com/p/03bsok#1.3%20%E5%90%AB%E5%8D%95%E5%93%81%E7%9A%84%E7%AD%89%E6%AF%94%E4%BE%8B%E9%80%80%E6%AC%BE(%E4%BB%85%E7%9B%B4%E8%BF%9E)](https://opendocs.alipay.com/p/03bsok#1.3%20%E5%90%AB%E5%8D%95%E5%93%81%E7%9A%84%E7%AD%89%E6%AF%94%E4%BE%8B%E9%80%80%E6%AC%BE(%E4%BB%85%E7%9B%B4%E8%BF%9E)) --- ## 12. 没有门店可以申请开通当面付么 申请开通当面付是必须具备门店条件，因为当面付是一款为了满足商户在线下完成交易收款的产品。 --- ## 13. 统一收单交易撤销接口 alipay.trade.cancel(统一收单交易撤销接口)：支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，支付宝系统会将此订单关闭；如果用户支付成功，支付宝系统会将此订单资金退还给用户。 注意： 只有发生支付系统超时或者支付结果未知时可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】。
注：调用撤销接口后，订单的交易状态为trade_close（交易关闭）。
更多详情参考[统一收单交易撤销接口](https://docs.open.alipay.com/api_1/alipay.trade.cancel)。 --- ## 14. 如何通过接口确认进件商户已经进行商家认证 可以使用alipay.merchant.indirect.smidbind.query（获取商家认证状态接口），接口文档：[https://opendocs.alipay.com/open/03sqzb?scene=common&pathHash=dad9325b](https://opendocs.alipay.com/open/03sqzb?scene=common&pathHash=dad9325b) --- ## 15. 统一收单交易创建接口支持花呗分期吗？ 支持的。 --- ## 16. 当面付支付接口是否有类似于备注的字段，并且需要在支付查询接口中能返回的 目前没有独立的备注字段，建议使用out_trade_no、subject 这种由商户自定义类型的参数标记订单特征（订单查询接口会返回out_trade_no、subject等字段），实现自身业务场景。 --- ## 17. 当面付未支付订单如何处理 ### 问题原因 未支付订单如果不及时关闭，用户可能会误支付，从而导致用户资损，引起客诉。 ### 建议方案 - 对于未支付的订单，请及时通过调用[alipay.trade.close(统一收单交易关闭接口)](https://opendocs.alipay.com/open/e84f0d79_alipay.trade.close?scene=common&pathHash=9a85e8a9)关闭订单（注意：超过 24 小时的订单无法撤销）。 - 为每笔订单设置超时时间，超过时间未支付的订单会自动关闭。 --- ## 18. 如何完成支付宝开放平台的研发接入工作以开始收款 需要应用配置上线，设置接口加密，接入sdk，集成接口等。
具体接入流程可以参考下：[当面付产品接入准确文档](https://opendocs.alipay.com/open/01csp3?pathHash=83cd3b9a)。 --- ## 19. 码已失效，请刷新二维码后重试 ### 错误描述 当面付扫码或者电脑网站支付报错"码已失效，请刷新二维码后重试"。 ### 问题原因 根据不同场景的二维码，解决方案不同。 ### 解决方案 #### 1、门店码扫码报错 如果您是使用店铺收款码收款，请检查门店是否下架。
根据各自门店建议联系对应的客服，如收钱码门店联系商户客服（95188），口碑门店联系口碑客服（400-826-7710）。 #### 2、订单码扫码报错 使用统一收单线下交易预创建接口（[alipay.trade.precreate](https://opendocs.alipay.com/open/8ad49e4a_alipay.trade.precreate?scene=2ae8516856f24a5592194d237f3f235d&pathHash=d18bff53)）生成的二维码：
（1）若设置qr_code_timeout_express（二维码有效期），以设置的二维码有效时间为准，检查是否超时扫码。
注：qr_code_timeout_express设置时间小于等于2小时。
（2）若未设置qr_code_timeout_express，该二维码的有效时间是2小时，请检查是否超时扫码。
（3）检查是否使用正式环境支付宝钱包扫码沙箱环境生成的二维码；或者使用沙箱环境支付宝钱包扫正式环境生成的二维码。 #### 3、电脑网站支付扫码报错 （1）检查是否二维码已刷新
注：电脑网站支付二维码有效期为1分钟左右，自动刷新，刷新后之前的二维码无法扫码支付。
（2）检查是否使用正式环境支付宝钱包扫码沙箱环境生成的二维码；或者使用沙箱环境支付宝钱包扫正式环境生成的二维码。 --- ## 20. 产品如何添加功能包并绑定产品 目前开放平台已经更新，无需做功能包绑定的操作了，商家中心签约完成后，应用上会自动添加上产品能力（需要注意只会给产品支持的应用类型添加）；如果需要检查应用是否有接口权限可以查看应用下的可调用产品列表。
产品签约可以参考下面流程：
1、手机端：您可以登录支付宝APP端，搜索【支付宝商家助手】小程序，点击【签约助手】-选择对应产品 - 点击【立即开通】，根据页面提示填写对应资料，审核时间为24小时，结果有邮件短信通知。
2、电脑端：您可在电脑端登录支付宝商家平台（b.alipay.com）-点击【产品大全】-选择对应产品，点击【立即开通】，根据页面提示填写对应资料，审核时间为24小时，结果有邮件短信通知。 --- ## 21. 间连交易账单中的收款方全称怎么修改 间连账单中的收款方全称是您smid 对应的商户名称 ，这个要和您营业执照上保持一致，如果营业执照上商户名称变更了的话，可以调用 ant.merchant.expand.indirect.modify(商户分级与信息修改) 接口去修改name值 参考文档 [https://opendocs.alipay.com/pre-apis/00a8c9](https://opendocs.alipay.com/pre-apis/00a8c9) --- ## 22. 扫码支付 [扫码支付](https://docs.open.alipay.com/api_1/alipay.trade.precreate/)，指用户打开支付宝钱包中的"扫一扫"功能，扫描商户展示在各种场景的二维码并进行支付的模式。该模式适用于线下实体店支付、面对面支付等场景。扫码支付需要签约订单码支付后使用。更多详情参考[订单码支付产品](https://opendocs.alipay.com/open/05osux?pathHash=660a1801)。 --- ## 23. 如何通过账单区分订单来自哪一个应用appid 账单内并没有说明订单对应appid应用信息，可以自定义单号自行通过单号判断。 --- ## 24. alipay.trade.precreate(统一收单线下交易预创建) 当面付适用于线下收款，收银员通过收银台或商户后台调用本接口返回qr_code（二维码码串），用二维码生成工具根据该qr_code码串值生成对应的二维码，用户扫描二维码完成订单支付。
相关资料下载：[alipay.trade.precreate](https://opendocs.alipay.com/open/f540afd8_alipay.trade.precreate?pathHash=d3c84596&ref=api&scene=19) --- ## 25. 使用个人支付宝收款码进行公司业务收款是否可行 不建议使用个人支付宝收款码进行公司业务收款。 首先，这样做可能不符合支付宝对于商业收款的规范，可能影响到您的账户使用，包括可能导致交易风险、影响资金结算等。其次，个人账号收款可能无法享受到企业账号在税务、资金管理等方面的便利。所以建议商户使用企业支付宝收款码进行公司业务收款。 --- ## 26. nodejs的SDK异步通知验签异常：URIError: URI malformed 解决方案：检查通知信息中是否包含特殊支付，例如%、#号等；这个是由于特殊支付编码异常导致，建议自行将特殊支付转义，例如：%替换成%25 --- ## 27. 如何变更二级商户营业执照信息 可调用ant.merchant.expand.indirect.modify（商户分级与信息修改）修改，参考文档：[https://opendocs.alipay.com/pre-apis/00a8c9](https://opendocs.alipay.com/pre-apis/00a8c9) --- ## 28. 对接安全发产品是否必须使用通用版sdk 也可使用easySDK中的通用接口Generic调用安全发接口。 --- ## 29. 退款接口超过多久时无法进行退款 交易支付产品的可退款时间和签约的收单合约有关，默认交易创建的可退款时间是12个月，超过可退款时间要退款可以通过线下方式联系用户退款或者通过接口转账给用户。
[可退款时间](https://opensupport.alipay.com/support/FAQ/747a7169-5437-43b6-84a5-4a0944d90d30)是签约产品时进行设置的，是否可以修改及如何修改相关问题，请到[商家服务中心](https://b.alipay.com/index2.htm)在线咨询或拨打商家服务热线400*****58咨询，服务时间为：8:00-24:00。 --- ## 30. 同一笔支付订单可以多次调用预下单接口吗 out_trade_no需要保持商户侧唯一： 1. 如果是交易未创建的情况可以保持out_trade_no不变重新拉起支付。 2. 如果交易已经创建成功，接口参数都不做修改的情况重新调用接口生成二维码只能由已经创建交易的用户拉起支付。 3. 如果交易已经创建，并且接口业务传参有修改（例如：total_amount、Subject等参数）则对应用户拉起支付会报错，交易信息被篡改。 --- ## 31. 付款码支付是否需要输入密码 在一般情况下，付款码支付主流程是代扣流程，即不需要输入密码，商家用扫码枪扫一下支付宝客户端的付款码，即可完成支付。
当扣款额度超过单笔1000 元 or 单日50000元（接口返回10003） 或 支付宝检测到支付存在风险，需要用户在支付宝钱包输入支付密码支付。 --- ## 32. 如何在支付宝开放平台设置不同网站的付款页面显示对应网站名称 在支付宝开放平台，付款页面显示的商户名称遵循以下优先级： - store_id > 商家别名 > app_auth_token 对应授权商家账户名称 > APPID 对应商家账户名称 如果商户想实现不同网站的付款页面显示对应网站名称，可以在商家平台的账号中心修改商家别名来实现。 --- ## 33. 统一收单交易退款接口，退款后，接收不到通知 1. 确认支付接口中设置了通知回调地址。 2. 检查通知回调地址是否与实际设置一致。 3. 确认入参格式正确，特别是notify_url的位置，应与biz_content同级。 4. 如问题依旧，建议使用"异步通知"工具解决，工具地址：[https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e](https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e) --- ## 34. ACQ.TRADE_HAS_SUCCESS（该笔订单交易已经被支付） ### **报错描述** 支付时提示：支付失败，交易已经支付，请勿重复支付。 ### **报错原因** 该笔订单，交易已被支付。 ### **涉及接口** - alipay.trade.order.pay（统一收单交易订单支付接口） - [alipay.trade.page.pay](https://opendocs.alipay.com/open/028r8t)（统一收单下单并支付页面接口） ### **排查方案** 1. 该笔订单已经被请求支付，请更换请求参数：out_trade_no（商户订单号），重新发起请求。 2. 如是当面付扫码支付，检查接口返回的 qr_code 参数的付款链接，是否已超时失效，导致出现该报错。 3. 如果问题仍然存在，可以使用支付宝开放平台提供的诊断工具进行排查：[https://opensupport.alipay.com/support/diagnostic-tools/2df82aad-0f8a-476a-916d-763f9764d4f6](https://opensupport.alipay.com/support/diagnostic-tools/2df82aad-0f8a-476a-916d-763f9764d4f6) --- ## 35. 对接安全发产品是否必须使用通用版sdk吗？ 也可使用easySDK中的通用接口Generic调用安全发接口。 --- ## 36. 调试当面付接口提示无权限 对接当面付产品，需要完成相关"接入准备"工作，流程详见：[https://opendocs.alipay.com/open/01csp3?pathHash=83cd3b9a](https://opendocs.alipay.com/open/01csp3?pathHash=83cd3b9a)
确保应用上线、绑定商家账号后，还需完成产品开通才能使用 当面付。请在 商家平台 > [产品中心](https://b.alipay.com/page/product-mall/all-product) 的 [当面付产品详情页](https://b.alipay.com/page/product-mall/product-detail/I1080300001000041016) 面点击 [立即开通](https://b.alipay.com/page/product-mall/product-detail/I1080300001000041016)，填写并提交相关信息完成产品开通。详情可点击查看 [开通产品](https://opendocs.alipay.com/open/200/105314/) 。
如您已经开通当面付，则无需再次开通，开通状态可点击 [产品开通情况](https://b.alipay.com/page/products-sign/dynlink/productSign/signManage.htm) 查询。 --- ## 37. 当面付异步通知返回的资金渠道中哪些是有商家出资的枚举 是否商家出资优惠，可通过voucher_detail_list中merchant_contribute去判断，用户付款的支付渠道可以参考：[https://opendocs.alipay.com/support/01rfo2](https://opendocs.alipay.com/support/01rfo2) --- ## 38. 如何查询支付宝开放平台接口调用的详细日志，包括调用地址和参数 可以通过"日志查询工具"获取接口参数，工具地址：[https://opensupport.alipay.com/support/diagnostic-tools/97efd231-e8aa-490a-8284-c9cd20e8820e](https://opensupport.alipay.com/support/diagnostic-tools/97efd231-e8aa-490a-8284-c9cd20e8820e) --- ## 39. 当面付产品进行分账时，退分账时报参数无效错误，应该如何解决 1. 当面付产品退分账时不需要传退分账明细。 2. 请检查您的接口入参是否正确，确保所有必填参数都已正确填写，接口参数参考官方文档：[https://opendocs.alipay.com/open/009yja?pathHash=71d1b988#%E9%80%80%E5%88%86%E8%B4%A6%E6%B5%81%E7%A8%8B。](https://opendocs.alipay.com/open/009yja?pathHash=71d1b988#%E9%80%80%E5%88%86%E8%B4%A6%E6%B5%81%E7%A8%8B。) 3. 借助[分账工具](https://opensupport.alipay.com/support/diagnostic-tools)排查接口报错原因。 --- ## 40. notify_url 无法接收到参数的原因及解决方法 如果您的 notify_url 无法接收到参数，可能是以下原因导致的： 1. 网络问题：请确保您的 notify_url 是一个公网可访问的地址，没有被防火墙或者路由设置阻止。 2. 异步地址设置问题：请按照文档正确设置异步地址。异步地址设置应在公共参数中进行设置，而不是在业务参数中。正确的设置方式为：$request->setNotifyUrl("商家自己的notify_url地址")。 3. 请检查设置后的通知地址是否正确，并确保地址能够正常接收回调信息。 4. 使用工具查询异步信息：可以使用：[https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e](https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e) 这个工具查询异步信息。 --- ## 41. 退款接口是不是只要同步返回code 10000 就一定会返回sub_code 是的，退款接口同步返回code 10000时，msg参数会返回，sub_code不会返回；sub_code是在调用接口有报错的情况才会返回。 --- ## 42. subject可以传入特殊字符吗？ 接口入参subject可以传入特殊字符，在请求url中必须用charset指定的字符集做urlencode。
注意：subject会在收银台和账单中展示，部分特殊字符可能会导致app端无法识别被转义，例如 + 号被转成空格，慎重入参特殊字符信息。 --- ## 43. 多个小程序可以归属同一个账户吗? 可以的，小程序应用创建时默认归属对应开放平台登录账号，如果是管理员身份，可以选择归属账号信息。 --- ## 44. 为什么接口响应格式不一样 接口不同、其适用场景不同，接口响应参数格式就会存在差异，建议参考对应接口API文档示例进行接口调试。 --- ## 45. 可以用当面付的功能来用作PC网站收款吗 不行，当面付产品主要用于线下支付场景。PC网站收款（线上支付场景）建议使用"电脑网站支付"产品，接入文档参考：[https://opendocs.alipay.com/open/270/105898?pathHash=b3b2b667](https://opendocs.alipay.com/open/270/105898?pathHash=b3b2b667) --- ## 46. 个人能不能定制支付功能？ 支付功能暂无法定制，目前只能去集成开放平台提供的一些支付接口哈，例如当面付、订单码支付等支付产品：[https://opendocs.alipay.com/open/194/105072?pathHash=45357796](https://opendocs.alipay.com/open/194/105072?pathHash=45357796) --- ## 47. 当面付产品介绍 > **公告**：当面付产品不再支持小程序使用，小程序请选择专用支付产品（[JSAPI支付](https://opendocs.alipay.com/mini/053llc?pathHash=d81d3a2a)、[预授权支付](https://opendocs.alipay.com/open/06de96?pathHash=f6dfbf6f)、[商家扣款](https://opendocs.alipay.com/open/06de8c?pathHash=654eb816)），准确区分交易数据，经营分析更精准。 ### 产品特色 当面付是指商家识别用户付款介质（如：条形码、二维码、NFC等）收款或用户识别商家收款介质付款的一种支付产品，主要适用于线下场所面对面收银的场景，例如：便利店、商超综合体、餐饮、医院、学校、电影院、旅游景区等具有明确经营地址的实体场所。 ### 使用示例 商家使用扫码枪或其它扫码机具扫描用户出示的付款码，来实现收款。 ### 申请条件 支持的账号类型：[支付宝企业账号](https://opendocs.alipay.com/common/02kkum)、[支付宝个人账号](https://opendocs.alipay.com/common/02kg61)、[个体工商户](https://opendocs.alipay.com/common/02kkul?pathHash=134df856)。
签约申请提交材料要求如下： - 经营场所照片，包括店铺招牌照片和店铺内景照片。 - 店铺名称/经营品牌名称。 - 实际经营地址。 - 如以个人账号申请，需提供营业执照。**注意**：需按要求提交材料，若部分材料不合格，收款额度将受到限制（单笔收款 ≤ 2000 元，单日收款 ≤ 20000 元）。若签约时未能提供相关材料（如营业执照），请在合约生效后的 30 天内补全，否则会影响正常收款，[点此查看详情](https://opendocs.alipay.com/b/039qjw)。 ### 费率 | 收费模式 | 费率 | | --- | --- | | 单笔收费 | 0.6% | 当前产品在交易过程中会产生服务费，按单笔订单金额的 0.6% 收费。不同的支付工具均按该费率向商家收取服务费。可支持的支付工具有支付宝余额、银行卡 (储蓄卡和信用卡) 、花呗、花呗分期等。
**费率计算规则**：单笔订单服务费金额四舍五入，保留小数点后 2 位。服务费计算举例如下表。 | 交易金额（元） | 费率 | 应付服务费（元） | 实付服务费（元） | 到账金额（元） | | --- | --- | --- | --- | --- | | 1618 | 0.6% | 9.708 | 9.71 | 1608.29 | | 1617 | 0.6% | 9.702 | 9.70 | 1607.30 | ### 结算 收款账户：默认收款到商家签约账号的支付宝余额账户，实时到账。
**注意**：根据相关规定，新签约该产品未满 90 日或连续交易未满 30 日的商家，通过该产品收款的资金都将于次日结算到收款账户。商家当日的收款资金，可在 **对账中心** > [不可用余额](https://b.alipay.com/page/mbillexprod/unavailable/balance/detail) 中查看。 ### 退款 默认交易发生后的 12 个月内，商家可退款，实际可退款时间以合约约定的时间为准。退款资金按原路退还至用户账户。
退款退费：退款时服务费会一并退回商家账户。 ### 接入方式 开通：点击 [立即开通](https://b.alipay.com/page/ar-center/merchant-sign/form?productCode=I1011000100000000001)，按要求填写并提交产品开通申请，点此查询 [产品开通情况](https://b.alipay.com/page/products-sign/dynlink/productSign/signManage.htm) 。
开发：点此查询 [开发文档](https://opendocs.alipay.com/open/01csp3?ref=api) 。
详见：[https://opendocs.alipay.com/open/194/105072?pathHash=45357796](https://opendocs.alipay.com/open/194/105072?pathHash=45357796) --- ## 48. 当面付到账时间 ### 当面付结算规则 收款账户：默认收款到商家签约账号的支付宝余额账户，实时到账。
**注意**：根据相关规定，新签约该产品未满 90 日或连续交易未满 30 日的商家，通过该产品收款的资金都将于次日结算到收款账户。商家当日的收款资金，可在 **对账中心** > [不可用余额](https://b.alipay.com/page/mbillexprod/unavailable/balance/detail) 中查看。
详见：[https://opendocs.alipay.com/open/194/105072?pathHash=45357796](https://opendocs.alipay.com/open/194/105072?pathHash=45357796) --- ## 49. 支付宝支付平台支持农村商业银行吗 支付宝侧提供的支付接口只支持拉起支付宝侧的收银台，用户可以在支付宝收银台上去选择支付渠道（比如：余额、绑定的银行卡等）。 --- ## 50. 调用撤销接口需要注意什么 在调用撤销和退款接口后，建议调用alipay.trade.query来查询订单状态。不能依赖用户展示的钱包支付结果，否则可能导致商户资损，出现单边账。因为撤销可能会触发退款。
注意：交易超过 24 小时无法进行撤销。 --- ## 51. 关掉小额免密功能后，付款码支付仍不需输入密码 因为小额免密与付款码支付非同一概念，小额免密支付是指跳转收银台时经判断无需验证支付密码即可实现支付。支付宝客户端 9.0 版本之后，在代扣额度内默认不需要输入密码。 --- ## 52. 查询接口返回receipt_amount为0 需要在查询接口中加上query_options参数，且值为fund_bill_list后，才会返回receipt_amount的参数值
详见：[https://opendocs.alipay.com/open/6f534d7f_alipay.trade.query?scene=23&pathHash=f6cde6a9](https://opendocs.alipay.com/open/6f534d7f_alipay.trade.query?scene=23&pathHash=f6cde6a9) --- ## 53. 退款接口同步响应如何验签 可以参考文档中异步同步通知数据验签示例：[https://opendocs.alipay.com/support/01ravg](https://opendocs.alipay.com/support/01ravg) --- ## 54. 如何解决订单总金额格式错误的问题 当遇到订单总金额格式错误时，需要确保金额格式正确，即小数点后保留两位（取值范围[0.01,100000000]，金额不能为0）。例如，正确的金额格式应该是"total_amount":"1.66"。请检查并调整金额格式后重新提交订单。 --- ## 55. 如何解决支付宝支付成功回调地址的SSL握手异常问题 1. 检查回调地址的证书情况。 2. 可以先使用http地址进行测试，确保回调可以正常走通。 3. 调通后再使用https证书进行正式测试。 4. 可以使用支付宝开放平台提供的诊断工具查询异步同步发送结果，进一步排查问题。工具地址：[https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e](https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e) --- ## 56. ACQ.TOTAL_FEE_EXCEED（订单金额超过限额） ### **报错原因** 订单总金额超过限额或者订单金额为0。 ### **涉及接口** [alipay.trade.create](https://opendocs.alipay.com/open/02ekfj?ref=api) (统一收单交易创建接口)
[alipay.trade.precreate](https://opendocs.alipay.com/open/02ekfg?ref=api&scene=19) (统一收单线下交易预创建)
[alipay.trade.pay](https://opendocs.alipay.com/open/02ekfp?ref=api&scene=32) (统一收单交易支付接口)
[alipay.trade.app.pay](https://opendocs.alipay.com/open/02e7gq?ref=api&scene=20) (app支付接口2.0)
[alipay.trade.wap.pay](https://opendocs.alipay.com/open/02ivbs?ref=api&scene=21) (手机网站支付接口2.0)
[alipay.trade.page.pay](https://opendocs.alipay.com/open/028r8t?ref=api&scene=22) (统一收单下单并支付页面接口) ### **解决方案** 订单总金额不在允许范围内；请调整订单总金额之后再发起请求（订单金额最小为0.01元）。
订单总金额超过限额：具体接口产品限制额度为多少，请拨打商家服务热线400*****58咨询，服务时间为：8:00-24:00。 --- ## 57. 当面付如何生成二维码 当面付扫码支付
**注意**：**当面付扫码支付**已升级为**订单码支付**，建议使用**订单码支付**
前提：需要集成开发，若商家不会开发能力，需自行联系相关服务商帮助开发。
二维码状态：为动态二维码，每次请求生成的二维码不同。
**当面付扫码支付**： - 调用统一收单线下交易预创建接口，返回 qr_code（二维码码串），开发商可使用二维码生成工具根据该码串值生成对应的二维码。 - 用户打开支付宝客户端中的扫一扫功能，扫描商家展示在某收银场景下的二维码并进行支付的模式。API：[alipay.trade.precreate](https://opendocs.alipay.com/open/02ekfg?scene=19)（统一收单线下交易预创建接口）。
当面付与订单码支付区别：以上接口调用流程是一样的，product_code 值不一样。
当面付：对应的 product_code 是 FACE_TO_FACE_PAYMENT。
订单码支付：对应的 product_code 是 QR_CODE_OFFLINE。 --- ## 58. alipay.trade.pay(统一收单交易支付接口（当面付）) 当面付适用于线下收款，收银员使用扫码设备读取用户手机支付宝"付款码"获取设备（如扫码枪）读取用户手机支付宝的付款码信息后，将二维码或条码信息通过本接口上送至支付宝发起支付。
相关资料下载：[alipay.trade.pay](https://opendocs.alipay.com/open/1f1fe18c_alipay.trade.pay?pathHash=29c9a9ba&ref=api&scene=32) --- ## 59. 付款码支付对接文档 付款码支付产品对接文档可以参考：[https://opendocs.alipay.com/open/194/105072?pathHash=45357796](https://opendocs.alipay.com/open/194/105072?pathHash=45357796) --- ## 60. 为什么三方应用升级到openid但是同步返回的还是user_id 为保护用户个人信息安全，开放平台接口将逐步升级到 openid 标准，平台新入驻商家将统一使用 openid 作为用户标识。升级过程中，第三方应用与商家应用用户标识不兼容（如：第三方应用 userid，商家应用 openid），服务商为商家提供代开发服务时，可能会出现问题。可通过将第三方应用与商家应用用户标识进行兼容，兼容方案详见：[https://opendocs.alipay.com/mini/0ai85s?pathHash=ed536d30](https://opendocs.alipay.com/mini/0ai85s?pathHash=ed536d30) --- ## 61. 支付成功的订单，交易查询接口为什么返回buyer_pay_amout为0 可以在查询接口中传入query_options参数（值为fund_bill_list），就可以查询到实付金额。
详见接口文档：[https://opendocs.alipay.com/open/4e2d51d1_alipay.trade.query?scene=common&pathHash=8abc6ffe](https://opendocs.alipay.com/open/4e2d51d1_alipay.trade.query?scene=common&pathHash=8abc6ffe) --- ## 62. 当面付如何添加功能包并绑定产品 目前开放平台已经更新，无需做功能包绑定的操作了，商家中心签约完成后，应用上会自动添加上产品能力（需要注意只会给产品支持的应用类型添加）。
如果需要检查应用是否有接口权限可以查看应用下的可调用产品列表。
产品签约可以参考下面流程：
1、手机端：您可以登录支付宝APP端，搜索【支付宝商家助手】小程序，点击【签约助手】-选择对应产品 - 点击【立即开通】，根据页面提示填写对应资料，审核时间为24小时，结果有邮件短信通知。
2、电脑端：您可在电脑端登录支付宝商家平台（b.alipay.com）-点击【产品大全】-选择对应产品，点击【立即开通】，根据页面提示填写对应资料，审核时间为24小时，结果有邮件短信通知。 --- ## 63. 异步通知说明 异步通知是指一笔订单支付完成后，支付宝会将该笔订单的变更信息，沿着商家调用支付请求时所传入的异步通知地址 notify_url，通过 POST 请求的形式将支付结果作为参数通知到商家系统。
异步回调地址状态码 (HTTP 状态码) 为 200 时表示异步通知成功，返回码为 404 或 500 时则表示服务器内部错误，需要商家自行排查。 > 由于网络异常、系统波动等原因，可能会存在用户支付成功、但是商户侧未能成功接收到支付结果异步通知的情况。这将会导致商户获取不到支付结果、用户订单显示为未支付，用户体验差且易造成客诉。
更严重的，易大批量出现用户对一笔订单进行重复支付的现象，带来糟糕的用户体验与强烈客诉。
为杜绝以上问题，需要商户同时接入支付结果异步通知与统一收单交易查询接口。当商户侧未收到支付结果异步通知时，必须调用 alipay.trade.query（统一收单交易查询接口）查询订单的支付结果。
当商户针对同一笔业务订单更换商户订单号（out_trade_no）来请求支付宝前，强烈建议商户先查询前一个商户订单号的支付结果： - 若为支付成功（trade_status = TRADE_SUCCESS），则不要再请求支付宝重复进行支付。 - 若为买家仍未支付（trade_status = WAIT_BUYER_PAY），则调用 alipay.trade.close（统一收单交易关闭接口）关闭此订单后再请求支付宝进行支付。详见：[https://opendocs.alipay.com/open/194/103296?pathHash=e43f422e](https://opendocs.alipay.com/open/194/103296?pathHash=e43f422e) --- ## 64. 如何查询交易收款账号 可以使用工具：[https://opensupport.alipay.com/support/diagnostic-tools/dd59ab8e-5de5-419e-8b40-0469d25addc4](https://opensupport.alipay.com/support/diagnostic-tools/dd59ab8e-5de5-419e-8b40-0469d25addc4) 输入支付宝交易号查询订单收款账号。 --- ## 65. 二维码能否重复扫 二维码被扫过一次后，订单即会创建，其他买家不能再次扫码支付。
同一订单只能支付一次，不能一个订单多次支付。
即A用户扫二维码创建订单后，B用户不能扫该二维码，否则报错"交易买家不匹配"。但是A用户仍然可以扫该二维码进行支付。
订单码支付相关接入说明可以参考[订单码产品及接口文档](https://opendocs.alipay.com/open/05osux?pathHash=660a1801)。 --- ## 66. 当面付怎么计算优惠折扣？ 商户优惠=订单总金额-商户实收，详细请移步 [当面付接口如何计算优惠](https://support.open.alipay.com/support/hotProblemDetail.htm?id=238872)。 --- ## 67. 间联 进件环节： 不支持"港澳居民来往内地通行证" ？ 目前仅支持港澳台身份证，不支持通行证。 --- ## 68. 直付通自动结算是否需要主动调用结算接口 不需要。 --- ## 69. nodejs的SDK异步通知验签异常 nodejs异步通知验签异常：URIError: URI malformed。
解决方案：检查通知信息中是否包含特殊支付，例如%、#号等；这个是由于特殊支付编码异常导致，建议自行将特殊支付转义，例如：%替换成%25 --- ## 70. 异步通知接收不到参数 **接收方式** - 异步地址必须 post 接收异步通知。异步为 post 访问，同步为 get 访问，接收方式不同。 - 异步地址必须外网可访问。如何接收异步通知参考文档示例：[https://opendocs.alipay.com/support/01rawm](https://opendocs.alipay.com/support/01rawm) --- ## 71. 如何解决支付宝商户权限不足的问题 1. 明确接入的产品，去开通一下对应的产品。 2. 确认接口参数按照产品文档传参。 --- ## 72. 如何实现一码多付 通过一个二维码完成多种第三方支付方式支付的需求。
商家打印一个静态的二维码，用户用 App（例如支付宝、微信、百度）扫这个二维码后，进入商家的一个付款页面，输入金额后，完成支付。
其技术实现方式如下： ### 生成二维码 通常线下场景是一个门店一个二维码，因此生成二维码时最好加入门店 id 参数。可以方便使用统一门店编号定位到是哪个商家的交易，结算给哪个商家，收款成功后通知给哪个商家。一般建议生成二维码的 URL 不要太长，长度越短则生成的二维码识别率越高。 ### 扫码识别 用户扫码时，可能会有许多种软件来扫，但能够处理支付宝交易的却只有支付宝客户端。因此需要做识别扫码来源并在页面作出提示，引导用户用支付宝扫码。用户用 App 扫商家的二维码后，其实是用 App 浏览器打开到商家的页面，商家页面通过识别浏览器 header 中的 user-agent 来判断是哪个 App 打开的。
常见 App 浏览器的 user-agent 识别关键字： - 支付宝：AlipayClient - 微信：MicroMessenger如果识别到不包含 AlipayClient，则跳转到错误提示页面，引导用户用支付宝扫码。
支付宝扫码成功后，会将门店 id 提交到开发者的服务端，可以保存在 session 中或放在下一步的授权回调地址参数中。 ### 获取用户信息 扫码成功后，需要先获取到扫码用户的 userid，不然下一步下单无法进行。
获取用户是使用支付宝的用户信息授权实现。
简单来说分为以下五步实现： 1. 拼接授权地址，包含授权范围和回调地址 （授权范围用这个 scope=auth_base，回调地址中可以包含一些参数：如门店 id）； 2. 让用户浏览器跳转到授权地址，授权后用户浏览器会请求 redirect_uri 回调地址； 3. 授权后 redirect_uri 回调地址会收到 auth_code 参数； 4. 使用 auth_code 参数去换取 user_id 和 access_token (access_token）下单接口暂时使用不上，只需要使用 user_id 值)； 5. 使用 access_token 可以去获取用户授权信息（这一步开发者一般用不上，授权范围为 scope=auth_user 时使用，可以获取用户更多信息）；以上几个步骤可以查看 [网页授权获取用户信息](https://opendocs.alipay.com/open/284/web/)。
拿到 user_id 后可以给下一步下单使用。
服务端拿到 user_id 后，user_id 可以存 session，也可以返回给用户页面隐藏域表单，并给用户页面显示付款页面。 ### 下单 由于一码多付方案都是最简便方式，没有收银员输入金额的流程。
所以付款页面需要有输入框让用户填写付款金额，并提交表单发起付款。
目前已有了门店 id，付款方 userid，交易金额，开发者可以通过门店 id 在系统中查到配置的收款方账号信息。此时使用 [统一收单交易创建接口](https://opendocs.alipay.com/open/02ekfj) 发起下单，下单成功后，支付宝会返回支付宝交易号，使用 [JSAPI 唤起收银台支付](https://opendocs.alipay.com/open/common/105591) 让用户付款。
服务端将脚本和订单号组装好返回给用户浏览器，用户支付宝浏览器会自动执行 JS 并唤起收银台，让用户选择付款渠道和输入密码，完成付款。
完成付款后，用户页面会跳转到支付宝统一的付款成功页面。 ### 获取收银结果 服务端获取用户的付款状态有两种方式： #### 轮询结果 服务端发起下单后就异步子线程向支付宝发起 [交易查询](https://opendocs.alipay.com/open/02ekfh?scene=23) 请求，每隔 5 秒查一次，查 1~2 分钟，一旦查到付款成功则终止，如果超时了还未付款，则发起 [交易撤销](https://opendocs.alipay.com/open/02ekfr) 请求，避免用户在离店之后付款产生单边账纠纷。 #### 异步通知 下单时，根据文档在交易创建接口中传递 notify_url 公共参数，则付款成功后支付宝会给这个 notify_url 地址发起回调付款结果。
获取异步通知付款结果可以查看 [扫码支付异步通知说明](https://opendocs.alipay.com/open/194/103296)。
通知收银台服务端获取到付款成功的结果后，需要通知收银员（直接让用户拿手机付款结果给收银员看是有风险的，如：用户拿付款成功的截图欺骗收银员，或用户付款成功但商家未入账。 --- ## 73. 支付宝支付后没有回调通知，如何解决 1. 确认支付成功后，通知数据会通过POST方式发送到您设置的回调地址。 2. 检查您的回调地址是否正确设置，需要外网可达，且确保是POST方式。 3. 确保notify_url是配置在接口请求的公共参数里，和biz_content同级。 4. 使用异步通知工具查询通知情况：[https://opensupport.alipay.com/support/diagnostic-tools/0d278b63-aaa5-4aa3-adec-5f08adf29986。](https://opensupport.alipay.com/support/diagnostic-tools/0d278b63-aaa5-4aa3-adec-5f08adf29986。) --- ## 74. 如何对接风险联防 为防止欺诈者在商户端创建订单，将二维码或对应的支付链接给受害者声称刷单返款，商户作为第三方在不知情的情况下，进入正常发货或充值流程，收货或到账后欺诈者变现获利情况的发生，可通过在支付接口中入参风险联防参数去实现。商户风险联防指引：[https://opendocs.alipay.com/open/00f7nz?pathHash=b9e18928](https://opendocs.alipay.com/open/00f7nz?pathHash=b9e18928) --- ## 75. 收单支付1.0接口文档地址在哪 如果您是历史存在的商户需要查看接口文档，可以通过这个链接进入部分1.0收单接口文档中查看：[https://opendocs.alipay.com/open/277/agg4ok?pathHash=6a1eac03](https://opendocs.alipay.com/open/277/agg4ok?pathHash=6a1eac03) ，当面付的1.0接口文档暂时没有对外开放的文档地址
注意：目前1.0接口已停止维护，存量商户可继续使用，新商户已无法对接，新接入商户需要使用新版接口。 --- ## 76. 用户如何查询未支付或支付失败的订单状态 未支付的订单如果是订单没有创建成功的话，是查询不到的；支付失败的订单可以使用alipay.trade.query(统一收单交易查询)接口查询，对应文档：[https://opendocs.alipay.com/open/6f534d7f_alipay.trade.query?scene=23&pathHash=f6cde6a9](https://opendocs.alipay.com/open/6f534d7f_alipay.trade.query?scene=23&pathHash=f6cde6a9)。 --- ## 77. 退款接口 没有返回subcode 是不是代表返回的code 一定是10000 code非10000时才有sub_code参数返回。alipay.trade.refund（统一收单交易退款接口）调用成功即是 alipay_trade_refund_response 返回 "code":"10000","msg":"Success"，但仅表示接口调用成功，不代表退款是否成功。退款是否成功可以根据同步响应的 fund_change 参数来判断，fund_change 表示本次退款是否发生了资金变化，返回 Y 表示退款成功，返回 N 则表示本次退款未发生资金变动。 --- ## 78. 返回码为 20000但业务出现未知错误或者系统异常 需要调用查询接口确认订单状态或者调用撤销接口发起撤销。 --- ## 79. 如何解决支付宝回调地址返回403 Forbidden错误 1. 确认回调地址和接口是否正确。 2. 检查服务器是否有拦截或防火墙设置，确保支付宝IP地址被添加到白名单中。 3. 如果问题依然存在，可以发送邮件至tec***@alipay.com，提供公司名称、PID、申请原因、申请负责人名称、职务、联系手机和联系邮箱，以便获取支付宝IP。 4. 确认回调参数长度是否超出限制，调整参数长度或优化参数传递方式。
5.也可使用工具排查异步通知发送记录，工具地址：[https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e](https://opensupport.alipay.com/support/diagnostic-tools/329cfb48-dbc6-4d9a-a528-d348b9618b5e) --- ## 80. 用户在使用支付宝异步通知时遇到回调失败的问题，如何排查和解决 1. 检查设置的回调地址是否正确。 2. 确认回调地址能够外网可达且没有重定向。 3. 如果问题依然存在，建议使用支付宝提供的异步通知工具进行排查，工具地址为：[https://opensupport.alipay.com/support/diagnostic-tools/0d278b63-aaa5-4aa3-adec-5f08adf29986。](https://opensupport.alipay.com/support/diagnostic-tools/0d278b63-aaa5-4aa3-adec-5f08adf29986。) --- ## 81. 异步验签一直返回false，如何解决 1. 确认是否使用支付宝公钥进行验签。 2. 检查接收到的原始信息，确保没有脱敏处理。 3. 如果问题仍然存在，建议使用支付宝提供的"异步通知"工具进行诊断和解决。 --- ## 82. alipay.trade.wap.pay(手机网站支付接口2.0)接口中哪个参数传入后会在对账文件中进行展示 在alipay.trade.wap.merge.pay（无线Wap合并支付接口2.0）中，对账文件通常会包含交易的基本信息以供核对。关键参数如out_trade_no（商户订单号）和trade_no（支付宝交易号）会在对账文件中展示，具体可以参考商家账单示例 [https://opendocs.alipay.com/open/01inen#%E9%99%84%E5%BD%95](https://opendocs.alipay.com/open/01inen#%E9%99%84%E5%BD%95) --- ## 83. 异步通知回调接收到要给支付宝返回什么信息呢 异步回调数据接收成功，在执行完业务逻辑后，需要返回 success 这 7 个字符给支付宝，避免支付宝服务器不断重复发送通知。 --- ## 84. 当面付自定义扩展参extend_params数如何传参？ extend_params这个是扩展参数，不同业务场景要根据对应业务侧要求传参，具体传参格式可以参考文档示例
[https://opensupport.alipay.com/support/FAQ/6718c54df1d5bc04525ea4a8prod](https://opensupport.alipay.com/support/FAQ/6718c54df1d5bc04525ea4a8prod) 示例中提供的是biz_conent的方式入参，支付宝sdk中model方法有很多业务上的扩展参数SDK那边都是没有提供的，都需要自行重写类。 --- ## 85. 支付宝发送的异步通知会有转义空格吗 不会的，支付宝给您发送的异步通知不会有转义空格，您需要检查一下接收到的异步通知是不是额外做了编码处理等。 --- ## 86. 支付宝是否可以提供SSL证书给商户，方便接口相关问题的排查 支付宝不支持提供ssl证书供商户排查，ssl证书这个是商家这边自己的信息的，一般是贵司运维同学集成的，或者是购买域名提供方的，这个信息支付宝这边是无法提供的。 --- ## 87. 退款接口同步响如何验签 可以参考文档中异步同步通知数据验签示例：[https://opendocs.alipay.com/support/01ravg](https://opendocs.alipay.com/support/01ravg) --- ## 88. 商家中心后台如何开启风险联防 登录商家中心后台 [https://b.alipay.com/page/portal/home](https://b.alipay.com/page/portal/home) 去开启风险联防后再去接口入参风险联防参数，如果是商家中心后台没有显示风险联防的入口，则需联系您的支付宝业务经理找联防团队的产研申请下。 --- ## 89. 退款支持使用美元吗？ 不支持的，目前大陆境内的支付宝接口暂时不支持其他货币进行付款/退款，只能使用人民币进行支付/退款。 --- ## 90. B2B支付直连版本接入文档中的extend_params扩展参数怎么入参，bizModel里面有些参数没有 model方式传参存在一些参数没有封装，可以走bizcontent方式去入参。 --- ## 91. 当面付接口中extend_params参数的作用 extend_params这个是扩展参数，不同业务场景要根据对应业务侧要求传参，SDK里面是不包含所有业务场景的参数信息的，可以根据对应业务文档要求自己定义参数信息。 --- ## 92. 当面付同步返回：等待用户付款10003状态是交易失败吗？ 等待用户付款（10003）是由于余额不足、超额等原因导致订单创建但支付未成功，等待用户付款。
付款码支付由于是线下面对面支付，需尽快确认交易情况，建议通过[轮询方式](https://opendocs.alipay.com/open/194/105322)判断交易状态，避免单边账。参考轮询方式：[https://opendocs.alipay.com/open/194/105322](https://opendocs.alipay.com/open/194/105322) --- ## 93. 退款接口时(alipay.trade.refund)会通过支付接口(alipay.trade.precreate)填的return_url进行同步通知吗 不会通过return_url进行同步通知，判断退款是否成功以异步通知和alipay.trade.query查询接口为准。退款分为部分退款和全额退款。 #### 部分退款 部分退款交易状态是处于 TRADE_SUCCESS（交易成功），此时因部分退款导致交易金额变动，会触发异步通知。 #### 全额退款 交易成功后全额退款，交易状态会转为 TRADE_CLOSED（交易关闭），此时根据不同的支付接口触发条件也不同。
例如 APP 支付接口 TRADE_CLOSED（交易关闭）状态触发异步，此时就会收到全额退款的异步通知。而电脑网站支付 TRADE_CLOSED（交易关闭）状态不会触发异步，就不会有全额退款的异步通知。
**注意：**退款的异步信息和正常支付的异步信息的返回信息是不一样的，退款的信息中会有 refund_fee（退款总金额）、gmt_refund（交易退款时间）参数，在正常支付成功的异步信息中是没有的。
具体可以参考该文档说明 [https://opendocs.alipay.com/support/01raw9](https://opendocs.alipay.com/support/01raw9) --- ## 94. 当面付电脑端如何实现语音播报功能，昨天您发的文档写的是app语音播报 播报是收款账号所登录的支付宝客户端进行播报的功能，不支持电脑端。
参考文档：[https://opendocs.alipay.com/support/02hei3](https://opendocs.alipay.com/support/02hei3) --- ## 95. 间联模式下单如何入参openid 间联模式下商户的smid进件之后默认返回就是2088开头的 uid ， 所以使用buyer_id即可。 --- ## 96. 间连支付未资金清算前，可能用于退款吗？ 支付宝侧无相关限制，只要订单状态是trade_success，那就可以发起退款的。
资金的清算都是银联/网联侧主导的，建议咨询银联/网联侧。 --- ## 97. 沙箱测试支付，支付成功后没收到异步通知 无法收到通知的主要原因如下，也可参考正式环境中的异步通知排查说明：[https://opendocs.alipay.com/support/01raw7](https://opendocs.alipay.com/support/01raw7) - 异步通知发送地址错误。 - notify_url 参数位置设置错误。 - 异步地址设置错误。 - 异步地址必须外网可访问。 - 异步地址必须能 post 接收数据。 - 接口默认不触发相关的交易状态数据通知 --- ## 98. 如何指定或禁用支付渠道 如何指定某支付渠道支付（禁用某些支付渠道），如银行卡、信用卡、花呗等：
**使用参数：** - **disable_pay_channels**：禁用渠道，用户禁用指定渠道支付，当有多个渠道时用","分隔。 - **enable_pay_channels**：可用渠道，用户只能在指定渠道范围内支付，当有多个渠道时用","分隔。**注意：**disable_pay_channels 与 enable_pay_channels 互斥；
**固定一种支付渠道**
如果想实现只能使用某一种支付渠道，可使用 enable_pay_channels（可用渠道）去实现控制，传递方式和 disable_pay_channels（禁用渠道）参数类似，也是在 biz_content 内下传递 enable_pay_channels 参数。 渠道参数值可参考[支持可用/禁用支付渠道列表](https://docs.open.alipay.com/common/wifww7)；目前支持此参数控制支付渠道的有App支付、电脑网站支付、手机网站支付等接口。 --- ## 99. 应用如何实现产品绑定 目前在商家平台开通产品后，应用会自动绑定产品，不再需要手动去操作绑定。"产品绑定"菜单已变更为"可调用产品"，可以在[应用后台](https://open.alipay.com/develop/manage)的【可调用产品】一栏查看已绑定的产品。
注意：如果是服务商账号，也无需绑定， 通过开发平台在账号下面新创建一个第三方应用， 在开放平台第三方应用授权页面勾选授权产品后，邀请商家授权即可。 --- ## 100. 调用接口 是根据那个入参判断对接的是那个产品的呢 1. **接口参数**：调用接口时，是根据接口参数中的product_code和biz_scene来判断对接的是哪个产品的。这些参数通常需要按照对应产品文档中接入指南给出的参数示例进行设置，因为它们往往是固定值。 2. **参数来源**：API列表中提供的参数说明是通用场景下的示例，而具体产品的接口参数明细则需要参考接入指南。因此，商户在接入时，应以接入指南中的参数说明为准。 --- ## 101. 如何接入app支付 **产品介绍：APP支付是指商家在商家移动端 App 中集成支付宝 SDK，调起支付宝来完成付款的一种支付产品。适用于在商家移动端 App 内使用支付宝支付功能的场景。该产品在签约完成后，需要技术集成完成后方可使用。**
文档地址： - v2版本：[https://opendocs.alipay.com/open/204/105051?pathHash=b91b9616](https://opendocs.alipay.com/open/204/105051?pathHash=b91b9616) - v3版本：[https://opendocs.alipay.com/open-v3/05vuxe?pathHash=3444d649](https://opendocs.alipay.com/open-v3/05vuxe?pathHash=3444d649) 目前支持手机系统有：iOS（苹果）、Android（安卓）、鸿蒙。
接入文档：[APP支付产品文档](https://opendocs.alipay.com/open/00dn73?pathHash=b91b9616) - 参考文档产品介绍部分了解APP支付产品 - 参考接入准备完成对接开放接口的前置工作 - 参考接入指南开始对接工作tips：示例代码可直接使用，根据业务需要调整入参即可 ### 一、接入前准备： - 创建应用并配置 1. 登录[支付宝开放平台](https://open.alipay.com/develop/manage)，创建应用并提交审核，详情请参见 [如何创建应用](https://opendocs.alipay.com/support/01rau6)。 2. 应用创建完成后，系统会自动跳转到应用详情页面。开发者可以在 **产品绑定** > **绑定产品**，添加 **App 支付**。 3. 生成密钥。详情请参见 [如何生成 RSA2 密钥](https://opendocs.alipay.com/support/01raut)、[如何生成公钥证书](https://opendocs.alipay.com/support/01rauw)、[如何获取支付宝公钥](https://opendocs.alipay.com/support/01rauu)。 - 上线应用商家在绑定产品和配置密钥后，即可将应用提交审核，预计会有一个工作日的审核时间，请耐心等待，详细步骤可参考 [上线应用](https://opendocs.alipay.com/open/200/golive/)。
应用上线后，还需要完成应用开通才能在线上环境（生产环境）使用功能。 - 开通应用上线后，还需要完成开通才能使用 **App 支付**。请在 **商家平台** > [产品中心](https://b.alipay.com/page/product-mall/all-product) 的产品详情页面点击 **立即开通**，填写并提交相关信息。详情可查看 [开通产品](https://opendocs.alipay.com/open/200/105314/)。
开通遇到问题可以咨询商家客服电话：400*****58，或在线商家客服：[客服地址](https://cschannel.alipay.com/newPortal.htm?scene=mysjbzzx)。 - Demo& 服务端 sdk 地址（参考测试使用） - [服务端 SDK 下载地址](https://opendocs.alipay.com/open/54/103419#Alipay%20SDK) - [客户端 demo 下载地址](https://opendocs.alipay.com/open/54/104506) - 产品支付流程说明 - 客户端 Android 集成流程 - 客户端 iOS 集成流程 ### 二、接口集成示例代码 - 收单类服务端接口示例代码 - [App 支付接口（alipay.trade.app.pay）参数说明&请求参数](https://opendocs.alipay.com/open/02e7gq?scene=20) - 辅助类服务端接口示例代码 - [统一收单线下交易查询（alipay.trade.query）参数说明&请求示例](https://opendocs.alipay.com/open/02e7gm) - [统一收单交易退款接口（alipay.trade.refund）参数说明&请求示例](https://opendocs.alipay.com/open/02e7go) - [统一收单交易关闭接口（alipay.trade.close）参数说明&请求示例](https://opendocs.alipay.com/open/02e7gn) - [查询对账单下载地址（alipay.data.dataservice.bill.downloadurl.query）参数说明&请求示例](https://opendocs.alipay.com/open/02e7gr) ### 三、注意事项 - 沙箱客户端集成方式 - 沙箱账号查看可查看 [沙箱账号内容说明](https://openhome.alipay.com/platform/appDaily.htm?tab=info)。 - 沙箱环境测试目前只支持 Android 版，详情参考 [APP 支付沙箱联调指南说明](https://opendocs.alipay.com/open/204/106450/)。 - 常见报错解决方案说明 - 报错 ALIN10146：[点击查看](https://opendocs.alipay.com/support/01rfs4) - 报错 ALIN10070：[点击查看](https://opendocs.alipay.com/support/01rfsd) - 报错 ALI38173：[点击查看](https://opendocs.alipay.com/support/01rfsb) - 报错 ALIN10009：[点击查看](https://opendocs.alipay.com/support/01rfsp) - 更多ali系错误码可参考：[App 支付常见问题说明](https://opendocs.alipay.com/support/01rfs3) - 其他 - 客户端相关集成流程可参考 [客户端 Android 集成流程](https://opendocs.alipay.com/open/204/105296)、[客户端 iOS 集成流程](https://opendocs.alipay.com/open/204/105295/)。 - 证书方法需要修改对应代码，详细可参考 [服务端 SDK](https://opendocs.alipay.com/open/54/103419)，其中的接口类方法需要自行替换成要调用的接口类方法，并且相关的提交方法也会有变更，可参考 [公钥证书提交](https://opendocs.alipay.com/support/01ravh)。 - 如果您已经接入支付宝手机网站支付，可以通过接入我们的SDK将手机网站支付转为 Native 支付。接入过程极其简单，只需拦截手机网站支付的 url，将该 url 转交给 SDK 进行处理；无需接入者解析参数字段，接入者的服务端也无需改造。 - mobile.securitypay.pay 是老版的移动支付接口，使用的是mapi网关密钥处的密钥接入，不再推荐使用。 - 开发者实际调试过程中可以使用 [APP支付工具](https://opensupport.alipay.com/support/diagnostic-tools/b3b501fd-a442-4dee-8b3f-e5f5edcc6d6e) 协助解决报错异常。 --- ## 102. 单品回传接口文档 不同支付接口都能回传单品信息，主要就是看商户实际的支付场景是哪个。alipay.trade.create目前主要是小程序唤起场景中会用到的，alipay.trade.pay是条码支付场景会用到，可以根据实际场景对接不同的接口。
当面付接口文档：[https://opendocs.alipay.com/open/1f1fe18c_alipay.trade.pay?scene=32&pathHash=8934e9fd](https://opendocs.alipay.com/open/1f1fe18c_alipay.trade.pay?scene=32&pathHash=8934e9fd)
支付接口中传入goods_detail商品信息参数。 --- ## 103. 有还信用卡接口吗 暂无还信用卡接口。 --- ## 104. 支付宝支付产品 可以看下这个文档，有各种支付产品的接入指南，商家可以按需接入，文档：[https://opendocs.alipay.com/open/270/105898?pathHash=b3b2b667](https://opendocs.alipay.com/open/270/105898?pathHash=b3b2b667) --- ## 105. 支付宝支付的退款查询字段refund_status 有哪些状态 退款查询接口中，字段refund_status 只有「REFUND_SUCCESS」，
REFUND_SUCCESS：退款成功，分两种情况 - 全额退款情况：trade_status= TRADE_CLOSED，而refund_status=REFUND_SUCCESS - 非全额退款情况：trade_status= TRADE_SUCCESS，而refund_status=REFUND_SUCCESS当退款失败的话，不会返回refund_status 这个参数值 --- ## 106. 支付宝扫码支持hlht格式的二维码吗 支付宝扫码支持hlht格式的二维码。 --- ## 107. 如何使用二维码收款 用户扫码支付，也可理解为商家使用二维码收款，根据不同情况主要分成3类二维码：
1、商家不具有开发能力，可直接获取二维码进行收款：
建议咨询商户客服获取"收钱码"进行收单，该二维码为静态二维码。
商户客服联系方式：商家服务热线：400*****58-1，商家在线服务，可 [点此](https://cschannel.alipay.com/newPortal.htm?scene=mysjbzzx)进入。
2、商家具有开发能力，可通过服务商或自己进行代码集成接口实现生成二维码收款：
（1）线下场景：指用户打开支付宝钱包中的"扫一扫"功能，扫描商家展示在某收银场景下的二维码并进行支付的模式，该二维码为动态二维码。
建议使用统一收单交易预创建（订单码支付） 接口：alipay.trade.precreate
可 [点击](https://opendocs.alipay.com/open/05osux?pathHash=660a1801)进入参考接入步骤流程
（2）线上场景：用户通过支付宝PC端（电脑网站）收银台完成支付，交易款项即时给到商户支付宝账户，该二维码为动态二维码。
建议使用统一收单下单并支付页面（电脑网站支付）接口：alipay.trade.page.pay
可 [点击](https://docs.open.alipay.com/270/105899/)进入参考接入步骤流程
（3）一码多付场景：用户创建页面生成二维码，用户使用支付宝钱包"扫一扫"功能，实现唤起支付，该二维码为商户自己页面生成二维码，静态二维码。
建议使用统一收单交易创建接口结合js+api方式：alipay.trade.create
可[创建订单](https://docs.open.alipay.com/api_1/alipay.trade.create)+[JSAPI唤起收银台支付](https://docs.open.alipay.com/common/105591)参考接入步骤流程。 --- ## 108. 开放平台有针对网商银行支付的介绍吗？ 网商银行支付以及查询网商银行的余额、账单的话，咨询网商银行的客服人员。 --- ## 109. 订单码支付产品开通 文档：[https://opendocs.alipay.com/open/05osux?pathHash=660a1801](https://opendocs.alipay.com/open/05osux?pathHash=660a1801)
订单码支付未开通，需要联系支付宝商家客服开通对应的产品哈，业务问题在线咨询请点击以下链接，咨询客服：[https://b.alipay.com/index2.htm](https://b.alipay.com/index2.htm) 点击右侧小蚂蚁头像"点我提问" 或电话咨询：400-758-5858。 --- ## 110. 如果获取openid 可以参考此产品获取用户的openid：[https://opendocs.alipay.com/open/repo-01480o](https://opendocs.alipay.com/open/repo-01480o) --- ## 111. sub_code":"ACQ.SECONDARY_MERCHANT_NOT_CONFIRMED"这个认为是失败吗？ 1. **错误代码解析**：根据您提供的sub_code："ACQ.SECONDARY_MERCHANT_NOT_CONFIRMED"，这通常表示次级商户未确认，交易因此未能完成。 2. **交易状态确认**：此sub_code表明交易确实因为次级商户未确认而未能成功，可以认为这笔交易是失败的。 3. **原因**：当前商户未认证，请通知商户在支付宝搜索"支付宝商家认证助手"小程序，完成认证后开通交易。 --- ## 112. 同一订单的退款操作时间间隔及接口调取频率限制 1. **时间间隔要求** 同一笔交易的退款至少需要间隔3秒后才能再次发起，需注意退款的有效期，即交易状态为 TRADE_SUCCESS（交易支付成功）时才可进行退款操作。 2. **接口调取频率** 单笔转账接口限制 TPS 为 30，这意味着每秒最多可以调用 30 次接口。对于频繁的退款请求，建议合理安排调用频率，避免超过限制导致调用失败。 --- ## 113. 订单码支付产品介绍 文档：[https://opendocs.alipay.com/open/05osux?pathHash=660a1801](https://opendocs.alipay.com/open/05osux?pathHash=660a1801)
订单码支付是指商家按支付宝的支付协议生成订单二维码，用户使用支付宝 扫一扫 完成付款的一款支付产品。具体接入步骤可参考产品文档的[接入准备](https://opendocs.alipay.com/open/05osuy?pathHash=adc0ece0)和[接入指南](https://opendocs.alipay.com/open/05osuz?pathHash=45b03293)，完成相关配置后，商家系统调用[alipay.trade.precreate（统一收单线下交易预创建接口）](https://opendocs.alipay.com/open/8ad49e4a_alipay.trade.precreate)，获得该订单的二维码串 qr_code，开发者需要利用二维码生成工具获得最终的订单二维码图片。
对接此产品需要使用代码的方式去集成的，要有一定代码开发能力，若没有开发能力的话，建议您可以去找服务商代开发。 --- ## 114. 聚合收款支付的服务商能否通过api给商户生成应用或通过服务商的百宝箱应用区分商户的订单 目前只能协助创建小程序，应用是不支持代创建的，需要区分订单可以通过自定参数 out_trade_no 商家单号去区分。 --- ## 115. 订单关闭后输入密码支付，会提示什么？ 超过支付时间会提示交易超时，用户无法完成支付。 --- ## 116. ACQ.BUYER_BALANCE_NOT_ENOUGH（买家余额不足） **涉及接口** - [alipay.trade.pay](https://opendocs.alipay.com/open/02ekfp?scene=32)（统一收单交易支付接口） - [alipay.trade.page.pay](https://opendocs.alipay.com/open/028r8t?ref=api&scene=22) (统一收单下单并支付页面接口) **错误码含义**：报错 ACQ.BUYER_BALANCE_NOT_ENOUGH（买家余额不足），这表示买家的账户余额不足，无法完成支付。
**代扣状态**：收到此错误码可以认为该笔代扣请求是失败的，因为买家的账户余额不足导致交易无法继续进行。
**解决方案**：建议您在业务逻辑中处理该错误码，提示用户账户余额不足，并引导用户充值或选择其他支付方式。 --- ## 117. 当面付单品回传接口文档 接口文档：[https://opendocs.alipay.com/open/1f1fe18c_alipay.trade.pay?scene=32&pathHash=8934e9fd](https://opendocs.alipay.com/open/1f1fe18c_alipay.trade.pay?scene=32&pathHash=8934e9fd)
支付接口中传入goods_detail商品信息参数 --- ## 118. 支付宝当面付支持指定付款人吗？ 当面付的条码支付接口不需要指定付款方，也无法指定。
支付宝小程序支付支持，小程序的 alipay.trade.create交易创建接口中需要传入买家用户的id，小程序文档说明：[https://opendocs.alipay.com/mini/05x9ku?pathHash=a7b61cca](https://opendocs.alipay.com/mini/05x9ku?pathHash=a7b61cca) --- ## 119. 当面付接口、订单异常 开发者在对接【当面付】支付产品时经常会遇到二维码主扫支付异常、付款码被扫支付异常、二维码生成故障、异步通知发送失败等异常情况，此时商户可以使用工具：[https://opensupport.alipay.com/support/diagnostic-tools/d888299b-5641-4a12-9f2a-599608167285](https://opensupport.alipay.com/support/diagnostic-tools/d888299b-5641-4a12-9f2a-599608167285) 自行发起诊断。
输入请求参数、环境和请求时间后，点击"开始诊断"可定位接口异常具体原因，并提供相应的解决方案。 --- ## 120. ACQ.SECONDARY_MERCHANT_BANK_PUNISH_INDIRECT 商户收款功能已暂停，请联系合作方进行处理。一般是request_org_pid对应的机构被限制交易，可以让机构联系95188-1咨询处理。 --- ## 121. 支付失败，当前收款账户不在设置的收款账户列表中，或卖家不在设置的收款账户列表之中。 ### 错误描述 支付失败，当前收款账户不在设置的收款账户列表中，或卖家不在设置的收款账户列表之中。 ### 问题原因 seller_id中的收款账号不支持。 ### 涉及接口 [alipay.trade.pay(统一收单交易支付接口)](https://opendocs.alipay.com/open/02ekfp?ref=api&scene=32) ### 解决方案 seller_id不在请求商户设置的**收款账户限制集**中，目前默认只支持配置签约商户账户PID信息（自调用为appid对应的PID，三方调用则为授权商户的PID）。建议无需传递seller_id参数，此时资金默认收款到调用接口的应用appid对应的签约商户账户中。 如需使用seller_id指定收款账户，那么需要联系支付宝BD协助商户配置**收款限制集**。 --- ## 122. RSA2普通公钥 方式支付的订单 可以通过公钥证书方式退款吗 RSA2普通公钥方式支付的订单可以通过公钥证书方式退款，没有限制，同一个账号的应用操作就行。 --- ## 123. 下单账号与支付账号不一致，请核实后再支付 报错： 下单账号与支付账号不一致，请核实后再支付
原因：通常是因为账号 A 创建订单后，账号 B 使用相同请求字符串进行请求支付
注意：同一用户下存在多个账号，一个账号请求创建订单后，切换成另外一个账号使用相同数据重新请求支付也会导致该问题。如果更换账号，需要换个外部单号下单 --- ## 124. 用户支付支持什么资金渠道 **支持途径** 订单交易收款支持通过支付宝余额、余额宝、花呗等多种途径进行扣款。 --- ## 125. 如何对接1.0的退款接口 目前即时到账有密退款接口的能力已经在下线了，如果商户期望退款的话，可以通过商家后台，或者调用2.0的退款接口去发起退款；
注意：由于2.0的接口在集成时需要在开放平台去创建应用appid，并配置密钥。2.0的接口是以appid维度去发起请求的，和1.0的不太一样，可以参考：[https://opendocs.alipay.com/open/3aea9b48_alipay.trade.refund?scene=common&pathHash=4de421df](https://opendocs.alipay.com/open/3aea9b48_alipay.trade.refund?scene=common&pathHash=4de421df) --- ## 126. 当面付和订单码支付都支持商家反扫吗？ 只有当面付产品支持商家扫用户的付款条码去完成支付，订单码支付，是商家生成支付二维码，然后用户主动去扫码完成支付，无法开发成反扫。当面付的付款码集成文档说明参考：[https://opendocs.alipay.com/open/194/106039?pathHash=5b8cf9e6](https://opendocs.alipay.com/open/194/106039?pathHash=5b8cf9e6) --- ## 127. 下单接口中能传递一些自定义的值 在资金流水 的 备注字段中显示吗？ 接口中可以传入备注，下载的账单中会有备注列。 --- ## 128. 订单超过15天自动关闭，这个可以申请延长吗 您好，无法延长，这是产品层的限制。如果订单关闭后，期望用户再次支付的话，可以换个单号重新请求下支付接口下单。 --- ## 129. 国内支付宝的收单二维码用国际支付宝扫了能付款吗 国内的接口支持国内的支付宝来付款的，国际账户，这个需要接入国际接口去操作。 --- ## 130. 订单码支付支持沙箱调试吗 您好，订单码支付不支持沙箱调试，订单码支付文档中「沙箱调试说明」可以忽略。更多沙箱支持的产品可以登录沙箱后台 [https://open.alipay.com/develop/sandbox/app](https://open.alipay.com/develop/sandbox/app) 查看已支持的产品列表。 --- ## 131. 间连如何查询服务商名下smid信息 后台查询流程：间连服务商需要在服务商后台-服务商运营-我的商家页面选择查询间连商家；
接口查询：需要银联网联侧调用接口查询，可以咨询银联网联侧提供相关入口；ant.merchant.expand.indirect.query这边可调用间连商户分级信息查询接口 查询下smid信息 --- ## 132. 条码支付和扫码支付的区别是什么？ 1、条码支付和扫码支付在接口调用上是不同的，完全是两个不同的接口。
2、两者在使用上也不同 - 扫码付 - 静态码：是固定的二维码，用户自己扫码输入金额，和接口无关，可拨打4007585858商户客服申请。 - 动态码：是由用户扫商户的二维码「对应订单码支付」，调用支付接口：[https://opendocs.alipay.com/open/05osuz?pathHash=fa169dd3](https://opendocs.alipay.com/open/05osuz?pathHash=fa169dd3) - 条码付 - 是由商户通过扫码枪，扫用户展示的付款码「对应当面付」。更多详见 [当面付文档](https://opendocs.alipay.com/open/194/106039?pathHash=5b8cf9e6&ref=api)、[订单码支付文档](https://opendocs.alipay.com/open/repo-020ex6) --- ## 133. 回调接口返回什么格式的数据 异步通知说明：[https://opendocs.alipay.com/open/00dn78?pathHash=fef00e6d](https://opendocs.alipay.com/open/00dn78?pathHash=fef00e6d) --- ## 134. 订单同步返回"当前商户未认证，请通知商户在支付宝搜索"支付宝商家认证助手" 此报错说明订单已经失败，在间连场景新入驻的二级商户都需要完成商家认证后才可以交易，可以参考文档：[https://opendocs.alipay.com/open/03sqz4](https://opendocs.alipay.com/open/03sqz4) 进行认证。 --- ## 135. 订单码支付二维码有效期是多久 订单码支付接口，即 alipay.trade.precreate (统一收单线下交易预创建)，在接口调用请求后生成 qr_code（二维码串），这个二维码串由商户通过二维码生成工具等生成二维码。
二维码有效期：默认 2 小时（计算时间是生成二维码链接开始计算），二维码有效期说明参考：[https://opendocs.alipay.com/support/01rfnn](https://opendocs.alipay.com/support/01rfnn) --- ## 136. 支付请求url是http还是https 1. **支付请求URL**：在生产环境中，支付请求的URL应当是HTTPS，这是为了保证数据传输的安全性，防止敏感信息被截取。 2. **安全性要求**：无论是手机网站支付还是电脑网站支付，使用HTTPS协议是行业标准，能够有效保护用户的支付安全和个人信息安全。 --- ## 137. 退款接口异常或订单退款失败 开发者在对接"交易退款接口"（alipay.trade.refund）时经常会遇到"参数无效"、"退款失败"、"系统错误"、"请求信息不一致"、"交易结算异常"等错误信息，此时商户可以使用工具：[https://opensupport.alipay.com/support/diagnostic-tools/ed086f6c-a4e1-4fa0-b9dd-96c739054458](https://opensupport.alipay.com/support/diagnostic-tools/ed086f6c-a4e1-4fa0-b9dd-96c739054458) 自行发起诊断。
输入关键字查询商户进行退款时的具体错误信息，针对系统异常、卖家余额不足、交易结算异常等不明确错误返回详细错误信息和解决方案。 --- ## 138. 支付有单笔限额吗？最大是多少呢？ 支付金额 total_amount 必选 price(9) 【描述】订单总金额。 单位为元，精确到小数点后两位，取值范围：[0.01,100000000] --- ## 139. 支付接口收单是否实时到账 是的，用户付款成功，交易资金是实时到商户账户。
如对交易订单有疑问，请到[商家服务中心](https://b.alipay.com/index2.htm)在线咨询或拨打商家服务热线4007585858咨询，服务时间为：8:00-24:00。 --- ## 140. alipay.trade.refund(统一收单交易退款接口) 接口返回的trade_no 与 支付接口返回的trade_no 是相同的值吗 需要退款哪笔订单，接口中的out_trade_no就传支付下单接口中对应的外部单号，trade_no 是交易创建成功的支付宝交易号。
alipay.trade.refund(统一收单交易退款接口) 接口返回的trade_no 与 支付接口返回的trade_no 是相同的。 --- ## 141. 当面付产品介绍&接入流程 当面付是指商家识别用户付款介质（如：条形码、二维码、NFC等）收款或用户识别商家收款介质付款的一种支付产品，主要适用于线下场所面对面收银的场景，例如：便利店、商超综合体、餐饮、医院、学校、电影院、旅游景区等具有明确经营地址的实体场所。
商家使用扫码枪或其它扫码机具扫描用户出示的付款码，来实现收款。
当面付接入流程详见：[https://opendocs.alipay.com/open/194/105072?pathHash=45357796](https://opendocs.alipay.com/open/194/105072?pathHash=45357796) --- ## 142. 支付宝实名信息验证 文档：[https://opendocs.alipay.com/open/01bny6](https://opendocs.alipay.com/open/01bny6)
支付宝实名信息验证 功能，可以帮助商家验证在应用内验证采集到的用户信息与支付宝实名认证信息是否匹配，可验证的内容包括：姓名（必选）、证件号（必选）、手机号、支付宝账号。 --- ## 143. 订单提示超时关闭，是如何导致的？ 有异步通知吗？ 订单提示超时关闭，主要原因就是买家未付款导致的交易关闭。
如果遇到支付订单失败或者超时，支付宝将会将此订单做失败处理，此时需要先调用对应的查询接口，然后根据情况是否重新走创建，支付流程。
订单未创建的都没异步通知，如果订单创建超时关闭了，APP 支付、手机网站支付会触发异步通知，其他产品默认不会有异步通知。交易是否创建可以参考[交易状态说明](https://opendocs.alipay.com/support/01raw9)。 --- ## 144. ACQ.TRADE_HAS_FINISHED（交易已结束） ### **报错原因** 订单的交易状态为 TRADE_FINISHED 不支持进行退款操作。 ### **涉及接口** [alipay.trade.refund](https://opendocs.alipay.com/open/02ekfs?ref=api)（统一收单交易退款接口） ### **排查方案** 该交易已完结（已超过退款期限），不允许进行退款（即使重试也无法成功），建议联系买家进行线下退款处理。 --- ## 145. 交易查询接口返回的buyer_pay_amount为0 可以在查询接口入参的时候加上query_options= fund_bill_list，加上后再观察下出参。 --- ## 146. 用户支付时怎么限制卡bin 用户支付时目前无法限制卡bin。 --- ## 147. 付款码为什么失效？ 可能原因有：1. 支付宝客户端版本较老，码可以被截屏；2. 被其他人拍照后拿照片付款；3. 手机卡顿导致码没刷新过来；4. 其他未知原因。解决办法：重新打开客户端，进入收款码即可。 --- ## 148. 一码多付可以给不同收款方生成不同的二维码吗？ 支付宝没有提供生成一码多付的二维码功能，生成二维码的功能需要开发者自行生成，支付宝只接受支付下单的请求，根据请求去处理支付业务。如果是服务商角色，可以根据不同的商家生成不同的码，从而区分收款方， --- ## 149. 下单接口的subject特殊字符有什么？ 允许的字符通常包括字母（A-Z, a-z）、数字（0-9）、空格以及一些常见的符号如逗号（,）、句号（.）、破折号（-）、下划线（_）、中文等。
不允许的特殊字符可能包括但不限于：! @ # $ % ^ & * ( ) + = { } [ ] \ --- ## 150. 扫码支付有哪些支付方式可以直接返回一个img 格式的图片的URL 么 目前并没有支付接口返回的是这种信息。 --- ## 151. 当面付接口支付金额是否可以为0 支付接口金额单位为元，精确到小数点后两位，取值范围[0.01,100000000]，不可为0。 --- ## 152. 如何实现根据支付宝交易号查询收支金额 商家可以调用交易查询接口，就能查询到支付的金额信息，交易查询接口文档：[https://opendocs.alipay.com/mini/83b6c9a9_alipay.trade.query?scene=common&pathHash=354e8be3](https://opendocs.alipay.com/mini/83b6c9a9_alipay.trade.query?scene=common&pathHash=354e8be3) --- ## 153. ACQ.PAYMENT_REQUEST_HAS_RISK（支付有风险） ### **问题原因** 交易存在风险。 ### **涉及接口** [alipay.trade.pay](https://opendocs.alipay.com/open/02ekfp?ref=api&scene=32) (统一收单交易支付接口)
[alipay.trade.wap.pay](https://opendocs.alipay.com/open/02ivbs?ref=api&scene=21) (手机网站支付接口2.0)
[alipay.trade.page.pay](https://opendocs.alipay.com/open/028r8t?ref=api&scene=22) (统一收单下单并支付页面接口) ### **解决方案** 1、让付款用户切换成其他支付方式。
2、可联系商户客服确认付款账号是否存在风险，商户客服联系方式为 400*****58 。 --- ## 154. 如何获取返佣 您好，支付接口支持返佣条件如下，以下条件缺一都无法实现返佣：
1、需签约返佣协议，签约相关问题请到[商家服务中心](https://b.alipay.com/index2.htm)在线咨询或拨打商家服务热线400*****58咨询，服务时间为：8:00-24:00。
2、需要在支付接口的extend_params参数中设置sys_service_provider_id返佣参数 ，参数值为签约返佣协议的pid。
3、若获取返佣需通过ISV（服务商）代商户调用接口，在接口携带app_auth_token，详见[第三方应用授权](https://opendocs.alipay.com/isv/10467/xldcyq)。
注：
1、APP支付、电脑网站支付、手机网站支付目前暂不支持返佣；
2、如果要实现蜻蜓设备获取返佣详见[蜻蜓设备如何获取返佣](https://opensupport.alipay.com/support/FAQ/64e79d0d-409d-448b-9c24-7d80f83fc4f0)。 --- ## 155. 如何拿到用户支付失败的原因，可以在异步支付回调里面拿到吗？ 拿不到用户支付失败的原因，支付失败不会给商户发送异步通知。商户可以根据扣款接口同步返回的信息去判断，目前没有专门查询支付失败原因的接口。 --- ## 156. 交易可以在后台进行退款吗 交易可以在商家平台发起退款。平台地址：[https://b.alipay.com/page/home](https://b.alipay.com/page/home) - 直连交易：收款方可以登录 商家平台--对账中心--交易订单，找到对应交易发起退款 - 直付通交易：平台商可以登录 商家平台--对账中心--交易订单，找到对应交易发起退款；不支持二级商户自行登录平台发起退款。 --- ## 157. 如何在app客户端生成二维码进行扫码支付 在app客户端生成二维码，可通过当面付扫码接口实现。
在服务端调用接口生成qr_code（码串值），将该qr_code（码串值）放在客户端生成二维码显示。
注：他人扫该二维码，可直接使用支付宝钱包的扫一扫功能。
自己账户进行内扫该二维码，需在客户端集成含有内扫功能的apk，进行长按识别二维码唤起支付宝钱包支付。 --- ## 158. 退款没有立即到账 退款资金一般会按原路返回。但若是通过银行卡支付，因银行结算系统限制，退款时需将该笔资金冻结在支付宝账号内，待银行结算时才能退款到银行卡，通常需要2小时。 --- ## 159. 产品问题咨询 如果您需要咨询产品问题，辛苦进行详细描述，例如：对接「xxx」产品，「xxx」功能是怎样的，，辛苦尽量详细描述问题，以便协助您进行解决。 --- ## 160. 为什么支付宝回调的内容是一年前的订单 您好，如果支付宝回调的内容是一年前的订单，这可能是由于交易状态为TRADE_FINISHED（交易完结）的通知。根据支付宝的规定，支付成功默认12个月后，订单就会变成不可退款状态。因此，支付宝侧会给您发送TRADE_FINISHED的异步通知。您可以查看交易状态说明文档（[https://opendocs.alipay.com/support/01raw9](https://opendocs.alipay.com/support/01raw9)）以获取更多信息。 --- ## 161. 支付宝退款时遇到com.aliyun.tea.TeaUnretryableException错误，如何排查和解决 1. 确认退款接口请求到[https://openapi.alipay.com/gateway.do](https://openapi.alipay.com/gateway.do)。 2. 如果外网限制导致问题，检查网络配置，确保能够访问openapi.alipay.com。 3. 如果还有问题，可以提供接口调用日志，联系技术支持同学排查。 --- ## 162. 经营码收的款不能通过接口alipay.trade.refund来退款，应该如何解决 收钱码收的款不能通过接口退款，可以登录商家平台：[https://b.alipay.com/page/portal/home](https://b.alipay.com/page/portal/home) 进行退款操作。 --- ## 163. 支付宝服务商的当面付没有返佣账单，申述说"未传参"，需要传什么参数 传参示例："extend_params":{"sys_service_provider_id":"2088开头的返佣pid"}。 --- ## 164. 如何解决应用公钥证书不存在的问题 可能的原因
1.应用签名方式错误。
2.应用公钥证书路径设置错误。
3.应用公钥证书引用错误。
4.自签名未设置 app_cert_sn。
5. 参考官方文档进行排查：[https://opendocs.alipay.com/support/01ravt](https://opendocs.alipay.com/support/01ravt) ---