- 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>
374 lines
15 KiB
Python
374 lines
15 KiB
Python
# -*- 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))
|