Files
ywsandClaude Opus 5.5 56c1fa648a 收款原型 pay-proto:渠道抽象层 + 爱发电主通道 + 当面付辅助通道(占位符配置,内置模拟网关)
- 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>
2026-10-07 05:53:12 +00:00

374 lines
15 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
"""支付渠道抽象层。
每个渠道只做五件事:生成付款方式 create / 验证回调 verify_notify / 主动查单 query / 关单 close / 退款 refund。
到账一律交给 core.settle_payment(),渠道自己不改订单。
「事实」facts = {"pay_id", "trade_no", "amount", "paid", "raw"},只来自验过真的数据。
"""
import base64, hashlib, json, os, re, time, urllib.parse, urllib.request
from datetime import datetime, timedelta, timezone
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding
from cryptography.exceptions import InvalidSignature
import config as C
import core
CST = timezone(timedelta(hours=8))
# ---------------------------------------------------------------- RSA 小工具(签名 / 验签分开两把钥匙)
def load_pub(path):
with open(path, "rb") as f:
data = f.read()
if b"BEGIN" not in data: # 支付宝后台给的常是不带头尾的一行 base64
data = b"-----BEGIN PUBLIC KEY-----\n" + data.strip() + b"\n-----END PUBLIC KEY-----\n"
return serialization.load_pem_public_key(data)
def load_priv(path):
with open(path, "rb") as f:
return serialization.load_pem_private_key(f.read(), password=None)
def rsa_sign(priv, text):
return base64.b64encode(priv.sign(text.encode("utf-8"), padding.PKCS1v15(), hashes.SHA256())).decode()
def rsa_verify(pub, text, sig_b64):
try:
pub.verify(base64.b64decode(sig_b64 or ""), text.encode("utf-8"), padding.PKCS1v15(), hashes.SHA256())
return True
except (InvalidSignature, ValueError, TypeError):
return False
def http_post(url, body, ctype, timeout=10):
req = urllib.request.Request(url, data=body, method="POST", headers={"Content-Type": ctype})
with urllib.request.urlopen(req, timeout=timeout) as r:
return r.read().decode("utf-8")
def fmt_cst(ts):
return datetime.fromtimestamp(ts, CST).strftime("%Y-%m-%d %H:%M:%S")
# ---------------------------------------------------------------- 基类
class Channel:
name = ""
label = ""
mock = False
def available(self, order):
return True, ""
def ttl(self):
return 3600
def create(self, order, pay):
raise NotImplementedError
def verify_notify(self, body, ctype):
"""返回 (facts 或 None, 说明, 给渠道的应答文本)"""
raise NotImplementedError
def query(self, pay):
return None
def close(self, pay):
return True
def refund(self, pay, amount):
raise RuntimeError("这个渠道不支持接口退款")
# ================================================================ 爱发电
class Afdian(Channel):
name, label = "afdian", "爱发电"
def __init__(self):
cfg = dict(C.AFDIAN)
self.mock = any(C.is_placeholder(v) for v in cfg.values())
if self.mock:
import mockgw
cfg.update(user_id="mock-user", token="mock-token", plan_id="mock-plan",
pubkey_file=mockgw.key_path("afdian_platform", public=True),
api=C.INTERNAL_URL + "/mock/afdian/api/open",
checkout=C.BASE_URL + "/mock/afdian/order/create")
self.cfg = cfg
self.pub = load_pub(cfg["pubkey_file"]) if os.path.exists(cfg["pubkey_file"]) else None
def ttl(self):
return C.AFD_TTL
def create(self, order, pay):
qs = urllib.parse.urlencode({"user_id": self.cfg["user_id"], "plan_id": self.cfg["plan_id"],
"product_type": 0, "custom_price": pay["amount_due"],
"custom_order_id": pay["pay_id"], "remark": order["oid"]})
url = self.cfg["checkout"] + "?" + qs
return {"type": "redirect", "url": url, "qr": url}
# ---- OpenAPI:sign = md5(token + "params" + params + "ts" + ts + "user_id" + user_id)
def api(self, path, params):
p = json.dumps(params, separators=(",", ":"))
ts = int(time.time())
sign = hashlib.md5(("%sparams%sts%duser_id%s" % (self.cfg["token"], p, ts, self.cfg["user_id"]))
.encode()).hexdigest()
body = json.dumps({"user_id": self.cfg["user_id"], "params": p, "ts": ts, "sign": sign}).encode()
r = json.loads(http_post(self.cfg["api"] + "/" + path, body, "application/json"))
if r.get("ec") != 200:
raise RuntimeError("爱发电接口错误:%s %s" % (r.get("ec"), r.get("em")))
return r.get("data") or {}
@staticmethod
def facts(o):
return {"pay_id": str(o.get("custom_order_id") or ""), "trade_no": str(o.get("out_trade_no") or ""),
"amount": float(o.get("total_amount") or 0), "paid": int(o.get("status") or 0) == 2,
"raw": json.dumps(o, ensure_ascii=False)[:2000]}
def query_trade(self, out_trade_no):
lst = (self.api("query-order", {"out_trade_no": out_trade_no}).get("list") or [])
return lst[0] if lst else None
def list_paid_since(self, since_ts, max_pages=10):
"""从最新往前翻,翻到早于 since_ts 为止;只返回已付款的。"""
out = []
for page in range(1, max_pages + 1):
d = self.api("query-order", {"page": page})
lst = d.get("list") or []
for o in lst:
if int(o.get("status") or 0) == 2:
out.append(self.facts(o))
if not lst or page >= int(d.get("total_page") or 1) or \
min(float(o.get("create_time") or 0) for o in lst) < since_ts:
break
return out
def verify_notify(self, body, ctype):
ok_resp = json.dumps({"ec": 200, "em": ""})
try:
obj = json.loads(body or b"{}")
except ValueError:
return None, "报文不是 JSON", ok_resp
data = obj.get("data") or {}
o = data.get("order") or {}
otn = str(o.get("out_trade_no") or "")
if not otn:
return None, "缺 out_trade_no", ok_resp
# ① 验签:out_trade_no + user_id + plan_id + total_amount,平台公钥,SHA256,Base64
if self.pub is not None:
content = "%s%s%s%s" % (otn, o.get("user_id") or "", o.get("plan_id") or "", o.get("total_amount") or "")
if not rsa_verify(self.pub, content, data.get("sign")):
return None, "验签失败", ok_resp
# ② 用开放接口按订单号精确反查,之后只认反查结果
real = self.query_trade(otn)
if not real:
return None, "接口反查不到这笔单", ok_resp
f = self.facts(real)
if not f["paid"]:
return None, "反查结果未付款", ok_resp
return f, "ok", ok_resp
def query(self, pay):
for f in self.list_paid_since(pay["created_at"] - 600, max_pages=5):
if f["pay_id"] == pay["pay_id"]:
return f
return None
def close(self, pay):
return True # 爱发电无法远程关单,只在本地标记
def refund(self, pay, amount):
raise RuntimeError("爱发电没有退款接口:请到爱发电后台对订单 %s 手动退款" % pay.get("trade_no"))
# ================================================================ 支付宝当面付
RISK_CODES = ("ACQ.ACCESS_FORBIDDEN", "ACQ.SELLER_BEEN_BLOCKED", "ACQ.RISK_CONTROL", "isv.insufficient-isv-permissions",
"ACQ.MERCHANT_STATUS_NOT_NORMAL", "ACQ.PAYMENT_AUTH_CODE_INVALID")
class AlipayF2F(Channel):
name, label = "alipay", "支付宝扫码"
def __init__(self):
cfg = dict(C.ALIPAY)
self.mock = any(C.is_placeholder(cfg[k]) for k in ("app_id", "app_private_key_file", "alipay_public_key_file"))
if self.mock:
import mockgw
cfg.update(app_id="mock-app", app_private_key_file=mockgw.key_path("alipay_app"),
alipay_public_key_file=mockgw.key_path("alipay_platform", public=True),
gateway=C.INTERNAL_URL + "/mock/alipay/gateway.do")
self.cfg = cfg
self.priv = load_priv(cfg["app_private_key_file"])
self.pub = load_pub(cfg["alipay_public_key_file"])
def ttl(self):
return C.QR_TTL
# ---- 熔断(连续失败 / 风控类错误码 → 关 6 小时)
def breaker(self):
return core.kv_get("alipay_breaker", {"fails": 0, "open_until": 0, "reason": ""})
def _ok(self):
b = self.breaker()
if b["fails"]:
b["fails"] = 0
core.kv_set("alipay_breaker", b)
def _fail(self, reason, risk=False):
b = self.breaker()
b["fails"] += 1
b["reason"] = reason
if risk or b["fails"] >= C.BREAKER_FAILS:
b["open_until"] = core.now() + C.BREAKER_COOL
core.event("alipay", "breaker_open", "", "", reason, b)
core.kv_set("alipay_breaker", b)
def available(self, order):
b = self.breaker()
if b["open_until"] > core.now():
return False, "支付宝扫码暂时不可用"
if order["amount"] > C.ALI_MAX_AMOUNT:
return False, "金额超过 ¥%d,请用爱发电" % C.ALI_MAX_AMOUNT
t = core.now()
n_order = core.q1("SELECT COUNT(*) AS c FROM payments WHERE oid=? AND channel='alipay' AND created_at>?",
(order["oid"], t - 600))["c"]
if n_order >= C.ALI_PER_ORDER_10MIN:
return False, "二维码生成太频繁,稍后再试或用爱发电"
n_all = core.q1("SELECT COUNT(*) AS c FROM payments WHERE channel='alipay' AND state='created'")["c"]
if n_all >= C.ALI_GLOBAL_PENDING:
return False, "当前扫码人数较多,请用爱发电"
return True, ""
# ---- 网关调用:请求用应用私钥签,响应用支付宝公钥验
def call(self, method, biz, notify=False):
params = {"app_id": self.cfg["app_id"], "method": method, "format": "JSON", "charset": "utf-8",
"sign_type": "RSA2", "timestamp": fmt_cst(time.time()), "version": "1.0",
"biz_content": json.dumps(biz, ensure_ascii=False, separators=(",", ":"))}
if notify:
params["notify_url"] = C.BASE_URL + "/api/notify/alipay"
params["sign"] = rsa_sign(self.priv, "&".join("%s=%s" % (k, params[k]) for k in sorted(params)))
try:
text = http_post(self.cfg["gateway"], urllib.parse.urlencode(params).encode(),
"application/x-www-form-urlencoded;charset=utf-8")
except Exception as e:
self._fail("网关不通:%r" % e)
raise
node = method.replace(".", "_") + "_response"
raw_node = extract_json_node(text, node)
sign = json.loads(text).get("sign")
if raw_node is None or not rsa_verify(self.pub, raw_node, sign):
self._fail("响应验签失败")
raise RuntimeError("支付宝响应验签失败")
r = json.loads(raw_node)
code, sub = str(r.get("code")), str(r.get("sub_code") or "")
if code != "10000" and sub in RISK_CODES:
self._fail("风控/权限:%s %s" % (sub, r.get("sub_msg")), risk=True)
elif code in ("10000", "40004"):
self._ok()
else:
self._fail("%s %s" % (code, sub))
return r
def create(self, order, pay):
r = self.call("alipay.trade.precreate", {
"out_trade_no": pay["pay_id"], "total_amount": "%.2f" % pay["amount_due"],
"subject": "%s %s" % (self.cfg["subject"], order["oid"]),
"time_expire": fmt_cst(core.now() + C.QR_TTL)}, notify=True)
if str(r.get("code")) != "10000":
raise RuntimeError("预下单失败:%s %s" % (r.get("sub_code") or r.get("code"), r.get("sub_msg") or r.get("msg")))
return {"type": "qr", "qr": r["qr_code"], "expire_at": pay["expire_at"]}
def query(self, pay):
r = self.call("alipay.trade.query", {"out_trade_no": pay["pay_id"]})
if str(r.get("code")) != "10000":
return None
st = r.get("trade_status")
return {"pay_id": pay["pay_id"], "trade_no": str(r.get("trade_no") or ""),
"amount": float(r.get("total_amount") or 0), "paid": st in ("TRADE_SUCCESS", "TRADE_FINISHED"),
"raw": json.dumps(r, ensure_ascii=False)}
def close(self, pay):
r = self.call("alipay.trade.close", {"out_trade_no": pay["pay_id"]})
return str(r.get("code")) == "10000" or r.get("sub_code") == "ACQ.TRADE_NOT_EXIST"
def refund(self, pay, amount):
r = self.call("alipay.trade.refund", {"out_trade_no": pay["pay_id"], "refund_amount": "%.2f" % amount,
"out_request_no": "%sR%d" % (pay["pay_id"], int(time.time()))})
if str(r.get("code")) != "10000":
raise RuntimeError("退款失败:%s %s" % (r.get("sub_code"), r.get("sub_msg")))
return r
def verify_notify(self, body, ctype):
form = dict(urllib.parse.parse_qsl((body or b"").decode("utf-8"), keep_blank_values=True))
sign = form.pop("sign", "")
form.pop("sign_type", None)
content = "&".join("%s=%s" % (k, form[k]) for k in sorted(form) if form[k] != "")
if not rsa_verify(self.pub, content, sign):
return None, "验签失败", "fail"
if form.get("app_id") != self.cfg["app_id"]:
return None, "app_id 不符", "fail"
f = {"pay_id": form.get("out_trade_no", ""), "trade_no": form.get("trade_no", ""),
"amount": float(form.get("total_amount") or 0),
"paid": form.get("trade_status") in ("TRADE_SUCCESS", "TRADE_FINISHED"),
"raw": json.dumps(form, ensure_ascii=False)}
if not f["paid"]:
return None, "状态 %s,不是到账" % form.get("trade_status"), "success"
return f, "ok", "success"
def extract_json_node(text, key):
"""取出响应里某个节点的**原始 JSON 文本**(支付宝对原文签名,不能先解析再序列化)。"""
m = re.search(r'"%s"\s*:\s*' % re.escape(key), text)
if not m:
return None
i = m.end()
if i >= len(text) or text[i] != "{":
return None
depth, in_str, esc = 0, False, False
for j in range(i, len(text)):
ch = text[j]
if in_str:
if esc:
esc = False
elif ch == "\\":
esc = True
elif ch == '"':
in_str = False
elif ch == '"':
in_str = True
elif ch == "{":
depth += 1
elif ch == "}":
depth -= 1
if depth == 0:
return text[i:j + 1]
return None
# ---------------------------------------------------------------- 注册表
_CH = {}
def init():
_CH["afdian"] = Afdian()
_CH["alipay"] = AlipayF2F()
def get(name):
return _CH[name]
def all_channels():
return [_CH["afdian"], _CH["alipay"]]
def safe_close(pay):
try:
get(pay["channel"]).close(pay)
core.event(pay["channel"], "close", pay["pay_id"], pay["oid"], "ok")
except Exception as e:
core.event(pay["channel"], "close", pay["pay_id"], pay["oid"], "error", repr(e))