# 小程序担保支付接入指南
更新时间：2024-09-26 14:58:12
担保支付交易提供了统一的、安全的平台交易体验，监控全链路的交易流程，保证了小程序开发者能够在小程序内完成支付闭环。
# 一、接入流程
# 1.申请支付权限
进入开发者平台-交易管理-支付管理 (opens new window)，填写商户名称、业务场景描述，勾选开通的支付方式、支付类型、经营类目，进行开通申请，审核周期为3个工作日内。
# 2.支付账户开通
# 2.1 资质信息录入
权限开通申请通过后可进入支付开通界面，点击立即开通即跳转至支付中台，按要求完成营业证件信息及法人身份信息的录入。
# 2.2 绑定结算账户
录入信息后可操作绑定对应的结算账户，提供结算账户信息与管理员信息/店铺信息。此申请由微信、支付宝进行审核，周期为2-3个工作日，可在支付开通界面查看申请状态。页面展示为「入驻完成」代表账户开通成功。
账户开通成功后，用户可在小程序内通过微信/支付宝进行支付。
详细的申请流程和内容填写，请参考《小程序担保支付接入指南》 (opens new window)文档。
# 3.开发指南
# 3.1 接入效果
平台提供了以上两种交互方式，接入流程略有差异：
有收银台版本：调用支付API后将唤起“快手收银台”，用户选择支付方式后跳转第三方平台支付，支付后返回小程序。
a. 前端开发：接入ks.pay，具体API使用方式详见ks.pay (opens new window)
b. 服务端开发：预下单 (opens new window)
# 二、常见问题
# 1.小程序申请支付权限
| 页面示意 | 操作步骤 |
 | 填写商户名称、业务场景描述、经营类目，勾选开通的支付方式、支付类型，进行开通申请；
|
# 2.支付账户开通
注意，账户开通的申请、信息完善、流程查看只能是同一用户。
# 2.1 资质信息录入
| 页面示意 | 操作步骤 | ||||||||||
| 点击「立即开通」，进入资质填写页面； 点击「填写资质信息」，进入安全验证页面，在该页面进行手机验证码及快手实名验证 （前提：该快手id在快手设置内已绑定手机号并完成实名认证） | ||||||||||
 | 验证通过后，进入选择商户页面，普通小程序商户仅支持选择「企业」；
| ||||||||||
 | 资质填写页面
| ||||||||||
  | 资质信息提交成功后，点击「去绑定结算账户」，分别选择微信&支付宝进行收款账户绑定 |
# 2.2 绑定结算账户-支付宝
| 页面示意 | 信息填写 |
| 主体信息 若发现主体信息有误，可点击编辑直接进行修改； 结算账户信息 需绑定与商户名称一致的对公支付宝账号，一般为邮箱或手机号（注意，不是填写银行卡号）；
店铺信息 经营范围根据实际经营内容进行选择即可 
|
# 2.3 绑定结算账户-微信
| 页面示意 | 信息填写 | ||||||
结算账户信息填写   | 主体信息 若发现主体信息有误，可点击编辑直接进行修改； 结算账户信息 需绑定与商户名称一致的对公账户； 管理员信息 管理员需完成后续扫码签约流程，请确保所填信息与微信实名信息一致。 请注意，一旦提交，不支持修改管理员信息
| ||||||
扫码签约   | 点击「去扫码签约」： 若管理员为法人： 若管理员非法人： 确定是否已汇款成功2小时以上； 核对收款户名、收款卡号是否正确：收款户名为「财付通支付科技有限公司」； 核对汇款金额是否正确； 核对付款账户是否正确：需要使用企业对公账户进行汇款验证； 注意： 资质信息审核、扫码签约、对公账户验证，三个流程为并行流程。需要三者均通过审核，最终才能入驻成功。 若已经扫码验证后，界面仍然提示「待扫码签约」，不必重复扫码，等待微信审核完成即可。 |
# 2.4 查询开通进度
| 页面示意 | 操作步骤 |
 | 所有的审核流程均在支付宝和微信侧，如有查询进度或者询问失败原因的需要，请复制右上角「进件申请单号」，前往微信/支付宝平台询问； 支付宝信息提交后，预计会在10min内返回审核结果： 审核通过，后续可以使用支付宝进行收款，页面上将展示「二级商户号」； 审核未通过，根据返回的提示信息进行修改，修改建议参考→账户开通失败常见原因 微信信息提交后，预计会在3-7天内返回审核结果： 审核通过，后续可以使用微信进行收款，页面上将展示「二级商户号」； 审核未通过，根据返回的提示信息进行修改，修改建议参考→账户开通失败常见原因 失败原因可点击红色感叹号查看，根据原因直接修改重新提交即可；
|
# 三、支付常见问题Q&A
# 3.1 账户开通失败常见原因及解决方案
根据账户开通页面上返回的“失败结果”，查询右侧对应的“解决方案”。
| 渠道 | 失败结果 | 解决方案 |
| 微信 | 商户名称取值有误，若选择对公账户时，开户名称必须与营业执照上的“商户名称”一致 | 企业账户必须选择对公账户，银行卡开户名称需要与营业执照名称一致 |
| 公司名称与营业执照注册编号不匹配，请核对修改 | 用户营业执照名称/统一社会信用代码/法人等信息与企信网（http://ah.gsxt.gov.cn/index.html）不一致，可修改后重新提交 | |
| 暂未查询到改营业执照注册号，请检查营业执照注册号是否正确 | ||
| 申请未能通过公安网校验，请检查身份证信息正确性 | 大多数情况是身份证号填写错误，核实身份证号后重新进行提交 | |
| 商户存在资质风险，暂不支持入驻 | 如果商户入驻报此错误，商户无法使用该证件在微信侧进行入驻，如需经营，请更换主体操作 | |
申请返回结果“超期失败”  | 原因：申请发起间隔周期太久，需删除历史进件申请记录 解决方案： 需提供以下信息发送至邮箱gh_xiaochengxu@kuaishou.com，删除周期约为2～4个工作日。 邮件标题：进件超期失效，申请删除
| |
| 申请商户号数量已超上限，如有需要，可申请注销名下其他商户号后，再尝试入驻 | 到微信侧注销不使用的二级商户号 | |
支付宝
| 签约失败 商户状态[清退]不满足签约要求 存在风险  | 商户在支付宝侧有违规被清退
|
支付宝账号不存在  | 需要核实支付宝账号 注意：有的人是手机号就是支付宝账号，有的人邮箱号是支付宝账号。需要核实是不是将手机号默认为支付宝账号，但实际支付宝账号是邮箱账号 | |
| 支付宝账户与商户名不一致 | 需要绑定企业对公支付宝 | |
| 签约失败 | 可能原因：
解决方案： 开通余额支付功能、修改支付宝别名 | |
| 公安网校验失败 | 检查法人身份证信息填写是否正确 | |
| 工商网信息匹配失败 | 可登录http://www.gsxt.gov.cn/index.html，根据查询的信息与小程序所填写信息进行对比 |
# 3.2 账户开通
Q1: 开通账户的用户是否需要是小程序的管理员？
A：不要求，只要是小程序的项目成员即可。
注意1：平台目前会绑定一个用户完成支付账户开通的全流程。 目前在绑定后暂不支持换绑，故建议该用户为公司法人or小程序管理员。
注意2：开通用户只会负责完成账户开通流程。之后的提现操作仍需管理员快手号扫码进行身份验证。
Q2: 支持开通支持的账户类型？开通账户企业是否要求和小程序的主体保持一致？对银行卡号有什么限制？
A：平台目前仅支持企业类型开通；不要求账户开通的企业信息和小程序的主体信息保持一致；结算账户绑定的银行卡号必须为企业的对公账户。
Q3: 微信支付账户开通成功，但用户在支付时支付失败，错误提示“卖家未授权开通微信收款能力，请切换其他支付方式”
A：选择微信支付时，微信对二级商户有管理要求，如果商户长时间无收款等经营动作/营业执照注销，会被微信侧关闭商户号权限。
解决办法：请商户登陆商户平台（https://pay.weixin.qq.com (opens new window)）或微信小程序“微信支付商家助手-风险处理”进行处理。
参考：商户违约记录查询与申诉指引（移动端）https://kf.qq.com/faq/190523Mb6VRJ190523RV363E.html (opens new window).
Q4：为什么账户开通失败，提示“工商信息不匹配”？
A：可登录http://www.gsxt.gov.cn/index.html (opens new window)，根据查询的信息与小程序所填写信息进行对比。
# 3.3 结算
Q1：平台的结算规则是什么，该如何操作？
A：自动结算：参考自动结算接入说明 (opens new window)，
手动发起结算：参考结算接口 (opens new window)
Q2：发起结算时提示"当前未到可结算时间"怎么解决？
A：结算限制订单履约完成，结算周期为订单到达核销状态满3天后可发起结算。
注意：订单核销状态可通过订单接口 (opens new window)进行同步。
Q3：最长结算周期是多久？
A：平台支持最长分账周期为360天。订单如果在支付后 360 天后仍未进行分账，平台则会自动分配全部货款给卖家。
Q4：开发者平台是否支持下载结算账单？
A：开发者平台/权限管理/支付->支付结算->选择具体的账户（微信or支付宝）查看明细->导出。也可以先通过接口查询：开发者文档-结算账单接口 (opens new window)。
# 3.4 退款
Q1：怎么退款？
A：退款操作详见开发者文档-退款操作说明 (opens new window)。
Q2：发起退款时，退款资金从哪个账户退回？
A：结算前：从商户的担保账户扣除；
结算后，先从“未提现余额”扣除，若“未提现余额”余额不足，则会从保证金余额退款。若保证金余额也不足，则会退款失败。
Q3：为什么退款失败了？
A：退款失败大概率可能原因：发起退款操作时账户余额不足。
注意：账户余额足够后需要换单号重新发起退款。
Q4：发起退款，手续费（平台服务费）是否会退回？
A：平台在结算时收取服务费。若结算前发起退款，无“退回手续费”一说。
若结算后发起退款：服务费不会回退，退款金额为原订单金额，非原订单金额*费率。
例：假设订单交易金额100元，平台费率2%：
结算前退款：退回100；结算后退款：结算时扣除服务费2元入账98元，若退款则需退100元。
Q5：平台手续费什么时候扣除？以及扣除规则？
A：统一结算时扣除。具体规则可查看开发者文档-手续费扣除说明 (opens new window)。
# 3.5 其他
Q1：支付订单页的收款方是什么？
A：使用支付宝支付，展示的是开发者“账户开通”时设置的二级商户名；使用微信支付，展示的是快手收款方“快手小程序平台商户”，eg：
注意：这里的收款方不会影响交易金额的流入，交易完成时金额都会打入开发者的担保账户。
Q2：如何查看支付宝和微信的商户号？
A：开发者在支付账户开通后，会在微信或者支付宝生成对应的商户号，具体的查看方法为：
微信：https://kf.qq.com/faq/200729EZ7fEj200729aumYR7.html (opens new window)；
支付宝：使用支付宝账户开通时填写的支付宝账号登录支付宝商家中心，可以在【商户信息】里查看https://business.alipay.com/user/store-management/infomanage (opens new window)。
Q3：“未入账”和“已入账”分别对应订单的什么状态？
A：用户完成订单交易后，平台会在对应的账户下生成一条订单记录，入账状态为“未入账”。、
当开发者成功结算后，订单的入账状态更新为“已入账”，未提现余额实时动态更新，次日更新“昨日结算”金额。
Q4：目前支持虚拟支付吗？
A：安卓可正常支付；ios暂不支持，包括但不限于付费购买虚拟内容、付费解锁优质服务、含付费和引导付费等暗示性字段，详见审核规范 (opens new window)。
Q5: 为什么已经是小程序的项目成员了，在平台菜单栏中找不到“支付”表单？
A：请检查项目成员是否有“数据分析者”权限，支付能力的查看和操作会要求具备该权限。
Q6：支付域名配置错误？
A：可以检查是否格式错误：不需要配置url；只支持英文大小写字母、数字及符号“ - ”、“.”。