关于与常见问题
做到哪一步、什么能用、什么还在等审批,写在同一页上。费率怎么算、钱走哪条路,也一并说清楚。
§01 What we do
我们做什么
NAPAY 钠云付是一套收款接口和一个商户控制台。你调下单接口拿到收银台链接,用户付款,我们把带签名的结果回调给你的服务端,次日给你一份逐笔可核的账单。
服务对象很具体:卖数字额度、订阅、按次调用的小额高频生意。独立开发者、AI 产品团队、自由职业者、个人主体的小微商户。
边界,说在前面
- 我们提供的是支付技术服务,不吸收公众存款,不做资金归集与清结算。
- 真实交易的资金由持牌机构清算后结算到你自己的收款账户,不经过我们的账户中转。
- 真实通道能不能开通、开哪些,由持牌机构审核决定。我们协助递材料、同步进度,不承诺结果和时间点。
- 当前沙箱环境是完整可跑的模拟链路,不涉及真实资金。
这一段和《服务协议》第 3 条说的是同一件事。签约前把这条读一遍最省事。
§02 Why
为什么做这件事
写完一个能卖钱的小工具只要一个周末,让它能收钱却要两周:先被问有没有营业执照,然后是几百块开户费加月费,接着等销售排期、等审核、等对接文档发过来。很多产品是死在这一段的。
所以钠云付的取舍很直接:费率单一,开户便宜,不设月费,个人身份也能申请,文档先给你看。你先在沙箱里跑通一笔,再决定要不要签约,而不是反过来。
我们的三条自我约束
- 费用全列在页面上。只有 1.6% 费率和 ¥66 一次性开户费两项,没有等签约才出现的服务费。
- 状态如实标注。通道台账里"已开放"和"审批中"是两种颜色,我们不会把审批中写成即将上线。
- 变更提前通知。费率、接口、结算规则调整提前 30 天书面告知,破坏性接口变更另起版本号并留 6 个月过渡。
§03 Progress
进度台账
这张表按时间排,也按状态盖戳。做完的写完成日期,在做的标进行中,没开始的就是没开始。它会随进度更新,而不是随宣传需要更新。
-
2025-09
已完成
公司设立
武汉市钠云网络科技有限公司完成工商登记。
-
2025-11
已完成
v1 接口定稿
签名规则、下单、查询关单、回调与状态机确定,字段只增不删。
-
2025-12
已完成
沙箱环境开放
下单、收银台、模拟付款、签名回调、验签、对账全链路可跑,免费。
-
进行中
进行中
真实通道接入审批
与持牌机构及其服务商推进微信支付、支付宝的接入审核。审到哪一步,通道台账就更新到哪一步。
-
进行中
进行中
ICP 备案
备案材料已提交。备案号下发后在页脚展示,不提前占位。
-
待通道开放
未开始
小微商户自助入驻
个人身份提交入驻,材料清单一次列清,进度在控制台可查。
-
待通道开放
未开始
退款接口与订阅能力
退款、按次额度、订阅续费随真实通道一起放出,接口设计已预留字段。
沙箱阶段可以先做什么。跑通下单与回调、把验签和幂等写对、拿真实报文对齐你的订单表结构。这些工作在真实通道开放后一行都不用改。
§04 Entity
主体信息
协议主体、发票主体、收款主体是同一家公司。没拿到的资质我们标"申请中",不写"即将"。
§05 FAQ
常见问题
按被问到的频次排。没找到答案就发工单,我们把回答补进这一页。
共 12 条 · 点击展开
没有营业执照,能用吗?
可以。自然人身份就能提交小微商户入驻,不需要营业执照。这是钠云付和多数聚合支付服务最主要的区别。
需要说明的是,小微商户的资质由持牌机构按其规则审核,也会附带交易限额。入驻材料清单在控制台一次列清,不用来回补件。该能力随真实通道一起开放,当前沙箱阶段无需任何材料。
1.6% 具体怎么算,从哪里扣?
按单笔交易金额计算,四舍五入到分,从该笔交易的结算金额里扣除。全渠道统一,不分行业、不按量浮动、不分档。
这三个数字会原样出现在回调报文的 amount、fee、settle_amount 字段里,也逐笔列在账单上,不需要你自己算。
¥66 开户费什么时候收?沙箱要钱吗?
钱会不会经过你们的账户?
不会。真实交易的资金由持牌机构清算后直接结算到你在入驻时提供的收款账户,不在我们这里归集或中转。
我们不吸收公众存款,不从事清结算业务。我们经手的是交易指令和交易记录,不是资金。
结算多久到账?
结算周期由通道方规则和你签署的合同确定,控制台展示当前生效的规则,我们不在这里给一个可能兑现不了的数字。
账单按日生成、逐笔可核、费率明细单列、支持导出。对账有异议的,在账单生成后 30 天内提出,我们协助向通道方核查。
现在只有沙箱,我接了会不会白做?
不会。沙箱和生产用的是同一套 v1 接口和同一套签名规则,切换环境只改两处:接口基址和密钥(沙箱密钥前缀 ap_sandbox_,生产是 ap_live_),再把 channel_code 从 sandbox_qr 换成真实通道标识。
验签、幂等、状态机处理这些真正花时间的逻辑,一行都不用改。
支持哪些支付通道?
沙箱模拟通道已开放,全链路可跑。微信支付(Native 扫码、JSAPI)与支付宝(电脑网站、手机网站)在通道审批中,聚合路由在规划中。
当前状态以通道台账为准,那张表跟着审批进度更新。
回调没收到怎么办?
先看重推:付款成功后我们会推 7 次,间隔 0 秒、15 秒、1 分钟、5 分钟、15 分钟、1 小时、3 小时,直到你的服务端在 5 秒内返回 success。修好接口后可以在控制台手动重推。
同时建议做主动查询兜底:5 秒起、指数退避到 30 秒,跟到订单 expires_at,收到回调即停止。细节见回调通知。
notify_url必须是 https、公网可达、不支持自签证书和 302 跳转- 验签失败请返回 400,不要处理业务
- 耗时的发货动作丢队列,别占着这 5 秒
验签老是失败,一般是什么原因?
九成是这三个:
- 金额用了浮点数,序列化成
19.9或19.900000001。金额一律用字符串,两位小数。 - 嵌套对象(如
metadata)序列化方式不一致。取紧凑 JSON:无空格、key 升序、中文不转义。建议只放扁平字符串。 - 服务器时间不准,超出 ±300 秒容差,报
40101。校准 NTP。
逐字段核对 stringA 的规则和现成代码在签名规则,Node 和 Python 的实现可以直接拿走用。
支持退款吗?
暂不提供退款接口,随真实通道一起开放,字段已在接口设计里预留。
沙箱阶段请按"不可退"设计业务流程。如果你的商品形态必须有退款(比如订阅),提工单说明场景,我们同步排期。
能开发票吗?
我们收取的开户费和技术服务费可以开具增值税发票,在控制台提交开票信息即可。
你卖给你自己客户的商品或服务,发票由你按规定开具,我们不代开,也不能代你履行纳税义务。
密钥泄露了怎么办?
立刻在控制台吊销并轮换。新旧密钥并行 24 小时,期间两把都能验签,够你滚动发布,不用停服。吊销即时生效,用旧密钥发起的请求返回 40100。
同时发信到 [email protected],我们协助排查这段时间的异常调用。提醒一句:我们不会以任何形式索取你的 app_secret、账号密码或验证码。
§06 Contact
联系我们
三个入口,各管一件事。写信时带上 request_id 和订单号,能省掉一轮来回。
-
技术支持
接入、验签、回调异常。7×24 值守,2 小时内响应,回调故障最高优先级。
[email protected] -
安全与漏洞
密钥泄露、可疑调用、漏洞报告。请不要在公开渠道披露细节。
[email protected] -
商务与合规
合同条款、发票、资质材料、通道申请进度。
[email protected]