> ## Documentation Index
> Fetch the complete documentation index at: https://jinshuju-20a27453.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 支付宝直连商户号配置指南

> 「支付宝直连商户」收款是金数据表单的在线收款功能，通过集成支付宝商家服务，实现表单的自动化收款。支持手机网站支付和电脑网站支付两种方式，让填表人可以便捷完成在线支付。

**核心能力**：

* **多端支付**：支持手机端和电脑端支付；

* **即时到账**：款项实时到达「支付宝商家账户」；

* **花呗支持**：开通花呗收款后，用户可使用花呗付款；

***

## 一、开通支付宝商家服务

### **前置条件**：

* 拥有支付宝账号；

* 准备营业执照等认证资料；

* 了解支付宝商家服务规则。

### 步骤一：开始创建应用

1. 登录[支付宝开放平台；](https://open.alipay.com/)

2. 点击「控制台」→「我的应用」→「网页&移动应用」；

3. 点击「创建应用」按钮。

![小程序|支付宝|支付宝开放平台控制台首页中间为我的应用区可创建应用支持「小程序」插件模板生](https://help-assets.jinshuju.net/assets/file/9858/1.png)

### 步骤二：填写应用基础信息

* **应用名称**：按照业务需求填写；

* **应用图标**：上传符合规范的图标；

* **应用类型**：必须选择「网页应用」；

* 点击「确认创建」。

![PC|支付宝收款|支付宝开放平台创建应用页面，可填写应用名称不超过32字上传应用图标32](https://help-assets.jinshuju.net/assets/file/9859/2.png)

### 步骤三：添加应用功能

> 📘 **参考文档**：点击查看如何申请[手机网站支付](https://b.alipay.com/page/product-mall/product-detail/I1080300001000041949)、[电脑网站支付。](https://b.alipay.com/page/product-mall/product-detail/I1080300001000041203)

1. 进入「控制台」→「我的应用」→「网页&移动应用」；

2. 选择已创建的应用；

3. 点击「能力列表」→「添加能力」；

4. **必须添加**：

   * 手机网站支付；

   * 电脑网站支付。

![移动端|支付宝|支付宝开放平台应用信息概览页面完成支付宝支付配置](https://help-assets.jinshuju.net/assets/file/9861/3.png)

### 步骤四：获得公钥、私钥、CSR

**密钥生成步骤**：

1. **下载密钥工具**

   * 下载支付宝开放平台开发助手；

   * 安装并打开工具。

![PC|支付宝|支付宝开放平台加签管理页面步骤1为加签内容配置可选择加签模式公钥证书或公](https://help-assets.jinshuju.net/assets/file/9904/image.png)

2. **生成密钥对**

   * 使用一键生成密钥功能；

   * 生成 RSA 密钥对（应用公钥、应用私钥）；

   * 生成公钥证书申请 CSR 文件。

3. **保存密钥文件**

   | 文件类型 | 文件名示例 | 用途 |
   | - | - | - |
   | **应用公钥** | [xxx.alipay.com](http://xxx.alipay.com)\_公钥.txt | 配置加签方式 |
   | **应用私钥** | [xxx.alipay.com](http://xxx.alipay.com)\_私钥.txt | 金数据配置使用 |
   | **CSR 文件** | xxx.csr | 证书申请使用 |

> ⚠️ **重要**：应用私钥必须妥善保存，后续配置时需要使用

### 步骤五：配置接口加签并获取支付宝公钥

**配置步骤**：

1. 进入「控制台」→「我的应用」→「网页&移动应用」；

2. 选择已创建的应用→「开发信息」；

3. 配置接口加签方式：

   * **模式选择**：公钥；

   * **粘贴内容**：将「[xxx.alipay.com](http://xxx.alipay.com)\_公钥.txt」内容粘贴；

   * 点击「保存设置」。

4. 保存后，复制显示的「支付宝公钥」。

![PC|支付宝|支付宝开放平台接口加签方式页面完成支付宝支付配置](https://help-assets.jinshuju.net/assets/file/15086/%E6%89%93%E7%A0%81.png)

> ⚠️ **重要**：支付宝公钥必须保存，在金数据配置时使用。

***

## 二、金数据绑定支付宝商户号

### 1）创建支付宝收款方式

**操作路径**：

1. 登录金数据网页版；

2. 点击右上角「系统设置」；

3. 选择「第三方服务」→「支付宝」；

4. 点击「添加支付宝收款方式」。

### 2）填写配置信息

**配置参数说明**：

| 配置项 | 说明 | 获取方式 |
| - | - | - |
| **支付宝邮箱** | 支付宝登录邮箱 | 使用注册支付宝的邮箱 |
| **支付宝应用 AppID** | 应用唯一标识 | 支付宝开放平台→控制台→我的应用→复制 AppID |
| **支付宝应用私钥** | RSA 私钥 | 粘贴之前保存的 「[xxx.alipay.com](http://xxx.alipay.com)\_私钥.txt」内容 |
| **支付宝公钥** | 支付宝平台公钥 | 使用第一部分第 5 步获得的支付宝公钥 |

> ⚠️ **版本说明**： \*\*\*\*2021 年 6 月 28 日前\*\*添加的支付宝收款方式：
>
> * 正在使用的配置继续有效，不受影响；
>
> * 新增配置需使用新的校验方式。 \*\*\*\*2021 年 6 月 28 日后\*\*添加的支付宝收款方式：
>
> * 必须使用新的校验方式：AppID + 支付宝公钥 + 应用私钥；
>
> * 不再支持 MD5 密钥方式。

***

## 三、开启表单支付宝支付

**配置步骤**：

1. **添加商品字段**

   * 进入表单编辑页面；

   * 添加「商品」字段。

2. **选择收款方式**

   * 在商品字段右侧设置；

   * 选择已配置的支付宝商户号。

<img src="https://mintcdn.com/jinshuju-20a27453/5Ys1g6_4sNymP1E5/next/attachments/g2WACUoMoprmSe5JrAn5YjxV.png?fit=max&auto=format&n=5Ys1g6_4sNymP1E5&q=85&s=27553a46a48fee32882a6d541d466aa2" alt="移动端|支付宝收款|表单收款渠道配置弹窗，用户可为商品字段绑定收款渠道实现在线收款如报名费" width="1640" height="1000" data-path="next/attachments/g2WACUoMoprmSe5JrAn5YjxV.png" />

3. **保存并发布**

   * 保存表单设置；

   * 发布表单。

**预期结果**：表单可以正常通过支付宝收款。

***

## 表单配置「支付宝直连商户号」收款常见问题

### Q1：支付时提示「调试错误，请回到请求来源地」

**答** ：手机支付时出现调试错误提示；**解决方案**：

1. 登录支付宝产品中心；

2. 检查「手机网站支付」是否成功开通；

3. 确认支付产品状态为「已生效」。

### Q2：微信中无法使用支付宝支付

**答**：在微信内打开表单无法调起支付宝；由于支付平台之间的竞争关系，微信限制了支付宝支付；**解决方案**：

* 引导用户复制链接到浏览器打开；

* 使用手机浏览器直接访问表单。

### Q3：提示「该商家当前单笔收款有额度限制」

**答**：支付时提示单笔收款额度限制；**解决方案**：

1. 登录支付宝商家平台；

2. 进入「产品中心」；

3. 补全商家信息；

4. 申请提升额度。

### Q4：自己无法给自己付款

**答**：商家账号无法支付自己的表单，支付宝平台限制，商家不能向自己付款；**解决方案**：使用其他支付宝账号测试。

### Q5：二维码只能被扫一次

**答**：电脑网页支付的二维码只能被一个账户扫描，支付宝安全机制，防止重复支付；**解决方案**：

* 每个用户需要生成独立的支付二维码；

* 刷新页面重新生成二维码。

### Q6：支付宝收到款项但是表单数据页面显示「未付款」

**答**：在系统设置-第三方服务-配置支付宝中的「支付宝公钥」信息填写了错误；**解决方案**：参考本文档「步骤四：获得公钥、私钥、CSR」 重新获取支付宝公钥并在金数据配置。

### Q7：支付提示「SELLER\_NOT\_EXIST」

![PC|支付宝|支付宝支付接口错误提示页面背景为浅红色左侧有红色错误图标](https://help-assets.jinshuju.net/assets/file/13/alipay-faq-seller-not-exist.png?imageView2/2/w/1000)

**答**：这通常是由你的支付宝邮箱填写错误引起的。请确认支付方式中填写的支付宝邮箱为你支付宝商家服务的邮箱，不要填写成你的金数据登录邮箱。

### Q8：「ILLEGAL\_PARTNER」

![PC|支付宝|支付宝支付接口调试错误提示页面错误描述为调试错误请回到请求来源地重新发](https://help-assets.jinshuju.net/assets/file/14/alipay-faq-illegal-partner.png?imageView2/2/w/1000)

**答**：这通常是由你的 API 或 KEY 填写错误引起的。请确认支付方式中填写的 API 和 KEY 与你在支付宝后台获得的完全一致。

### Q9：支付提示「ILLEGAL\PARTNEREXTERFACE」

![PC|支付宝|支付宝支付接口调试错误提示页面错误描述为调试错误请回到请求来源地重新发](https://help-assets.jinshuju.net/assets/file/15/alipay-faq-illegal-partner-exterface.png?imageView2/2/w/1000)

**答**：这通常是由你接口类型设置错误引起的。请确认支付方式中选择的接口类型与你在支付宝申请的类型完全一致。例如你在支付宝申请的是担保交易，在金数据内也要选择担保交易，而不能选择即时到账或者双功能收款。

***

## 配置「支付宝直连商户号」相关资费介绍

| | 免费版 | [专业版](https://jinshuju.net/plan_payment) | [专业增强版](https://jinshuju.net/plan_payment) | [企业基础版](https://jinshuju.net/plan_payment) | [企业协作版](https://jinshuju.net/plan_payment) | [企业高级版](https://jinshuju.net/plan_payment) |
| - | - | - | - | - | - | - |
| **是否支持此功能** | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
| **绑定支付宝商户号数量** | 0 | 0 | 0 | 0 | 0 | 6 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.