在线收款配置（Online Payment Setup）
1. 这是什么
给公会接一条玩家自己付款、系统自动到账的收款渠道。
玩家张三在你的门店点「充值 ¥200」，扫码或在支付页面付完，几秒钟后他的星币就到账了——全程没有客服参与，你也不用盯着手机看有没有人转账。钱直接进你公会自己的商户账户，星港只负责记账，一分钱都不经手。
配好之前，玩家充值只能走「转账给你 → 客服核对 → 手动登记」那条路（见 钱包与资金流）。两条路可以同时开着。
配置入口：后台 → 公会设置 → 充值 → 充值渠道 → 卡片最下面那条「＋ 接入充值渠道」。
2. 能解决什么问题
| 没接在线收款 | 接了之后 |
|---|---|
| 玩家半夜想充值，得等客服上班核对 | 付完当场到账，24 小时不打烊 |
| 客服每天花时间对账，认「谁付的这 200 块」 | 系统按订单号自动认领，不会认错人 |
| 玩家转账备注填错，钱到了却挂着没人认 | 不存在这个环节 |
| 收外币只能靠私下转账 | 玩家用 PayPal 或信用卡直接付 |
代价也说清楚：支付服务商会抽手续费（具体看你和它们签的费率），而 PayPal 与 Stripe 这类刷卡付款还存在拒付——买家可以向发卡行发起争议把钱要回去。这两件事都发生在你的公会和支付服务商之间，星港不参与也不承担，但会如实记进账（见第 6 节）。
3. 核心概念
渠道 你接进来的一个商户账户（比如「你公会的支付宝商户号」）。同一家可以接好几个账户，各占一行。
收款方式 渠道下面逐条打开的付款方式，玩家在充值弹窗里看到的就是它。接入渠道不等于开卖——一条方式都没打开时，玩家看不到这家。
四家各适合谁
| 渠道 | 适合谁 | 玩家怎么付 | 收什么钱 |
|---|---|---|---|
| 支付宝 | 国内玩家，已有支付宝商户号 | 在你的页面上用支付宝扫码 | 人民币 |
| 微信支付 | 国内玩家，已有微信支付商户号 | 在你的页面上用微信扫码 | 人民币 |
| PayPal | 收外币，尤其是 Stripe 开不了户的国家 | 新窗口里用 PayPal 余额或绑定的卡付 | 美元、欧元、港币等外币，不收人民币 |
| Stripe | 收外币的主力选择 | 新窗口里用信用卡等当地常用方式付 | 以你 Stripe 账户开通的为准 |
四家都是「你自己的商户账户」，星港从不做收款主体。
到账通知 支付服务商用来告诉星港「这笔钱到了」的消息。到账只认这条通知——玩家付完跳回页面不算数（那个页面谁都能直接打开）。
这件事不用你配：支付宝与微信支付每笔付款都会带上回执地址；PayPal 与 Stripe 由星港在你接入时自动去对方后台登记一条回调订阅，之后每 15 分钟核对一次，缺了会自动补上。
附加费 每条收款方式各自可以设一个附加费率和一笔固定附加费，加在玩家账单上并逐项列出——玩家充 ¥200、附加费 4%，实际付 ¥208，到账仍是 200 星币。不想让玩家多付，就填 0。
正式环境 星港上接进来的账户一律按正式（真实收钱）凭据使用。去服务商后台取凭据时，请在正式（Live）那一侧取，沙箱的凭据填进来会验证不过。
4. 接入流程
四家走同一套流程，区别只在第二步要填哪几项（见 4.1–4.4）。
第一步：选渠道
公会设置 → 充值 → 充值渠道 → ＋ 接入充值渠道，在弹出的目录里选一家。
第二步：填凭据，点「接入」
照下面对应那家的说明，把凭据填进窗里，点「接入」。
点下去时星港会当场拿这套凭据去问一次对方，确认它真的能用。不通过就不会接入，并直接告诉你是哪一项、错在哪。
为什么要卡这一道：列表里的每一条都应该是能用的。少了这道检查，填错一个字符也能保存成功，而你要等到第一个玩家付款失败才知道。
⚠️ 如果提示「暂时无法确认」，那说明是星港没能连上对方（网络抖动或对方故障），不代表你填错了——稍等片刻再试一次即可。
第三步：打开要收的方式
接好之后，这家会作为一条渠道出现在「充值渠道」卡里（和最上面那张「人工收款」平级）。星港会当场问一次对方「这个账户现在能收哪些方式」，列在这一行下面：
- 打开——打开的才会出现在玩家的充值窗里。第一次打开某条方式时会让你填附加费，不加收就填 0；
- 收款币种——玩家实际被扣的币种，必须是这家支持、且你账户开通了的。收外币时，「公会设置 › 充值 › 多货币收款」里要配好这个币种的充值汇率，否则玩家那边算不出该付多少。
为什么是「现问」而不是列一份固定清单：你后来在对方后台开了新的付款方式，下次打开就会多出一条——星港不替服务商声明它能收什么。
打开之后，玩家的充值弹窗里立刻就能看到它们。
走一遍验证
拿一个测试账号充最小金额，付完看三件事：玩家星币到账了、后台充值记录是「成功」、你的商户账户里收到了这笔钱。三样都对，就通了。
4.1 支付宝要填什么
在支付宝开放平台找到你的应用：
| 窗里那一格 | 去哪取 |
|---|---|
| 接口加签方式 | 与开放平台「应用 → 开发设置 → 接口加签方式」保持一致：公钥模式或证书模式 |
| 应用 AppID | 应用详情页上那串数字 |
| 应用私钥 | 你用密钥工具生成的应用私钥，原样粘贴，不要自己加 BEGIN/END 行、不要转换格式 |
| 支付宝公钥（公钥模式） | 开放平台「接口加签方式 → 公钥模式」里那串支付宝公钥 |
| 三张证书（证书模式） | 应用公钥证书、支付宝公钥证书、支付宝根证书，开放平台下载的原文件 |
4.2 微信支付要填什么
在微信支付商户平台：
| 窗里那一格 | 去哪取 |
|---|---|
| 商户号 mch_id | 商户平台首页 |
| AppID | 与这个商户号绑定的公众号 / 小程序 AppID |
| APIv3 密钥 | 商户平台「账户中心 → API 安全」里你设置的那 32 位 |
| 商户私钥 apiclient_key.pem | 同一处申请 API 证书后下载的压缩包里 |
| 商户证书 apiclient_cert.pem | 同上压缩包里 |
⚠️ 两个 pem 文件最常见的错误是传反了，或者传的是另一个商户号的那一份——点「接入」时星港会当场查出来。
4.3 PayPal 要填什么
登录 PayPal 开发者后台（developer.paypal.com）→ Apps & Credentials，页面顶部切到 Live → 新建一个 REST API App：
| 窗里那一格 | 去哪取 |
|---|---|
| Client ID | 这个 App 的凭据页 |
| Client Secret | 同一处，点 Show 才看得到 |
回调订阅不用你去 PayPal 后台加——接入时星港会替你登记。
4.4 Stripe 要填什么
登录 Stripe 后台 → Developers → API keys：
| 窗里那一格 | 去哪取 |
|---|---|
| Secret key | 以 sk_live_ 开头的那一串 |
回调端点同样不用你去 Stripe 后台加——接入时星港会替你登记，Stripe 后台 Webhooks 里会多出一条写着「星港充值回调（自动登记，请勿手动删除）」的端点，别删它。
5. 玩家那边看到的是什么
不管用哪一家，玩家都不会离开你的店铺。
| 渠道 | 玩家看到的 |
|---|---|
| 支付宝 / 微信支付 | 页面上直接出示付款二维码，扫码付完自动跳转 |
| PayPal / Stripe | 在充值窗里点「去支付」→ 新窗口打开支付页面 → 付完关窗 → 充值窗显示「充值成功」 |
| 人工收款（收款码 / 收款账号） | 页面上出示你的收款码，付完点「我已付款」，等客服核对 |
「正在确认到账」那几秒是真的在等：到账依据是支付服务商的服务器发给星港的通知，而不是玩家的浏览器说了算——这正是「关掉页面也不影响到账」的原因。
⚠️ 少数浏览器会拦截新窗口。页面上常驻一条「浏览器拦截了弹窗？」的链接，玩家点它就在本页直接前往支付，不会卡住。
⚠️ 每笔待付款有有效时间（默认 30 分钟，付款页上印着截止时刻）。过了时间还没付，这笔单会作废，玩家重新下一笔即可。
6. 常见业务场景
玩家付完了，星币没到账
先看后台充值记录的状态：
- 停在「处理中」 —— 多半是到账通知还在路上。玩家还开着付款页面时，星港会每隔一会儿主动去对方那边查一次；到有效时间作废之前还会再查一次，查到已付就照常到账，不会作废
- 查单一直失败（对方故障）的单不会被作废，会留在「处理中」等人核对
- 是「成功」但玩家说没看到 —— 让他刷新页面，或去钱包流水里查那笔进账
不管哪种，玩家的钱都在你的商户账户里，不会丢。
给玩家退款
在星港后台操作：充值记录 → 找到那一笔 → 「退款」。四家都支持原路退回：星币从玩家钱包里扣回，钱退回他付款的账户。
- 只退充值金额本身：附加费是服务商已经抽走、退款时不返还的，所以不退
- 玩家已经把星币花掉时，可以勾「强制退款」：余额会扣成负数挂「待抵扣欠款」，他下次充值时先抵掉
- 退款原因会随退款请求发给服务商，玩家可能会看到，别填内部判断
你在服务商后台直接退了款
- PayPal / Stripe：星港会收到通知并自动把发出去的星币收回来，充值记录转为「已退款」。只有整笔全额退款会自动动账——只退一半的话，星港留一条记录让客服人工处理，不猜该收回多少
- 支付宝 / 微信支付：星港收不到这类通知，星币不会自动收回。请尽量在星港后台发起退款；已经在商户后台退了的，请在这个玩家的用户页上手动把余额调回（需要「余额修正」权限）
玩家发起拒付，服务商判他赢
适用于 PayPal 与 Stripe。处理方式和全额退款一样：星币收回，不够就扣成负数挂欠款。
充值记录上会注明「充值渠道判定拒付」，与普通退款分得开。拒付的损失落在你的公会和服务商之间，星港不承担；同时，如果这笔钱已经花在陪玩李四的服务上，李四的佣金不动——他把活干了，不该由他承担一笔拒付。
玩家充值时提示付不了款
按顺序查：
- 收款币种这家不支持？ PayPal 不收人民币；支付宝与微信支付只收人民币
- 收的是外币，但没配汇率？ 「公会设置 › 充值 › 多货币收款」里要有这个币种的充值汇率
- 凭据被你在对方后台重置过？ 在渠道行上更换凭据，重新验证一次
想临时停掉
把这一行的开关关掉，玩家立刻看不到它，凭据原样留着，想开随时开。
不要用「移除」来暂停——移除会把凭据也断掉，重新接要再填一遍。
想换一个商户账户收款
在渠道行上更换凭据，填新账户的值，保存时同样会当场验证；PayPal 与 Stripe 的回调订阅会跟着重新登记。历史记录不受影响。
7. 谁能做什么
| 角色 | 接入 / 移除渠道 | 填商户凭据 | 打开方式、改附加费 | 开关 |
|---|---|---|---|---|
| 业主 / 管理员 | ✅ | ✅ | ✅ | ✅ |
| 财务 | ❌ | ❌ | ❌ | ❌ |
| 客服 | ❌ | ❌ | ❌ | ❌ |
商户凭据是「能把公会收的钱导向另一个账户」的东西，权限归在公会设置里，默认只有业主和管理员有。财务岗位默认拿不到——要给的话得单独授予公会设置权限（见 后台权限与员工角色）。
后台「退款」按钮另有一枚权限「余额修正」管着。
8. FAQ
Q：钱会先到星港再转给我吗？ 不会。钱直接进你公会自己的商户账户，星港只收到一条「到账了」的通知然后记账。星港任何时候都碰不到你的钱。
Q：手续费是星港收的吗？ 不是。手续费是支付服务商按你和它们签的费率抽的，星港一分不抽。你在星港里填的附加费只决定玩家要不要多付这一部分，不影响对方实际抽多少。
Q：能同时开好几家吗？ 能，也可以同一家接好几个账户（比如两个 PayPal 账号轮换额度）。玩家在充值弹窗里自己挑。
Q：保存时提示「凭据没能通过验证」，可我确定没填错？ 看提示的措辞：说「不认」「不存在」「格式不对」的，是服务商明确拒绝了，那就是真填错了（最常见的是取成了沙箱那一侧的凭据，或复制时漏了一位）；说「暂时无法确认」的，是星港没连上对方，稍后重试即可。
Q：我在 Stripe / PayPal 后台看到一条不是我加的回调，能删吗？ 不能。那是星港替你登记的，删了之后玩家付款不会自动到账。万一删了，星港会在 15 分钟内自动补回来。
Q：玩家充值失败，钱会不会扣了但没到账？ 不会。到账的唯一依据是验证通过的到账通知，对方没扣成功就不会发这条通知。真正要留意的是相反的情况——扣成功了但通知丢了，这时星港会主动去对方那边查，按第 6 节处理。
Q：玩家余额被扣成负数了，他会看到什么？ 钱包余额显示为负，充值时会提示先抵扣欠款。这是退款 / 拒付发生后钱已经花掉的必然结果——星港不会替你把这笔损失藏起来。
相关文档
最后更新：2026-09-11
