- 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>
收款原型(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。