Files
jinzuanwork/backend/pay-proto/README.md
T
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

1.9 KiB
Raw Blame History

收款原型(pay-proto)

设计文档里「渠道抽象层 + 爱发电主通道 + 当面付辅助通道」的可运行原型。 标准库 + SQLite + cryptography,只绑 127.0.0.1,由 nginx 反代。

占位符

config.py 里所有账号 / 密钥都是 <占位符>。值还是占位符的渠道,自动接到内置的模拟网关(mockgw.py): 签名、验签、HTTP 调用都是真实代码,只是对面换成模拟的爱发电 / 支付宝。填上真实值(环境变量)即切到真渠道。

环境变量 说明
AFDIAN_USER_ID / AFDIAN_TOKEN 爱发电开放接口(query-order 的 md5 签名)
AFDIAN_PUBKEY_FILE 爱发电 Webhook 验签公钥(PEM)
AFDIAN_PLAN_ID 承载 custom_price 的「自选金额」方案
ALIPAY_APP_ID 当面付应用 AppID
ALIPAY_APP_PRIVATE_KEY_FILE 应用私钥(PEM,权限 600,只放服务器)
ALIPAY_PUBLIC_KEY_FILE 支付宝公钥(验响应 / 异步通知)
PAY_ADMIN_TOKEN 后台口令;占位符时首次启动自动生成到 data/admin_token
PAY_BASE_URL / PAY_PORT / PAY_DATA_DIR 对外地址 / 端口 / 数据目录

结构

  • core.py:数据库、演示时钟、统一到账入口 settle_payment()、定时任务(爱发电对账 / 当面付补查 / 支付单过期 / 订单超时 / 迟到扫描)
  • channels.py:渠道抽象层,Afdian、AlipayF2F(create / verify_notify / query / close / refund)
  • mockgw.py:模拟网关(只在占位符时用)
  • app.py:HTTP 服务;static/:付款页、后台页、二维码库(qrcode-generator 1.4.4,MIT)

测试

python3 tests/test_proto.py:临时目录起一份服务,从 HTTP 层打 24 个场景。

预览部署(甲骨文 ARM)

/opt/jz-pay-proto + systemd jz-pay-proto(DynamicUser,数据 /var/lib/jz-pay-proto), nginx jz-preview.conf 里 /pay-proto/ 反代到 127.0.0.1:18100。