收款原型 pay-proto:渠道抽象层 + 爱发电主通道 + 当面付辅助通道(占位符配置,内置模拟网关)

Browse Source
- core:支付单 / 流水 / 待办三张表,统一到账入口 settle_payment()(幂等、金额闸门、迟到恢复、重复付款进待办),
  定时任务:爱发电对账、当面付补查、支付单过期关单、订单超时关闭、迟到付款扫描;演示时钟可快进。
- channels:爱发电(专链 custom_order_id/custom_price、Webhook RSA 验签、query-order 按订单号精确反查);
  当面付(precreate/query/close/refund,请求应用私钥 RSA2 签名、响应与异步通知用支付宝公钥验签;熔断、限额、节奏控制)。
- mockgw:占位符时的模拟爱发电收银台 / 查单接口与模拟支付宝网关 / 扫码页。
- 付款页 + 后台页;场景测试 24 条(本机与甲骨文 ARM 均全过)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yws
2026-10-07 05:53:12 +00:00
co-authored by Claude Opus 5.5
parent 8fbffd8408
commit 56c1fa648a
11 changed files with 2175 additions and 0 deletions
+363
View File
@@ -0,0 +1,363 @@
# -*- coding: utf-8 -*-
"""支付原型 HTTP 服务(标准库,只绑 127.0.0.1,由 nginx 反代到 /pay-proto/)。
买家: POST api/order · GET api/order · POST api/pay · GET api/pay · POST api/check
回调: POST api/notify/afdian · POST api/notify/alipay
后台: api/admin/*(请求头 X-Admin-Token)
演示: api/demo/*(快进时钟、立即跑定时任务、模拟场景 —— 只在原型里有)
模拟网关:mock/afdian/* · mock/alipay/*
"""
import json, mimetypes, os, secrets, sys, urllib.parse
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
import config as C # noqa: E402
import core # noqa: E402
import channels # noqa: E402
import mockgw # noqa: E402
STATIC = os.path.join(C.HERE, "static")
STATE_TEXT = {"unpaid": "待付款", "waiting": "已到账 · 排队中", "working": "渲染中", "done": "已完成",
"failed": "渲染失败", "closed": "已关闭(超时未付)", "void": "已注销"}
PAY_TEXT = {"created": "等待付款", "paid": "已到账", "mismatch": "金额不足", "closed": "已关闭", "refunded": "已退款"}
def admin_token():
if not C.is_placeholder(C.ADMIN_TOKEN):
return C.ADMIN_TOKEN
p = os.path.join(C.DATA_DIR, "admin_token")
if not os.path.exists(p):
os.makedirs(C.DATA_DIR, exist_ok=True)
with open(p, "w") as f:
f.write(secrets.token_urlsafe(18))
os.chmod(p, 0o600)
return open(p).read().strip()
# ---------------------------------------------------------------- 视图
def pay_view(p, with_display=True):
d = {k: p[k] for k in ("pay_id", "channel", "state", "amount_due", "amount_paid", "trade_no",
"created_at", "expire_at", "paid_at", "note")}
d["state_text"] = PAY_TEXT.get(p["state"], p["state"])
d["display"] = json.loads(p["display"] or "{}") if (with_display and p["state"] == "created") else {}
return d
def order_view(o):
pays = core.order_payments(o["oid"])
chans = []
for ch in channels.all_channels():
ok, why = ch.available(o)
chans.append({"name": ch.name, "label": ch.label, "ok": ok, "reason": why, "mock": ch.mock})
ev = core.q("SELECT ts,channel,kind,pay_id,result FROM pay_events WHERE oid=? OR pay_id LIKE ? "
"ORDER BY id DESC LIMIT 40", (o["oid"], o["oid"] + "P%"))
return {"ok": True, "now": core.now(), "order": {
"oid": o["oid"], "state": o["state"], "state_text": STATE_TEXT.get(o["state"], o["state"]),
"n_img": o["n_img"], "amount": o["amount"], "created_at": o["created_at"], "paid_at": o["paid_at"],
"closed_at": o["closed_at"], "expire_at": o["created_at"] + C.ORDER_TTL},
"payments": [pay_view(p) for p in pays], "channels": chans, "events": ev,
"params": {"qr_ttl": C.QR_TTL, "order_ttl": C.ORDER_TTL, "late_grace": C.LATE_GRACE,
"ali_max": C.ALI_MAX_AMOUNT}}
# ---------------------------------------------------------------- 动作
def create_payment(o, chname):
if o["state"] != "unpaid":
return {"ok": False, "error": "订单现在是「%s」,不能再付款" % STATE_TEXT.get(o["state"], o["state"])}
ch = channels.get(chname)
ok, why = ch.available(o)
if not ok:
return {"ok": False, "error": why}
for p in core.order_payments(o["oid"]): # 同渠道还有没过期的支付单 → 直接复用
if p["channel"] == chname and p["state"] == "created" and p["expire_at"] > core.now() + 30:
return {"ok": True, "payment": pay_view(p)}
p = core.new_payment(o, chname, ch.ttl())
try:
disp = ch.create(o, p)
except Exception as e:
core.x("UPDATE payments SET state='closed',note=? WHERE pay_id=?", ("创建失败:%s" % e, p["pay_id"]))
core.event(chname, "create_failed", p["pay_id"], o["oid"], "error", repr(e))
return {"ok": False, "error": "%s暂时不可用,请换爱发电付款" % ch.label}
core.set_display(p["pay_id"], disp)
return {"ok": True, "payment": pay_view(core.get_payment(p["pay_id"]))}
def buyer_check(o):
"""买家点「付好了没反应?」→ 立刻把这单所有没到账的支付单查一遍。"""
core.x("UPDATE orders SET buyer_claim_at=? WHERE oid=?", (core.now(), o["oid"]))
core.event("", "buyer_check", "", o["oid"], "requested")
found = []
for p in core.order_payments(o["oid"]):
if p["state"] in ("created", "closed"):
try:
r = core.poll_payment(channels.get(p["channel"]), p, "buyer_check")
found.append(r["result"])
except Exception as e:
core.event(p["channel"], "query_failed", p["pay_id"], o["oid"], "error", repr(e))
o2 = core.get_order(o["oid"])
if o2["state"] == "waiting":
return {"ok": True, "found": True, "msg": "找到了,已到账 —— 正在排队出图"}
if "short" in found:
return {"ok": True, "found": True, "msg": "收到了付款,但金额不足,已通知金钻核对"}
return {"ok": True, "found": False, "msg": "暂时还没查到到账。刚付完可能要等几十秒;超过几分钟还没有,请点「呼叫金钻」。"}
def handle_notify(chname, body, ctype):
ch = channels.get(chname)
try:
facts, why, resp = ch.verify_notify(body, ctype)
except Exception as e:
core.event(chname, "notify", "", "", "error", repr(e))
return resp_default(chname)
core.event(chname, "notify", (facts or {}).get("pay_id", ""), "", why,
body.decode("utf-8", "replace") if isinstance(body, bytes) else str(body))
if facts:
if not facts["pay_id"]:
# 没带 custom_order_id:买家直接在爱发电店铺下的单 → 按「买卡密」处理(正式版沿用现有发码逻辑)
core.event(chname, "card_purchase", "", "", "(原型)会按实付金额发一张卡密",
{"trade_no": facts["trade_no"], "amount": facts["amount"]})
else:
core.settle_payment(chname, facts["pay_id"], facts["trade_no"], facts["amount"], "notify", facts["raw"])
return resp
def resp_default(chname):
return json.dumps({"ec": 200, "em": ""}) if chname == "afdian" else "fail"
def admin_overview():
return {"ok": True, "now": core.now(), "clock_offset": core.kv_get("clock_offset", 0),
"todo": core.q("SELECT * FROM pay_todo ORDER BY state='done', id DESC LIMIT 100"),
"payments": [dict(pay_view(p, False), oid=p["oid"]) for p in
core.q("SELECT * FROM payments ORDER BY created_at DESC LIMIT 60")],
"orders": core.q("SELECT oid,state,amount,created_at,paid_at,closed_at,buyer_claim_at FROM orders "
"ORDER BY created_at DESC LIMIT 40"),
"events": core.q("SELECT * FROM pay_events ORDER BY id DESC LIMIT 80"),
"breaker": channels.get("alipay").breaker(),
"channels": [{"name": c.name, "label": c.label, "mock": c.mock} for c in channels.all_channels()],
"mock_alipay_risk": bool(core.kv_get("mock_alipay_risk"))}
def admin_todo(d):
t = core.q1("SELECT * FROM pay_todo WHERE id=?", (int(d.get("id") or 0),))
if not t:
return {"ok": False, "error": "没有这条待办"}
act, note = d.get("action"), str(d.get("note") or "")[:200]
p = core.get_payment(t["pay_id"]) if t["pay_id"] else None
msg = ""
if act == "confirm": # 金额不足 → 人工确认补齐,按到账处理
if not p:
return {"ok": False, "error": "这条待办没有关联支付单"}
core.x("UPDATE payments SET state='paid',note='人工确认补齐' WHERE pay_id=?", (p["pay_id"],))
core.x("UPDATE orders SET state='waiting',paid_at=? WHERE oid=? AND state IN ('unpaid','closed')",
(core.now(), p["oid"]))
msg = "已确认,订单激活"
elif act == "activate":
core.x("UPDATE orders SET state='waiting',paid_at=? WHERE oid=? AND state IN ('unpaid','closed','void')",
(core.now(), t["oid"]))
msg = "订单已手动激活"
elif act == "refund":
if not p:
return {"ok": False, "error": "这条待办没有关联支付单"}
amt = float(t["amount_paid"] or p["amount_paid"] or 0)
try:
ch = channels.get(p["channel"])
if t["kind"] == "duplicate" and t["trade_no"] and t["trade_no"] != p["trade_no"]:
return {"ok": False, "error": "重复付款的第二笔不在本地支付单上:请到%s后台按交易号 %s 退款" % (ch.label, t["trade_no"])}
ch.refund(p, amt)
core.x("UPDATE payments SET state='refunded',note='已退款 ¥%.2f' WHERE pay_id=?" % amt, (p["pay_id"],))
msg = "已退款 ¥%.2f" % amt
except Exception as e:
return {"ok": False, "error": str(e)}
elif act != "ignore":
return {"ok": False, "error": "不认识的操作"}
core.x("UPDATE pay_todo SET state='done',resolution=?,resolved_at=? WHERE id=?",
("%s:%s %s" % (act, msg, note), core.now(), t["id"]))
core.event(t["channel"] or "", "todo_resolved", t["pay_id"] or "", t["oid"] or "", act, note)
return {"ok": True, "msg": msg or "已处理"}
def admin_claim(d):
"""按爱发电订单号认领到某张订单(买家没走专链、或 custom_order_id 丢了)。"""
o = core.get_order(str(d.get("oid") or "").upper())
if not o:
return {"ok": False, "error": "没有这张订单"}
ch = channels.get("afdian")
real = ch.query_trade(str(d.get("trade_no") or "").strip())
if not real:
return {"ok": False, "error": "爱发电查不到这个订单号"}
f = ch.facts(real)
if not f["paid"]:
return {"ok": False, "error": "这笔爱发电订单还没付款"}
p = core.new_payment(o, "afdian", ch.ttl())
r = core.settle_payment("afdian", p["pay_id"], f["trade_no"], f["amount"], "admin_claim", f["raw"])
return {"ok": True, "msg": "认领结果:%s" % r["result"]}
def demo(d):
k = d.get("kind")
if k == "clock":
core.advance_clock(float(d.get("seconds") or 0))
return {"ok": True, "jobs": core.run_jobs()}
if k == "jobs":
return {"ok": True, "jobs": core.run_jobs()}
if k == "alipay_risk":
core.kv_set("mock_alipay_risk", bool(d.get("on")))
return {"ok": True}
if k == "breaker_reset":
core.kv_set("alipay_breaker", {"fails": 0, "open_until": 0, "reason": ""})
return {"ok": True}
if k == "afdian_direct":
o = mockgw.afd_create_order("", d.get("amount") or 12, "直接在爱发电店铺下单(没带订单号)")
return {"ok": True, "trade_no": o["out_trade_no"]}
if k == "afdian_forge":
fake = {"out_trade_no": "FORGED" + secrets.token_hex(4), "custom_order_id": str(d.get("pay_id") or ""),
"user_id": "evil", "plan_id": "mock-plan", "total_amount": "999.00", "status": 2,
"remark": "", "create_time": int(core.now())}
return {"ok": True, "result": mockgw.afd_push(fake, forge=True)}
return {"ok": False, "error": "unknown"}
# ---------------------------------------------------------------- HTTP
class H(BaseHTTPRequestHandler):
server_version = "jz-pay-proto"
def log_message(self, fmt, *a):
pass
def send(self, code, ctype, body, extra=None):
if isinstance(body, str):
body = body.encode("utf-8")
self.send_response(code)
self.send_header("Content-Type", ctype)
self.send_header("Content-Length", str(len(body)))
self.send_header("Cache-Control", "no-store")
for k, v in (extra or {}).items():
self.send_header(k, v)
self.end_headers()
self.wfile.write(body)
def js(self, obj, code=200):
self.send(code, "application/json; charset=utf-8", json.dumps(obj, ensure_ascii=False))
def body(self):
n = int(self.headers.get("Content-Length") or 0)
return self.rfile.read(min(n, 65536)) if n > 0 else b""
def jbody(self):
try:
return json.loads(self.body() or b"{}")
except ValueError:
return {}
def order_auth(self, oid, tok):
o = core.get_order(str(oid or "").upper())
if not o or not secrets.compare_digest(o["token"], str(tok or "")):
return None
return o
def is_admin(self):
return secrets.compare_digest(self.headers.get("X-Admin-Token") or "", admin_token())
def static(self, name):
p = os.path.normpath(os.path.join(STATIC, name))
if not p.startswith(STATIC + os.sep) or not os.path.isfile(p):
return self.send(404, "text/plain; charset=utf-8", "not found")
ctype = (mimetypes.guess_type(p)[0] or "application/octet-stream")
if ctype.startswith("text/") or ctype.endswith("javascript"):
ctype += "; charset=utf-8"
with open(p, "rb") as f:
self.send(200, ctype, f.read())
def do_GET(self):
u = urllib.parse.urlparse(self.path)
p, qs = u.path, urllib.parse.parse_qs(u.query)
g = lambda k: (qs.get(k) or [""])[0]
try:
if p in ("/", "/index.html"):
return self.static("index.html")
if p in ("/admin", "/admin.html"):
return self.static("admin.html")
if p.startswith("/static/"):
return self.static(p[len("/static/"):])
if p == "/api/order":
o = self.order_auth(g("oid"), g("t"))
return self.js(order_view(o)) if o else self.js({"ok": False, "error": "订单不存在"}, 404)
if p == "/api/pay":
pay = core.get_payment(g("pay_id"))
o = self.order_auth(pay["oid"] if pay else "", g("t"))
if not (pay and o):
return self.js({"ok": False, "error": "支付单不存在"}, 404)
gap = C.QUERY_MIN_GAP if pay["channel"] == "alipay" else 15
if pay["state"] == "created" and core.now() - (pay["last_query_at"] or 0) >= gap:
try:
core.poll_payment(channels.get(pay["channel"]), pay, "page_poll")
except Exception as e:
core.event(pay["channel"], "query_failed", pay["pay_id"], o["oid"], "error", repr(e))
return self.js(order_view(core.get_order(o["oid"])))
if p == "/api/admin/overview":
return self.js(admin_overview()) if self.is_admin() else self.js({"ok": False, "error": "口令不对"}, 403)
if p == "/mock/afdian/order/create":
return self.send(*mockgw.afd_checkout(qs))
if p.startswith("/mock/alipay/scan/"):
return self.send(*mockgw.ali_scan(p.rsplit("/", 1)[-1]))
return self.send(404, "text/plain; charset=utf-8", "not found")
except Exception as e:
core.event("", "http_error", "", "", p, repr(e))
return self.js({"ok": False, "error": "服务器出错了"}, 500)
def do_POST(self):
p = urllib.parse.urlparse(self.path).path
try:
if p == "/api/order":
o = core.new_order(self.jbody().get("n_img"))
return self.js(dict(order_view(o), token=o["token"]))
if p in ("/api/pay", "/api/check"):
d = self.jbody()
o = self.order_auth(d.get("oid"), d.get("t"))
if not o:
return self.js({"ok": False, "error": "订单不存在"}, 404)
return self.js(create_payment(o, d.get("channel")) if p == "/api/pay" else buyer_check(o))
if p == "/api/notify/afdian":
return self.send(200, "application/json", handle_notify("afdian", self.body(), self.headers.get("Content-Type")))
if p == "/api/notify/alipay":
return self.send(200, "text/plain", handle_notify("alipay", self.body(), self.headers.get("Content-Type")))
if p.startswith("/api/admin/"):
if not self.is_admin():
return self.js({"ok": False, "error": "口令不对"}, 403)
d = self.jbody()
if p == "/api/admin/todo":
return self.js(admin_todo(d))
if p == "/api/admin/claim":
return self.js(admin_claim(d))
return self.js({"ok": False, "error": "unknown"}, 404)
if p == "/api/demo":
return self.js(demo(self.jbody()))
if p == "/mock/afdian/order/pay":
return self.send(*mockgw.afd_pay(urllib.parse.parse_qs(self.body().decode())))
if p.startswith("/mock/afdian/api/open/"):
return self.send(*mockgw.afd_api(p, self.body()))
if p == "/mock/alipay/gateway.do":
return self.send(*mockgw.ali_gateway(self.body()))
if p == "/mock/alipay/scanpay":
return self.send(*mockgw.ali_scanpay(urllib.parse.parse_qs(self.body().decode())))
return self.js({"ok": False, "error": "not found"}, 404)
except Exception as e:
core.event("", "http_error", "", "", p, repr(e))
return self.js({"ok": False, "error": "服务器出错了"}, 500)
def main():
core.db()
mockgw.init()
channels.init()
admin_token() # 首次启动就生成后台口令(data/admin_token,600)
core.start_scheduler()
print("支付原型启动 :%d 对外 %s 爱发电=%s 当面付=%s" % (
C.PORT, C.BASE_URL, "模拟" if channels.get("afdian").mock else "真实",
"模拟" if channels.get("alipay").mock else "真实"), flush=True)
ThreadingHTTPServer(("127.0.0.1", C.PORT), H).serve_forever()
if __name__ == "__main__":
main()