API 接口总览

嗖付聚合支付提供完整的支付解决方案，涵盖订单管理、退款处理、账户查询等功能。

📝 订单接口

接口名称	接口地址	描述
聚合支付统一下单	/api/v1/pay/unified-order	创建支付订单，支持微信、支付宝等多种支付方式
订单查询	/api/v1/pay/query-order	查询订单支付状态和详细信息

💎 退款接口

接口名称	接口地址	描述
申请退款	/api/v1/pay/refund	对已支付订单发起退款申请
退款查询	/api/v1/pay/query-refund	查询退款申请的处理状态

💼 账户接口

接口名称	接口地址	描述
账户余额查询	/api/v1/account/balance	查询商户账户当前余额信息
待结算查询	/api/v1/account/pending-settlement	查询待结算资金明细

📡 通知机制

功能	描述
异步通知	支付结果、退款结果的异步通知机制

接口调用流程

graph TD
    A[商户系统] --> B[调用统一下单接口]
    B --> C[获取支付链接/二维码]
    C --> D[用户完成支付]
    D --> E[接收异步通知]
    E --> F[调用订单查询确认]
    F --> G[更新订单状态]

    G --> H{需要退款?}
    H -->|是| I[调用退款接口]
    H -->|否| J[交易完成]
    I --> K[调用退款查询]
    K --> L[处理退款结果]

推荐阅读顺序

1. 聚合支付统一下单 - 核心支付接口
2. 异步通知处理 - 支付结果处理
3. 订单查询 - 订单状态确认
4. 申请退款 - 退款处理流程