OPEN PLATFORM · CONTENT

常见问题

按产品、个人接入、接口、易支付兼容、费用结算、Skill 与下载六组整理;每条答案都能在文档或公开仓找到对应原文。

央行持牌机构清算,安全可靠的个人和企业支付接口

小豆支付开放平台是面向已有自有系统的商家的支付接入服务:通过服务器对服务器的接口,把支付宝与微信收款接进商家自己的系统,并以签名事件通知回传支付状态;资金由持牌支付公司收付结算。个人也能申请:主体类型选「个人」,身份证 + 本人银行卡即可完成商户进件。央行持牌机构清算,安全可靠的个人和企业支付接口。

一、产品与适用

小豆支付开放平台是什么?

面向已有自有系统的商家的支付接入服务:通过服务器对服务器的接口,把支付宝与微信收款接进商家自己的系统,并以签名事件通知回传支付状态;资金由持牌支付公司收付结算。

这是给谁用的?

已经有自己的卖货 / 发货系统、只缺收钱和结钱的商家。还没有系统、想上架卡密直接开卖,用小豆集市(不用写代码)。

和小豆集市有什么区别?

开放平台是接接口、发货自理;小豆集市是开店、平台提供现成交易链。两者不冲突,钱路是同一条。

你们是支付机构吗?

不是。收款、分账、结算由有支付牌照的支付公司完成;我们提供接入、状态与对账能力。

是发卡平台吗?

开放平台不是发卡平台:它只管收钱和支付状态,卡密、开通、寄出由商家自己的系统完成。

二、个人接入

个人能申请吗?

能。主体类型选「个人」,身份证 + 本人银行卡即可完成商户进件;接口与个体户 / 企业一致。

要什么材料?

个人:身份证 + 本人银行卡;个体工商户:营业执照、经营者身份证、结算卡;企业:营业执照、法人身份证、对公账户。

多久审核?

进件有人工审核,具体时效以卖家后台当期显示为准;资料不齐会退回补充,不是「秒过」。

微信能用吗?

能。微信 JSAPI 已开放:买家在微信内打开收银页即可调起微信支付,仅限微信内浏览器;微信外手机浏览器与商家 App 内没有直接拉起形态。

三、接入

有哪几个接口?

七个:下单、重新拉支付、查单、关单、发起退款、查退款、查到账账号与收款分配(只读)。

三套签名是什么?

请求 XD-Signature-v1、响应 XD-Response-v1、事件 XD-Webhook-v1;三套拼串规则不同,不能复用同一段代码。

有沙箱吗?

暂不提供沙箱 / 测试应用 / 回调模拟器;替代品是公开仓的本地演示、上线检查清单与一笔小额真实订单。

Webhook 怎么验?

用原始字节验签,按 eventId 去重;成功时回 2xx 且响应体字节正好是 success。

重复请求怎么办?

重试复用同一个 requestId 与同一份请求体,nonce 换新;收到 409 先查单,不要换号重下单。

四、易支付兼容

三值是什么?

网关地址、商家 ID、商户密钥。填回你系统里的易支付 / 彩虹支付类插件即可,不用改代码。

支持哪些系统?

独角数卡(独角兽发卡)与 V2Board 做过源码级核对;异次元发卡等同类插件仅生态登记,以实际版本与一笔小额真实订单为准。

独角数卡和独角兽发卡是两套吗?

不是,是同一个东西的两种叫法。网关填完整地址含 /submit.php。

有什么不支持的?

不支持 RSA 新形态、API 退款、批量查询、修改结算账户或二维码直出;也不接免签 / 第四方代收。

五、费用与结算

费率多少?

线上收款成交才收 1.5%,商家实收 98.5%,手续费 0.01 元起;入驻、开通、对接免费。

集市固定聚合收款码费率?

集市固定码(无档)按 1.5% 实时分账;卖家自用档位收款码另按 0.38%–1.5%,以后台当期展示为准。

限额多少?

按本单实际到账账号的主体类型判定;对公主体平台侧不额外设业务金额上限,但仍受支付服务方额度与敞口约束;个人主体按平台默认档。

多久到账?

付成功当场分账,第二天自动到账(含节假日);没有提现按钮。

退款怎么退?

在商家后台「成交订单」或商家签名 API 发起;按原订单冻结的收款分配快照回退,实际到账路径以支付服务方原交易与分账合同为准。

分账怎么用?

一个商家可绑定多个到账账号;收款方式有单账号全额、按顺序轮流与比例分账(2–4 个账号);写面在商家后台,API 只读。

六、Skill 与下载

Skill 是什么?

给 AI 编码助手用的接入资料包,不是运行时 SDK。它覆盖三套签名、下单、查单、退款、Webhook、错误码与上线检查。

怎么装?

下载 Skill 包并解压,把 skill/ 重命名为 xiaodou-open-platform-integration/ 后放入编码助手的技能目录(目录内必须有 SKILL.md)。

支持哪些编码助手?

只要工具能读取目录内的 SKILL.md 就能用;Claude Code 可放到 ~/.claude/skills/ 或项目 .claude/skills/。

文档包和 Skill 包有什么区别?

文档包是 14 篇 Markdown,给人读;Skill 包是 SKILL.md + references + 四语言示例,给 AI 编码助手。合集包一次拿全。

内容源:docs/server/xdfair-content/faq.md 文档中心文档下载