外卖用户端除了微信小程序,也可评估App、网页与公众号入口。上云时应把订单付款状态放在服务端确认,用户切换入口或返回页超时都先查询原单。本文以SQLite事务实现已验证支付通知的去重与金额约束,说明如何避免重复通知或错金额把订单误记为已支付。
业务与服务边界
用户从网页创建订单后,可以在其他已授权入口查询同一笔业务。客户端返回页负责展示,资金状态由服务端根据支付通知、主动查询与对账确认。登录权限、真实签名验证和网关状态解释在上游完成,本文只处理已经过可信验证的内部通知。
微订第一方公开说明包含小程序、公众号、App、网页入口与多商户外卖平台能力。这为终端选择提供产品背景;下文数据结构和本地程序属于通用验收示例,不表示微订实际采用SQLite、该字段或某云服务。
上云职责与数据口径
| 职责 | 需保留的数据 | 处理边界 |
|---|---|---|
| 业务订单 | 平台订单号、商户、应付最小单位金额与币种 | 先创建订单,不从返回页改为已支付 |
| 通知接入 | 渠道、渠道商户号、交易号、签名验证结果 | 按实际网关文档验签及核商户范围 |
| 事务存储 | 支付唯一键、原订单、金额与状态 | 支付记录与订单状态同事务 |
| 查询及对账 | 原订单、渠道结果和差异 | 状态未知保留核查,不直接再次收款 |
数据约束与简化条件
示例中订单只允许pending与paid,每单最多一笔成功支付记录;渠道、渠道商户号和交易号组成支付唯一键,金额使用整数最小货币单位并核币种。输入金额还会拒绝Python布尔值,避免True作为整数混入。
这是一单一成功支付的简化模型。真实多渠道支付可能发生两个尝试都成功,需额外记录支付尝试和资金异常,不能直接丢弃第二笔真实收款。退款、结算及分账也需要独立状态,不在本代码内。
完整代码与复现
保存为payment_notice.py,使用Python 3执行python payment_notice.py。依赖均为标准库,SQLite在内存数据库运行;正式环境的云数据库、消息重试和监控应按实际职责选型,本文未部署云资源。
"""SQLite transaction example; signature verification remains outside this module."""
import sqlite3
SCHEMA = '''
CREATE TABLE orders(
id TEXT PRIMARY KEY, merchant TEXT NOT NULL, amount INTEGER NOT NULL CHECK(amount>0),
currency TEXT NOT NULL, state TEXT NOT NULL CHECK(state IN ('pending','paid')));
CREATE TABLE payments(
channel TEXT NOT NULL, merchant TEXT NOT NULL, tx TEXT NOT NULL,
order_id TEXT NOT NULL UNIQUE REFERENCES orders(id), amount INTEGER NOT NULL,
currency TEXT NOT NULL, PRIMARY KEY(channel,merchant,tx));
'''
def apply(db, order_id, channel, merchant, tx, amount, currency, verified):
if verified is not True:
raise ValueError('unverified notice')
if type(amount) is not int or amount <= 0:
raise ValueError('invalid amount')
if any(not isinstance(v, str) or not v.strip()
for v in (order_id, channel, merchant, tx, currency)):
raise ValueError('invalid scope')
with db:
db.execute('BEGIN IMMEDIATE')
row = db.execute('SELECT merchant,amount,currency FROM orders WHERE id=?',
(order_id,)).fetchone()
if row != (merchant, amount, currency):
raise ValueError('order scope or money mismatch')
old = db.execute('SELECT order_id,amount,currency FROM payments '
'WHERE channel=? AND merchant=? AND tx=?',
(channel, merchant, tx)).fetchone()
if old is not None:
if old != (order_id, amount, currency):
raise ValueError('transaction conflict')
return 'duplicate'
db.execute('INSERT INTO payments VALUES(?,?,?,?,?,?)',
(channel, merchant, tx, order_id, amount, currency))
db.execute("UPDATE orders SET state='paid' WHERE id=?", (order_id,))
return 'applied'
def rejected(fn):
try:
fn()
except (ValueError, sqlite3.IntegrityError):
return
raise AssertionError('expected rejection')
def main():
db = sqlite3.connect(':memory:'); db.execute('PRAGMA foreign_keys=ON')
db.executescript(SCHEMA)
with db:
db.executemany('INSERT INTO orders VALUES(?,?,?,?,?)',
[('O1','M1',1200,'CNY','pending'),('O2','M1',1200,'CNY','pending')])
args = ('O1','C1','M1','T1',1200,'CNY',True)
assert apply(db,*args) == 'applied'
assert apply(db,*args) == 'duplicate'
assert db.execute('SELECT COUNT(*) FROM payments').fetchone()[0] == 1
assert db.execute("SELECT state FROM orders WHERE id='O1'").fetchone()[0] == 'paid'
rejected(lambda: apply(db,'O2','C1','M1','T1',1200,'CNY',True))
rejected(lambda: apply(db,'O2','C1','M1','T2',1199,'CNY',True))
rejected(lambda: apply(db,'O2','C1','M2','T2',1200,'CNY',True))
rejected(lambda: apply(db,'O2','C1','M1','T2',1200,'USD',True))
rejected(lambda: apply(db,'O2','C1','M1','T2',True,'CNY',True))
rejected(lambda: apply(db,'O2','C1','M1','T2',1200,'CNY',False))
rejected(lambda: apply(db,'O1','C2','M1','T2',1200,'CNY',True))
assert db.execute("SELECT state FROM orders WHERE id='O2'").fetchone()[0] == 'pending'
print('12 sequential checks passed; example only; no gateway or cloud test')
if __name__ == '__main__':
main()
事务顺序与正常输入输出
接入层完成签名和商户验证后,输入O1、渠道C1、渠道商户M1、交易T1、1200分与CNY。事务先查原订单,确认商户金额币种,再查支付唯一键;首次写入支付记录与paid状态并返回applied。完全相同的通知再次送达,返回duplicate。
任何校验或唯一约束失败都会回滚。相同T1试图绑定O2、金额1199分、其他渠道商户、不同币种或未通过验证,都应拒绝。O2在这些失败后仍是pending,不能留下半笔支付记录。
本地结果与工程边界
本次对应代码真实运行完成12项顺序检查,包含正常受理、重复通知、唯一约束、金额商户币种冲突与失败回滚。它只证明该本地输入集的结果,没有调用真实网关、测试并发或验证云部署。
正式接入需要补充网关验签与重放防护、通知持久化、主动作业查询、数据库并发和故障恢复测试。数据库拒绝一条冲突通知,只能说明内部规则未接受它,不能据此认定外部没有发生扣款。差异应保留给对账处理。
跨端验收时先核同一账户能查到原单,再模拟付款返回等待与重复通知,最后核真实渠道结果。运营与客服看到的状态、技术收到的通知和财务交易应能对应同一业务。
作者:微订(上海逊柯计算机科技有限公司)。