小豆开放平台 · 支付接入
你已经有自己的系统,只缺「收钱」这一环。这套接口帮你把支付宝和微信收进来,告诉你每一笔钱到没到,再按设置把钱结到你绑定的银行卡。
你负责卖货,我们负责收钱
一句话:你负责卖货和发货,我们负责收钱、把状态讲清楚、按设置把钱结给你。
我们做
- 下单、收钱、支付状态与终态通知
- 查单、关单、退款、退款查询
- 每一单的费用明细与结算
你做
- 商品、库存、定价、页面
- 发货本身:发卡密、开通服务、寄快递、开票、售后
- 你自己的订单库、对账、客服
发货是你自己的事:收银页上不放货,付完款跳回来的那个地址也不代表付款成功——到底成没成,只认查单或者验过签的事件通知。
适合谁,不适合谁
适合
- 你已经有自己的发货 / 开通系统,想要一条服务器对服务器的收款通道
- 你卖的是虚拟卡密类数字商品,或者当面交易的实物
- 你的买家要用支付宝或微信付款
不适合
- 你想要「上传卡密就能开卖」——那用小豆集市的卖家后台,不用写代码
- 你想要一个「接一行就完事」的托管收银台——我们没有这种东西,也不支持免签名接入
- 你想要沙箱环境联调——暂时没有沙箱、测试应用和回调模拟器
两条路,选一条
你的情况
走哪条
还没有系统,就想上架卡密直接开卖
小豆集市的卖家后台:上架商品、导卡密,买家付完钱自动发卡
已经有自己的发卡 / 发货系统,只缺收钱和结钱
小豆开放平台:接这套接口,发货还是你自己发
两个都想要
可以。同一个人既可以是小豆集市的卖家、又可以是开放平台的商家,钱路是同一条
怎么开始
- 先看资料 公开仓不用注册、不用申请账号就能看:接入文档、Node.js / Java / PHP / Python 四种语言的签名示例、以及一份能丢给 AI 编码助手的 Skill。
- 再开通 在卖家中心完成商户进件后,就可以申请开放平台应用、拿到调用凭证。
- 本地先跑通 自带一个零依赖的本地演示,断网也能把「下单 → 收款 → 查单 → 关单 → 退款 → 收通知」整条链跑一遍。
接入资料
同一份内容有两个入口:公开仓(不用注册)与卖家中心内(完成进件并开通后可下载打包版),两份同源同 hash。
先说清楚的一条
钱不进我们的账户:收付结算都是由有支付牌照的支付公司做的,我们不是支付机构、碰不到交易资金,只负责把状态讲清楚。具体的费率、限额与到账周期一律以商家后台当时显示的为准,不要抄进代码常量或对外文案。