> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

扣子编程技能中上架了抖音支付提供的**抖音支付接入集成**、**抖音支付商家入驻**技能，用于为**网页应用**快速集成抖音支付能力。

## 抖音支付技能介绍 {#hOywikJIN}

你是否正在使用扣子编程开发商城类网页应用，并希望用户能在应用内直接下单付款？现在通过抖音支付官方编程技能包（**抖音支付接入集成**、**抖音支付商家入驻**），就能为你的应用快速搭建完整的支付能力。

你只需在开发过程中调用对应技能，扣子 AI 便会根据技能指引，自动完成流程化的支付功能开发。对于个人开发者，抖音支付还支持通过**抖音 App 扫码一键入驻**，复用已有的实名认证信息，将传统十几个小时的入驻流程压缩至几分钟以内。

### 技能说明 {#hYoufEHmH}

支付相关的技能功能与使用场景说明如下表所示：

<!-- @cols-width: 156,365,368 -->
| | | | \
|**技能** |**说明** |**使用场景** |
|---|---|---|
|**抖音支付接入集成** |生成支付集成代码、引导完成支付流程调试与联调。 |\
| | |\
| |安全存储商户证书序列号、商户接口加密私钥等密钥信息。 |**每个项目都需要加载**。开发应用时，调用此技能完成支付功能接入。 |
|**抖音支付商家入驻** |商家入驻是抖音支付对收款方的资质审核流程。调用支付商家入驻技能，能够智能规划入驻方案、自动完成产品开通与应用绑定。入驻后自动签约 Native 支付产品，你会获得： |\
| | |\
| |• 正式的商家身份和收款权限 |\
| | |\
| |• 绑定的支付产品（Native 支付） |\
| | |\
| |• 商户号（mchid），用于标识你的收款项目 |**按抖音支付收款账户级别生效，无需每个项目加载。** 如果你已完成商户入驻并已有可用的商户号，可跳过此技能。 |

### 集成后的效果 {#hSeZLHj8X}

你的应用集成支付能力且你具备收款资质后，用户可直接在应用内下单购买商品。支付完成后，交易金额将直接进入你签约的抖音支付商户号。

体验地址：https://p5r49pqh8k.coze.site

::::cols
@col 50
![Image=416x365](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/dd64931f7f814cb4a28d8424ee0f52d4~tplv-goo7wpa0wc-topic.png)

@col 50
![Image=361x284](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/fa297b26e5724bb1800518f54bf3fcf6~tplv-goo7wpa0wc-topic.png)
::::

## 使用须知 {#hJ0mLnIN8}

<!-- @cols-width: 215,605 -->
| | | \
|**类目** |**说明** |
|---|---|
|费用 |**扣子编程**：与扣子 AI 的每轮对话，将消耗积分。 |\
| | |\
| |**抖音支付**：按照抖音支付官方标准向商家收取交易手续费，具体费率请以签约协议为准。 |
|适用范围 |目前，抖音支付相关技能仅适用于**网页应用**。 |
|调试交易 |由于抖音支付不提供沙箱环境，调试过程也会产生真实的交易资金。 |
|推荐模型 |为获得最佳开发体验，建议使用 `GLM-5.1` 或更高能力的模型。 |
|环境说明 |抖音支付仅支持**生产环境**，不提供沙箱环境。测试场景下通过测试标限额模式运行（单笔限额 1000 元，日交易限额 10000 元，日订单限额 1000 笔），网站正式上线后可通过补齐材料解除限额。 |
|适用主体 |**个人开发者（个人主体）**：通过抖音扫码一键入驻。 |\
| | |\
| |**企业、个体工商户等非个人主体**：将被引导至抖音支付商家平台完成标准入驻流程。 |
|推荐套餐版本 |推荐使用**个人版**套餐。 |\
| | |\
| |目前，企业版的**抖音支付接入**集成服务配置较为繁琐，我们正在加急优化升级，敬请期待。 |

## 开发流程 {#htP3bdqkU}

1. **开发应用**：完成应用的基础功能开发。
2. **完成商家入驻**：使用**抖音支付商家入驻**技能，个人开发者通过抖音 App 扫码一键完成入驻，获得商户号，并自动发起 Native 支付产品开通。
3. **开通 Native 支付产品**：由开发者上传图片并提交签约申请，以测试场景限额模式开通 Native 支付能力。
4. **配置密钥**：在抖音支付商家平台生成密钥。
5. **集成支付能力**：使用**抖音支付接入集成**技能完成密钥托管、支付代码集成与联调测试。
6. **部署应用**：正式上线应用，供用户使用。

## 步骤一：开发应用 {#hl0E23MO4}

:::tip 说明
本文中的截图仅作参考，实际以开发展示界面为准。
:::

在集成支付能力前，建议先完成应用的基础开发。以下以水果售卖网页为例说明。

1. 在扣子编程首页，单击**网页应用**选项卡。
2. 在文本框输入你的提示词，明确应用需求。
   ```Plain Text
   开发一款支持水果展示与购买功能的网页应用。
   1. 提供水果缩略图展示功能，包括多种不同品类的水果预览 (如热带水果、浆果、柑橘等)。
   2. 针对每种水果提供购买按钮，点击后可进入购买流程。
   3. 支持水果的分类筛选功能，用户可按品类、产地、价格区间、是否有机等条件筛选水果。
   4. 提供水果详情页，展示水果的规格 (重量 / 份量)、价格、产地、保鲜期及相关介绍。
   5. 购买后可生成订单并支持配送下单。
   ```
3. 在键盘中敲击回车，开发你的项目。
   扣子 AI 会根据提示词自动设计并开发应用。
4. 确认开发结果。
   建议在应用基础功能开发完成并验证通过后，再集成支付能力，避免后期返工。
   ![Image=506x259](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8a0820c51e974699a9362d4ca7b71387~tplv-goo7wpa0wc-topic.png)   


## 步骤二：完成商家入驻 {#hw5RPJvwu}

调用**支付商家入驻技能**，启动商家入驻流程。抖音支付根据主体类型提供两条入驻链路：**个人开发者**通过抖音扫码一键入驻，**非个人主体**引导至商家平台完成标准入驻。

1. 在对话区域，单击**技能**，添加**抖音支付商家入驻、抖音支付接入集成**技能。
   ![Image=465x370](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6925b8b1f211495da08e4e8a0fe29a11~tplv-goo7wpa0wc-topic.png)
2. 输入加载技能的提示词。
   ```Plain Text
   我要入驻抖音支付
   ```
3. 扣子 AI 会默认选择个人主体入驻流程。
   **按照个人主体入驻时**，扣子 AI 会要求你提供以下信息。如需以非个人主体入驻，可以访问[抖音支付商家平台](https://pay.douyinpay.com/)进行入驻。
   <!-- @cols-width: 192,628 -->
   | | | \
   |**信息项** |**要求** |
   |---|---|
   |商户简称 |* 1—30个字符，仅支持中文、英文、数字、下划线，将显示在支付完成页面。 |\
   | |* 不支持单纯以人名来命名。 |\
   | |   若为个体户经营，可用“个体户+经营者名称”或“经营者名称+业务”命名，如“个体户张三”或“张三餐饮店”。 |\
   | |* 不支持无实际意义的文案，如“XX特约商户”、“800”、“XX客服电话XXX”。 |
   |联系邮箱 |用于接收审核通知，请确保邮箱格式正确。 |
   ::::cols
   @col 50
   ![Image=298x393](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7c986f9c6b314a55b68d130dfc877b2f~tplv-goo7wpa0wc-raw.image)
   
   @col 50
   ![Image=275x528](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/cbfc293198d946df9bbb8903931892a2~tplv-goo7wpa0wc-raw.image)
   ::::
4. 提供商户简称和联系邮箱后，扣子 AI 将引导你完成以下入驻流程。
   <!-- @cols-width: 100,158,634 -->
   | | | | \
   |**步骤** |**节点** |**说明** |
   |---|---|---|
   |1 |单击授权链接 |单击**授权链接**，页面会展示授权二维码。授权有效期为2小时。 |\
   | | | |\
   | | |如果没有生成授权链接或单击授权链接报错，你可以在对话框中输入`重新生成链接`、`没有看到链接`、`报错信息为xxx`等提示词，让扣子 AI 自行修复。 |
   |2 |抖音 App 扫码 |使用**抖音 App** 扫描二维码，进入**抖音支付商家服务**授权页。 |
   |3 |实名校验 |系统自动校验抖音实名状态及身份证照片。已实名则继续下一步，未实名则引导在抖音 App 内完成实名认证。 |
   |4 |选择结算银行卡 |系统自动查询抖音绑定的储蓄卡列表，你可选择一张作为结算卡，也可单击**暂不绑卡**，暂时跳过。未绑卡不影响入驻，后续可在商家平台补充。 |
   |5 |确认签约 |展示完整授权信息（抖音账号昵称、商户简称、经营类目、确认码等），勾选相关协议后，单击**确认签约**。 |
   |6 |入驻完成 |**在页面等待5-10秒，会实时返回签约结果**，签约成功后返回商户号（mchid），扣子 AI 会自动衔接 Native 支付产品开通流程。 |
   ::::cols
   @col 25
   ![Image=2256x4803](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4af7d5d970b44b01beb7dec786abe63b~tplv-goo7wpa0wc-topic.png)
   
   @col 25
   ![Image=2256x4458](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5f89aad434f941af8db248b0ccdcc02f~tplv-goo7wpa0wc-topic.png)
   
   @col 25
   ![Image=2256x4447](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2d01e626f7d448d0bed66c33d027576d~tplv-goo7wpa0wc-topic.png)
   
   
   
   @col 25
   ![Image=1080x2351](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e59d83e9e9bc489fa52d236117463030~tplv-goo7wpa0wc-topic.png)
   ::::   


## 步骤三：开通 Native 支付产品（电脑网页扫码支付） {#hivWXasoH}

完成商家入驻后，扣子 AI 会自动衔接 Native 支付产品开通流程。根据页面提示，截取并上传应用的首页、商品页。

:::notice 注意
若扣子 AI 出现诸如“我帮你自动截图上传”之类的回答，建议选择自行截图上传，AI 自动截图容易产生模型幻觉，审核通过率较低。
:::

<!-- @cols-width: 219,688 -->
| | | \
|**截图类型** |**说明** |
|---|---|
|首页截图 |1张网站首页/落地页全屏截图，需清晰可读、无遮挡，能体现真实的网站内容，格式支持 JPG/PNG，10 MB以内 |
|销售/服务页截图 |1张展示商品或服务的页面截图，格式支持 JPG/PNG，10 MB以内 |

::::cols
@col 50
![Image=342x488](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d9626aa4fc1c487e8aa5301c3042880c~tplv-goo7wpa0wc-raw.image)

@col 50
![Image=375x465](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c7aa79df64834035bdb3fffe1d3f3f50~tplv-goo7wpa0wc-raw.image)
::::

另外，需要注意的是：

* **公共 AppID 机制**：由于抖音开放平台不支持个人开发者直接创建**网站应用**类型的 AppID，抖音支付为通过扣子接入的个人开发者提供了一个公共共享 AppID。开发者无需自行创建应用，入驻后由 Skill 自动绑定该共享 AppID 即可申请 Native 支付能力。该共享 AppID 仅授权支付下单能力，不开放用户登录、信息获取等能力。
* **提升收款额度**：首次开通成功后，该商户号的单笔交易限额为 1000 元，日交易限额为 10000 元，日订单限额为 1000 笔。如你需要提升收款额度，请在网站正式上线后，需要直接前往[抖音支付商家平台](https://pay.douyinpay.com/)，在**账户中心** > **商户管理** > **经营场景**管理中，新增对应网站场景，解除收款额度限制。

## 步骤四：配置密钥 {#hn50TaV5w}

产品签约审核通过后，还需要完成**商户证书**、**商户接口加密私钥**等密钥配置，保障支付数据安全与接口通信可信。本步骤涉及**抖音支付商家平台**和**扣子编程**两个平台的操作，请按顺序执行。

:::notice 注意
* 密钥包含敏感信息，请妥善保管，切勿将私钥或接口加密密钥发送到对话中，也不要暴露在模型上下文或公开环境中。
* 如果你已有可用密钥，无需反复生成，避免造成密钥混淆。多个扣子编程项目，可共用同一套密钥。
* 每个工作空间在同一时间只能托管一套密钥，若你在同一空间有多个应用且密钥不同，可能导致前序已部署的应用失效。
:::

1. 在**抖音支付商家平台**，生成密钥与证书。
   1. 登录[抖音支付商家平台](https://pay.douyinpay.com/)。
      在登录页面切换为**扫码登录**，使用抖音 App 扫码登录，请确保使用与商家入驻时相同的抖音号。
   2. 在页面上，选择**产品中心** > **开发者配置** > **密钥管理**。
   3. 生成密钥与证书。
      在密钥管理页面按以下步骤操作。
      <!-- @cols-width: 100,509,248 -->
      | | | | \
      |**步骤** |**说明** |**图示** |
      |---|---|---|
      |1 |单击**设置**，输入**手机验证码**。 |![Image=251x172](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/958c09d8adb146a58a9bffb01b1cb914~tplv-goo7wpa0wc-raw.image) |
      |2 |打开**密钥证书快捷引导**。 |\
      | | |\
      | |没有密钥证书时，平台会自动打开引导。 |![Image=264x155](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/091e36a01e994aaeb2494734c84dd79d~tplv-goo7wpa0wc-raw.image) |
      |3 |单击**一键生成**，生成 CSR。 |\
      | | |\
      | |平台将在线生成私钥与CSR。 |![Image=200x289](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d68b16bd5a414360aa0b6111dd5b3c6d~tplv-goo7wpa0wc-raw.image) |
      |4 |单击**下载私钥**。 |\
      | | |\
      | |平台不会存储私钥，请务必自行下载并妥善保管私钥，单击下载后才能进行下一步。**该文件后续会在接入集成环节使用，需要将私钥托管到扣子平台。** |![Image=195x303](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3691e28357ab4ba39489cd4e50f7d931~tplv-goo7wpa0wc-raw.image) |
      |5 |单击**确定使用该CSR文件**，上传 CSR文件换取公钥证书。 |![Image=191x297](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/35038c7ab1a94a2da8712621b82ec1a8~tplv-goo7wpa0wc-raw.image) |
      |6 |单击**点击下载**，下载接口加签证书。 |\
      | | |\
      | |后续也可以在左侧的证书列表里下载。 |![Image=188x292](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/255a290311784961a71a781a665b8f25~tplv-goo7wpa0wc-raw.image) |
      |7 |单击**点击下载**，下载抖音支付公钥证书。 |\
      | | |\
      | |后续也可以在左侧抖音支付公钥证书 (RSA)列表中下载。 |![Image=182x283](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0e989b678bd74e1bb7c8e6626e327448~tplv-goo7wpa0wc-raw.image) |
      |8 |单击**一键设置**，设置接口加密密钥。 |\
      | | |\
      | |接口加密密钥用于加密敏感信息，后续可在此页面中查看。 |![Image=160x249](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4087bc056f0f478696b6c92aefb2779b~tplv-goo7wpa0wc-raw.image) |
      |9 |**完成设置** |\
      | | |\
      | |如果中间出错或忘记下载私钥，可单击重新生成重置引导流程。 |![Image=160x249](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/21740231dd544af9a95b19f45759a783~tplv-goo7wpa0wc-raw.image) |
2. 密钥配置完成后，返回**扣子编程**项目的对话区域，确认配置完成。
   输入提示词：
   ```Plain Text
   已完成密钥配置
   ```   


## 步骤五：集成支付能力 {#hJKfYuuO2}

:::notice 注意
由于抖音支付不提供沙箱环境，调试过程也会产生真实的交易资金。
:::

1. 根据技能引导，单击**立即配置**。
2. 在**抖音支付密钥托管**集成页面，配置密钥信息。
   配置说明如下表所示，如果下述指引无法解决密钥配置与托管的问题，请查看[抖音支付文档中心](https://pay.douyinpay.com/wiki/66aa57118a7da602efb9bc2f/67bee79569cf2a053adb0a68)。
   <!-- @cols-width: 203,546 -->
   | | | \
   |**字段** |**获取来源** |
   |---|---|
   |商户公钥证书序列号 |1. 打开[抖音支付商家平台](https://pay.douyinpay.com/)的**账户中心>密钥配置**页面。 |\
   | |2. 在**接口加签证书** > **商家公钥证书**列表中，获取证书序列号。 |
   |商户接口加密私钥 |打开下载到你本地的私钥文件，复制私钥。 |
   |接口加密密钥 |1. 打开[抖音支付商家平台](https://pay.douyinpay.com/)的**账户中心>密钥配置**页面。 |\
   | |2. 单击**接口加密密钥**对应的**设置**，获取接口加密密钥。 |
   ::::cols
   @col 50
   ![Image=261x262](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/491957ec3e054388b4871c55b3cf9cc5~tplv-goo7wpa0wc-topic.png)
   
   @col 50
   ![Image=2105x744](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/53889fa117254a98b7a543f7fab7112c~tplv-goo7wpa0wc-topic.png)
   ::::
3. 完成密钥托管后，扣子 AI 会自动验证密钥有效性。
   校验成功后，会进入支付代码集成流程。扣子 AI 会根据技能指引，阅读支付接入文档，生成支付集成代码。
4. 完成代码集成后，单击网页应用中的**购买**按钮，验证支付能力。
   ![Image=215x216](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b7bae81fcaf240f791234626575619fd~tplv-goo7wpa0wc-topic.png)   


## 步骤六：部署应用 {#hbnaQYNH1}


1. 验证通过后，你可以将应用部署到线上，用户即可通过链接访问应用并购买商品。
2. 配置部署参数说明，请参考[部署网页应用](https://docs.coze.cn/guides/deploy_vibe_web)。
   ![Image=238x260](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4d863823a89d43bca31590c5926ce0c0~tplv-goo7wpa0wc-raw.image)   


当用户购买商品后，真实交易金额将直接进入你签约的抖音支付商户号中，默认 D+1 日自动提现到绑定银行卡。你也可以登录[抖音支付商家平台](https://pay.douyinpay.com/)，在**资金管理**>**提现/转出**页面，修改结算卡或者调整自动提现配置。

![Image=365x151](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2f775db7c7104901b6bcb3f2b62dd2b5~tplv-goo7wpa0wc-raw.image)

## 交流与反馈 {#hmXPsoCsq}

在使用过程中遇到问题、有改进建议，或者想和其他开发者交流接入经验，欢迎提交[Issue](https://github.com/douyinpay/douyinpay-skills/issues)，或联系抖音支付官方技术支持团队（可扫码加入飞书话题群）。

![Image=288x312](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7dbae8cea22848a4bf441c8dc0af2df1~tplv-goo7wpa0wc-raw.image)

## 常见问题 {#hVTqg0Raf}

### **密钥托管是否安全？** {#hA6lGU3XZ}

密钥托管是安全的。密钥托管服务通过加密措施确保你的密钥信息在存储和使用过程中的安全。相比手动在对话或代码中暴露密钥，托管是更安全的方式。

### 如何判断应用已通过抖音支付审核？ {#hkbUkQ5Li}

你可以登录[抖音支付商家平台](https://pay.douyinpay.com/)，单击上方导航栏的**产品中心**，然后在**支付产品**页面中，查看目标应用的状态。

如果状态为**已开通**，则表示审核通过。

![Image=435x234](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9d80480392b749a0a0b9082957245627~tplv-goo7wpa0wc-raw.image)

### 能否使用模型生成的应用密钥？ {#hgh9Jc95L}

不能。在配置密钥环节，模型可能会自行生成一组密钥，但这组密钥并非真实的密钥，无法实现支付。必须在[抖音支付商家平台](https://pay.douyinpay.com/)生成应用公钥和应用私钥。