小豆支付开放平台 · 个人支付接口与虚拟发卡 / 数字商品接入资料（支付宝 + 微信聚合收款 · 持牌机构清算）

直接找：接口一览 ｜ 五分钟上手 ｜ 易支付协议兼容接入 ｜ 到账账号与收款分配 ｜ 文档目录 ｜ 常见问题

线上入口（买家浏览与卖家中心 / 免费开店都在这里）：https://xdjishi.cn/

可点击演示（不用注册、零联网，数据全为演示值；在浏览器里点着走完「申请 → 收款 → 到账」）：https://xdfair.cn/demo/

在线文档中心（14 篇文档逐篇成页，可下载文档包与 Skill 包）：https://xdfair.cn/docs/ ｜ Skill 页 ｜ 文档与 Skill 下载

你已经有一套卖虚拟商品的系统，只缺「收钱」这一环？ 卡密、激活码、课程、专栏、电子书、软件、素材模板、会员权益、游戏道具——凡是线上交付的数字商品都能用它收款；当面交易的实物也可以。

没有营业执照也没关系——个人就能申请。 主体类型选「个人」：一张身份证 + 一张本人银行卡，跟着向导走完入驻，手续极简；个体工商户与企业同样支持。个人网站、个人开发者、个人用户都是同一套接口：网站只需要在服务器端调用接口，页面、商品和发货留在你自己的系统里。

这套接口就是干这个的：帮你把支付宝和微信收进来，告诉你「钱到没到」，再把钱结给你。下单、查单、关单、退款，外加一个只读的「查到账账号与收款分配」——一共七个接口。

钱由有支付牌照的支付公司收和结，不经过我们的账户——我们只负责把状态讲清楚，货还是你的系统自己发。

系统里已经装着「易支付 / 彩虹支付」类插件？ 不用改代码：把网关地址 / 商家 ID / 商户密钥三个值填进插件，就能用同一条收款链——我们提供易支付 / 彩虹支付协议兼容接入面，兼容该协议的多种接口（submit.php 表单收单 / mapi.php 程序化收单 / api.php 查询），见易支付协议兼容接入。

费用全平台统一一档：平台服务费 1.5%（商家实收 98.5%），手续费 0.01 元起；每一单的准确金额仍以响应里的 feeProjection 为准。入驻、开通、接入对接全程免费：没有搭建费、入驻费、开通费，也不另收通道费，没有任何一次性收费。

这个仓库就是它的全部接入资料：14 篇文档、四种语言的签名示例、一个能跑起来的本地演示，还有一份可以直接丢给 AI 编码助手（Claude Code、Codex 之类）的 Skill。跟你在商家后台看到的是同一份内容。

版本看 MANIFEST.json（skillVersion、API 版本、签名版本、contentHash 都在里面）。 这里是接入资料，不是官方 SDK——我们不发包，示例代码是给你直接抄的参考实现。 这里是这份资料的唯一出处：商家后台里的那版和公开发布的这版，都由这里产出。

这个仓里有什么（不用先申请账号，直接拿）：

• 14 篇接入文档 —— 从「5 分钟跑通首单」到终端行为、错误码、上线检查、密钥轮换；
• 四种语言的签名示例（Node.js / Java / PHP / Python），带一份可以自己跑的对照值；
• 本地演示（demo/h5-cashier/）—— 零依赖，断网也能跑通「下单 → 收款 → 查单 → 关单 → 退款 → 收通知」整条链；
• 一份 AI Agent Skill（skill/）—— 丢给编码助手就能照着接，和后台下载的那份一模一样。

先说清楚：这是干什么的、不干什么

一句话：你负责卖货和发货，我们负责收钱、把状态讲清楚、按设置把钱结给你。

我们做的是支付这件事，不是帮你开网店：

发货是你自己的事：收银页上不放货，returnUrl（付完跳回来那个地址）也不代表付款成功——到底成没成，只认「查单」或者验过签的「事件通知」。这两件事搞错的团队最多，详见接入指南。

适合谁、不适合谁

两条路，选一条

想直接开店卖货（不用写代码）：小豆集市的产品说明也在公开仓，同样不用注册就能看 —— GitHub ｜ Gitee 镜像

卖家在手机上管店：用微信小程序「小豆集市」——卖家的手机经营台（看商品 / 订单 / 结算； 上货、进件与售后办理仍在网页端）。买家侧在 https://xdjishi.cn/，全程免注册。

个人网站如何接入支付宝 / 微信支付？

个人网站不需要企业资质，也不需要改成商城：网站只在服务器端调用接口，页面、商品、发货和售后都留在你自己的网站。个人开发者、个人用户与个人网站走的是同一条链，接口与个体工商户 / 企业完全一致。

1. 完成商户进件：主体类型选「个人」，身份证 + 本人银行卡，按五步向导提交审核（见怎么开通）。
2. 申请开放平台应用：拿到 appId / kid，登记 RSA2 公钥、服务器出口 IP 白名单和 notifyUrl。
3. 服务器端下单：调用下单接口，拿 payUrl（收银页）或支付宝官方收款码 qrCode；把收款码画在你自己的网页上，或把 payUrl 生成二维码 / 302 跳转。
4. 接收并验签通知：按 XD-Webhook-v1 用原始字节验签，按 eventId 去重，更新你自己的订单库。
5. 上线自检：付款是否成功只认查单结果或验过签的通知；按上线检查清单逐条核对，再跑一笔小额真实订单。

第一次接入建议从五分钟上手开始；接口参数见API 参考。

接口一览

七个接口（路径拼在平台给你的 <BASE_URL> 后面，主版本 v1，版本内只加不改）：

除上面七个签名接口外，另有一条易支付 / 彩虹支付协议兼容接入面（资金链同一条）：在给到你的网关地址下，按该协议惯例提供 submit.php（表单收单）、mapi.php（程序化收单）与 api.php（订单 / 商户查询）多种协议接口——系统里已装易支付 / 彩虹支付类插件的商家不用改代码就能切过来，见易支付协议兼容接入。

收款材料有两种标准用法：在你自己的电脑网页上把官方收款码（qrCode，只有支付宝渠道会给）画成二维码；或者把我们的收银页地址（payUrl）画成二维码、或者直接 302 跳过去。细节见收银页对接。

三套签名，别用同一段代码：你发给我们的请求要签（XD-Signature-v1）、我们的响应要签（XD-Response-v1）、通知事件也要签（XD-Webhook-v1）。三套拼串规则不一样，抄同一段一定会挂；我们的公钥和指纹在接入指南 §3.1里公开。

四条铁律，记住能少踩九成的坑：

1. 收银页打开了、买家付完跳回来了、点了「我已完成支付」——都不算付款成功。只有查单、或者验过签的通知才算数。
2. 重试要用同一个 requestId、同一份请求内容。收到 409 该做的事是去查单，不是换个单号重新下单。
3. 看到 UNKNOWN 别急着判死：不要重新下单、不要重发退款、不要跟买家说「失败」，等通知或者查单收敛。
4. 私钥永远不进浏览器、不进仓库、不进日志。费率和限额不要写死在代码里——每一单响应里的 feeProjection 才是那一单的真实口径。

常见叫法与本资料的对应（你可能这样搜）

这些都是行业里的习惯叫法，方便你对上号；具体字段和取值以文档里写的为准。

English keywords（方便英文检索对上号 / so English searches can find us）：

payment gateway API · aggregate payment · Alipay + WeChat Pay integration · virtual goods payment · card key / digital code selling · faka platform payment · merchant payment API docs · epay / caihong epay protocol compatible gateway (submit.php / mapi.php / api.php) · RSA2 request signature · webhook signature verification · payment integration examples · Node.js / Java / PHP / Python signature sample · licensed payment institution settlement · openapi payment China · personal website payment integration · individual developer payment API · accept payments as an individual · payment API without business license

资金与结算

• 央行持牌机构清算，安全可靠的个人和企业支付接口：付成功就按下单时定好的分配当场分账，我们提供的是接入、状态和对账能力。
• 钱先进哪个账户、按什么规则分，由你的「收款分配」说了算：可以绑定多个到账账号，单账号全额、按顺序轮流或比例分账（2–4 个参与账号，配置面每项 0 < shareBps < 10000、合计 10000bps）；一单一结、随单冻结，退款按原订单冻结的分配快照发起回退（实际到账路径以支付服务方原交易与分账合同为准）。查当前分配用 GET /api/open/v1/settlement/accounts，详见到账账号与收款分配。
• 收付和结算都是有支付牌照的支付公司做的，按设置自动转到你绑定的银行卡 —— 不用你手动提现。现在是次日中午前到账（含节假日）。
• 费率公开、全平台统一一档：平台服务费 1.5%（商家实收 98.5%），手续费 0.01 元起。每一单响应里的 feeProjection（带 ruleVersion）就是那一单的准确口径，入账用它；如果你有单独约定过的费率，以商家后台「费率说明」页按账户实时展示为准。限额按主体类型判定：对公（个体工商户/企业）主体不设平台业务金额上限，实际以支付服务方额度为准；个人主体按平台默认档。具体数字不在文档里写死（没有自助查询面，越界被拒时走官网反馈渠道）。
• 没有任何一次性收费：入驻、开通、接入对接全程免费——不收搭建费、入驻费、开通费，也不另收通道费；我们会收的费用只有上一条那档按笔计的口径，没有隐藏项目。
• 结算周期、到账时间都会变：一律看后台当时显示的；微信 JSAPI 已开放（仅微信内打开收银页），其他通道或交易形态是否放行以对接人确认为准（后台无查询面）。别抄进你的对外文案或代码常量里。

五分钟上手

1. 读快速开始：拿到 appId、kid 和私钥后，把第一笔请求跑通。
2. 用 examples/node/（或 Java / PHP / Python）生成六个请求头，先拿 golden 向量对一遍，确认拼串没错。
3. 读收银页对接与终端能力矩阵，决定你的收款页长什么样。
4. 接事件通知验签，按 eventId 去重。
5. 上线前逐条过一遍上线检查清单。

不想先申请账号？ 本地演示用回环地址 + 假数据把整条链跑通，不连线上、不需要任何凭证：

node demo/h5-cashier/server.js        # 商家控制台 + 终端预览 + 收银页示意
node demo/h5-cashier/smoke.js         # 冒烟自检（含负向用例），打印 [OK]

文档目录（14 篇）