小豆支付开放平台是面向已有自有系统的商家的支付接入服务:通过服务器对服务器的接口,把支付宝与微信收款接进商家自己的系统,并以签名事件通知回传支付状态;资金由持牌支付公司收付结算。个人也能申请:主体类型选「个人」,身份证 + 本人银行卡即可完成商户进件。央行持牌机构清算,安全可靠的个人和企业支付接口。
一、产品与适用
小豆支付开放平台是什么?
面向已有自有系统的商家的支付接入服务:通过服务器对服务器的接口,把支付宝与微信收款接进商家自己的系统,并以签名事件通知回传支付状态;资金由持牌支付公司收付结算。
这是给谁用的?
已经有自己的卖货 / 发货系统、只缺收钱和结钱的商家。还没有系统、想上架卡密直接开卖,用小豆集市(不用写代码)。
和小豆集市有什么区别?
开放平台是接接口、发货自理;小豆集市是开店、平台提供现成交易链。两者不冲突,钱路是同一条。
你们是支付机构吗?
不是。收款、分账、结算由有支付牌照的支付公司完成;我们提供接入、状态与对账能力。
是发卡平台吗?
开放平台不是发卡平台:它只管收钱和支付状态,卡密、开通、寄出由商家自己的系统完成。
二、个人接入
个人能申请吗?
能。主体类型选「个人」,身份证 + 本人银行卡即可完成商户进件;接口与个体户 / 企业一致。
要什么材料?
个人:身份证 + 本人银行卡;个体工商户:营业执照、经营者身份证、结算卡;企业:营业执照、法人身份证、对公账户。
多久审核?
进件有人工审核,具体时效以卖家后台当期显示为准;资料不齐会退回补充,不是「秒过」。
微信能用吗?
能。微信 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 编码助手。合集包一次拿全。