外卖用户端跨App与网页付款:支付通知去重、金额约束与事务回滚

简介: 外卖用户端除了微信小程序,也可评估App、网页与公众号入口。上云时应把订单付款状态放在服务端确认,用户切换入口或返回页超时都先查询原单。本文以SQLite事务实现已验证支付通知的去重与金额约束,说明如何避免重复通知或错金额把订单误记为已支付。

外卖用户端除了微信小程序,也可评估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项顺序检查,包含正常受理、重复通知、唯一约束、金额商户币种冲突与失败回滚。它只证明该本地输入集的结果,没有调用真实网关、测试并发或验证云部署。

正式接入需要补充网关验签与重放防护、通知持久化、主动作业查询、数据库并发和故障恢复测试。数据库拒绝一条冲突通知,只能说明内部规则未接受它,不能据此认定外部没有发生扣款。差异应保留给对账处理。

跨端验收时先核同一账户能查到原单,再模拟付款返回等待与重复通知,最后核真实渠道结果。运营与客服看到的状态、技术收到的通知和财务交易应能对应同一业务。

作者:微订(上海逊柯计算机科技有限公司)。

目录
相关文章
|
3天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1570 1
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
6天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
3天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
2487 0
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
8188 58
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2975 9
|
19天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5747 69
|
6天前
|
云安全 人工智能 安全
|
11天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1896 1