gamepay 商家 API 对接文档（P0）

面向代理商（商家）技术对接。平台只记账（人民币计价、线下结算），不涉及任何资金接口。
基址：https://6go.run/gp/api；鉴权：请求头 X-API-Key: <你的key>（key 创建时仅展示一次，丢失请联系管理员重置）。
📋 接口更新日志：2026-08-20 新增「登录账号信息 + 自定义核对页」三接口（login-info / confirm / reject，见 5b）；2026-08-19 订单列表支持筛选参数、order_no 强制字符集；2026-08-18 新增订单回执 gp_order_id 字段、WTM 战争雷霆上线（gaijin/google 双登录）。

一、通用约定

• 成功：{"success": true, ...}
• 失败：{"success": false, "code": "错误码", "message": "一行中文说明"} —— 请按 code 做逻辑分支，message 只用于展示。
• 下单/查单/消费记录只与你自己的数据有关；你看不到平台内部任何信息。
• 金额字段（price_usd、amount_usd_cents 等）保留历史命名，值一律为人民币（元/分）。

二、错误码

三、端点

1. 健康检查（不鉴权）

GET /merchant/health → {"success":true,"status":"ok"}

2. 已开通游戏与商品

GET /merchant/games → 你开通的游戏、商品列表（含你的人民币价、美元参考价）。商品会随游戏调价/后台运营调整，以此接口为准；另附静态对照表 商家SKU表.md（同目录，快照可能滞后）。

返回结构（每个游戏一个 products 数组，每项一个商品）：

{
  "game": "limbus",
  "name": "Limbus",
  "products": [
    {
      "product_id": "lunacy_monthly_1",
      "title": "月度狂气包",
      "price_usd": "68",
      "sale_price": "68",
      "available": true,
      "reason": ""
    }
  ]
}

商品字段：

• 务必按 available === false 判断置灰（不要用 !available，避免其它字段误判）。
• 每个商品都有 available/reason 字段（含自动档，自动档恒 available:true）。
• available=false 的商品即使强下单也会被拒（返回 CARD_UNAVAILABLE 或 PRODUCT_UNAVAILABLE）。

3. 下单

POST /merchant/orders

{
  "order_no": "你的唯一单号(≤64字符，只允许字母/数字/下划线_/中划线-)",
  "game": "limbus / browndust / wtm",
  "product_id": "商品 ID（如 lunacy_monthly_1 / brd2_daily_pack / gold_pack_3）",
  "customer": "顾客标识（邮箱）",
  "credential": "顾客凭据（见下方凭据类型；留空 = 顾客网页登录充值，见 3c）",
  "method": "可选：云登录方式 google/apple/pin（仅 credential 留空时有效，默认 google）",
  "return_url": "可选：顾客完成后回跳的你们页面地址（仅 credential 留空时有效）"
}

⚠️ order_no 字符集（2026-08-19 起强制）：只允许 A-Z a-z 0-9 _ -。含空格或 / ? # % 等字符的单号会被 INVALID_PARAM 拒绝（这类单号会导致后续查询/取消的 URL 断裂）。

credential 凭据类型（按形态自动识别，不用多传字段）：

• 凭据属于顾客账号，且必须与 customer 邮箱是同一个号。
• 谷歌号必须已在对应游戏内用谷歌登录过一次，否则谷歌侧拒绝授权（报 BAD_CREDENTIAL）。
• pin 一次性：同一个 order_no 重发仍幂等；换新单号需重新发码。
• wtm 专门说明：①云登录两种方式——method=gaijin（顾客在我们页面自己填 Gaijin 注册邮箱+密码，开了两步验证的顾客会被引导自己输邮箱验证码，能过 2STEP；customer 仅作你的订单标识，可任意占位，顾客真实邮箱以顾客页面实填为准）或 method=google（网页谷歌登录，与 limbus/browndust 同一套）；直接传凭据也照旧（customer=Gaijin 注册邮箱，credential=密码明文，或谷歌账号凭据 aas_et/ 开头）；②金鹰（gold_pack_*）有首购双倍（每档独立，每号每档一次），系统自动按双倍发货，无需区分下单。

狂气"优先双倍"自动档（仅 limbus）：商品列表里 lunacy_package_N_auto（如 lunacy_package_1_auto = 70 狂气）为自动档——下单后系统先登录顾客账号检查首充双倍：双倍还在就买双倍档（70+70），已用过就买普通档（70）。顾客买一档的钱，能拿多少狂气系统自动最大化，你不用判断。双倍档与普通档同价档，自动档按一档配价即可。

• credential 也可整个留空：顾客不给你凭据，改走网页登录（见 3c，推荐）。

返回：{"success":true,"reused":false,"order":{...}}。

• 幂等：同 order_no + 相同参数重复提交 → 返回原单（reused:true），不会重复购买；同 order_no + 不同参数 → IDEMPOTENCY_CONFLICT。
• 下单即创建消费记录，金额为当时价目快照（调价不追溯）。

3b. 发邮箱验证码（仅 browndust 的 pin 登录用）

POST /merchant/pin-code

{"customer": "顾客邮箱"}

游戏会发一封验证码邮件到顾客邮箱；顾客把码给你后，把码作为 credential 下单（见上表 pin 行）。限流：每 5 分钟 10 次。

3c. 顾客网页登录充值（credential 留空，推荐）

不想经手顾客凭据时：下单把 credential 留空（可带 method 指定登录方式：google 默认 / apple / pin 仅 browndust / gaijin 仅 wtm），返回的订单为 awaiting_login 状态并带 login_url：

1. 把 login_url 发给顾客（创建后 5 分钟内须首次打开，打开后 10 分钟内有效；存活期内顾客可重复打开同一链接，误关页面重开即可）。
2. 顾客在页面里自己完成登录（谷歌/苹果/邮箱验证码，wtm 是 Gaijin 账号密码——顾客在页面自行填写真实注册邮箱+密码，开了两步验证的顾客会被引导自己输邮箱验证码），页面会显示他登录出的游戏账号（游戏 ID/昵称/登录邮箱，wtm 暂无资源数据展示），顾客点"这是我的账号"确认。
3. 确认后订单自动进入充值，status 变 running，照旧轮询查单即可。凭据全程不经过你、不落盘。

• 顾客在确认页自行核对游戏账号（游戏 ID/昵称），可点"不是这个账号"取消——订单判 ACCOUNT_REJECTED，未充值；平台不做邮箱比对（苹果隐私邮箱必然对不上）。
• 顾客未完成/取消/超时（15 分钟）→ LOGIN_CANCELLED / LOGIN_TIMEOUT，可换新单号重新下单。
• 谷歌/苹果登录方式同时可接待 2 位顾客，超出返回 LOGIN_BUSY，稍后重试即可（邮箱验证码不受限）。
• return_url（http/https 绝对地址）：顾客确认/失败/取消/超时后，页面 2 秒内自动跳回该地址，并附带参数 order_no（你的单号）、status（confirmed/rejected/failed/cancelled/expired）、game_id（仅 confirmed 时有，顾客登录出的游戏 ID）。登录页禁止 iframe 内嵌（防点击劫持），请整页跳转/新窗口/WebView 打开。

3d. 取消待登录订单

POST /merchant/orders/{order_no}/cancel → {"success":true,"cancelled":true|false}
仅限 awaiting_login（顾客还没完成登录）的单。典型场景：顾客放弃了登录链接，你换单号重发时报 GAME_BUSY——先调本接口取消旧单，立即就能重发，不用等 15 分钟超时清扫。已进充值的单不可取消。

4. 查单（轮询）

GET /merchant/orders/{order_no} → order.status：

• awaiting_login：等顾客打开 login_url 完成网页登录（见 3c）
• created/running：处理中，请继续轮询（建议 3-5 秒间隔）
• done：成功
• failed：失败（见 error_code）
• interrupted：已扣款但结果未定，等平台管理员裁决，不要重复下单

订单对象字段（order 内的字段）：

订单回执（gp_order_id）：顾客要购买凭证/向游戏方举证时，把这个号给他即可。出票（扣款）后即返回——订单可能仍在 running 或变 interrupted，回执号在终态前就可用，可提前给顾客。interrupted 单（已扣款待裁决）：别重复下单，可先把 gp_order_id 给顾客作凭证，等管理员裁决。出票前失败的单（登录失败/卡拒付等）没有扣款，此字段为空串。

5. 消费记录列表

GET /merchant/orders?page=1&size=50

支持筛选参数（2026-08-19 起，全部可选、可组合）：

示例：GET /merchant/orders?status=done&game=limbus&start=1787000000
筛选后返回的 total 为筛选条件下的总数（分页照此翻页）。

5b. 登录账号信息 + 自定义核对页（2026-08-20 新增）

云登录单（credential 留空）在顾客完成登录后，可用以下接口拿到账号信息，在你们自己的页面上做账号核对：

GET /merchant/orders/{order_no}/login-info

• 只读、最小字段：不含邮箱/凭据/token；仅限你们自己的订单；数据窗口 = 登录成功到确认为止。
• 防充错号是商家侧责任：展示 game_id/nick/余额让顾客肉眼核对后再确认。

POST /merchant/orders/{order_no}/confirm —— 顾客确认（"这是我的账号"）。幂等：重复调用返回 {"already":true} 不会重复充值。凭据过期返回 LOGIN_TIMEOUT（需重新下单）。
POST /merchant/orders/{order_no}/reject —— 顾客拒绝（"不是这个账号"）→ 订单判 ACCOUNT_REJECTED，不扣款。幂等。
平台托管的核对页继续可用：两条路谁先确认都行（幂等互斥）。

6. 消费汇总（对账）

GET /merchant/balance → 累计消费（人民币）、本月消费、本月笔数。

结算/预存余额请在商家中心「结算」页查看（网页登录，含打款记录），不走 API。

四、调用示例（curl）

curl -X POST "https://6go.run/gp/api/merchant/orders" \
  -H "X-API-Key: gp_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"order_no":"A20260805001","game":"limbus","product_id":"lunacy_monthly_1","customer":"[email protected]","credential":"aas_et/..."}'

curl "https://6go.run/gp/api/merchant/orders/A20260805001" -H "X-API-Key: gp_xxxxxxxx"

商家 SKU 表（快照 2026-08-20，Limbus 1.112.0 / BD2 2.32.7）

实时目录、你们各自的人民币价以接口 GET /merchant/games 为准（后台配价/游戏调价后接口即时更新）。
本表是静态快照，供查阅商品内容对照；"游戏内价"为美元参考价（美国商店，会随官方调价浮动）。
优先双倍自动档：_auto 后缀的商品——顾客首充双倍还在就买双倍档，已用过就买普通档，按普通档配价即可。

一、Limbus（game=limbus）

狂气自动档（优先双倍，推荐）

全部商品

二、棕色尘埃2（game=browndust）

钻石自动档（优先双倍，推荐）

全部商品

三、战争雷霆 WTM（game=wtm，2026-08-17 上线）

凭据：Gaijin 官方账号密码（customer=注册邮箱）或谷歌账号凭据（aas_et/ 开头）；云登录（gaijin 账密页 / google）与直接传凭据均可。
金鹰首购双倍每档独立，系统自动发货无需区分。当前仅售金鹰 + 铂狼币（通行证/订阅不上架）。
游戏内价为美元参考价（美国商店，随官方调价浮动），以 GET /merchant/games 实时返回为准。

铂狼币（无双倍）

金鹰（首购双倍，每档独立）

通行证 / 订阅（暂不上架）

备注

• Limbus 狂气/BD2 钻石的首充双倍档每个账号每档限购 1 次（永久）；直接下单双倍档而顾客已用过会失败——所以请直接用 _auto 自动档。
• BD2 邮箱验证码登录：先 POST /merchant/pin-code 发码，凭据填顾客收到的 4-8 位数字码。