# 回调通知

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /:
    post:
      summary: 回调通知
      deprecated: false
      description: |-
        特别提醒：商户系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息是否与商户侧的信息一致，防止数据泄露导致出现“假通知”，造成资金损失。

        只推送这些状态（3-已完成，4-已取消，5-已退款，11-处理失败）

        如果平台收到商户的应答不符合规范或超时，则认为通知失败，平台会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但不保证通知最终能成功。
        （通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m）

        平台判断成功规则
        1. json结构，code==200
        2. ok
        3. success
      tags:
        - 接口列表/订单接口
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                cardList:
                  type: array
                  items:
                    type: object
                    properties:
                      cardNo:
                        type: string
                        description: 卡号
                      cardPwd:
                        type: string
                        description: 卡密
                      expireTime:
                        type: string
                        description: 有效期
                    x-apifox-orders:
                      - cardNo
                      - cardPwd
                      - expireTime
                  description: 卡信息
                sign:
                  type: string
                  description: 签名
                finishTime:
                  type: string
                  description: 完成时间（毫秒）
                nonce:
                  type: string
                  description: 随机串
                outOrderNo:
                  type: string
                  description: 商户侧订单号
                appId:
                  type: string
                  description: appId
                timestamp:
                  type: string
                  description: 时间戳
                status:
                  type: string
                  description: >-
                    状态（-1-下单失败，1-待处理，2-处理中，3-已完成，4-已取消，5-已退款，6-异常，7-待同步，8-取消中，9-退款中，11-处理失败）
                orderNo:
                  type: string
                  description: 平台单号
                totalPrice:
                  type: number
                  description: 售价（单位：分）
              required:
                - cardList
                - orderNo
                - totalPrice
                - sign
                - finishTime
                - nonce
                - outOrderNo
                - appId
                - timestamp
                - status
              x-apifox-orders:
                - cardList
                - orderNo
                - totalPrice
                - sign
                - finishTime
                - nonce
                - outOrderNo
                - appId
                - timestamp
                - status
            example:
              cardList:
                - cardNo: '925341'
                  cardPwd: 9AhgdPdw
                  expireTime: '2025-03-30 23:59:59'
              orderNo: '2025030419376567239848280065'
              totalPrice: '20'
              sign: d98ae23bb9809c841346e53352ec249b
              finishTime: '1743265309549'
              nonce: '3298961688'
              outOrderNo: '2025030419376567234546679809'
              appId: xxxxxxxxxx
              timestamp: '1741088249923'
              status: '3'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: 状态码
                  msg:
                    type: 'null'
                    description: 信息
                  data:
                    type: 'null'
                    description: 数据
                required:
                  - code
                  - msg
                  - data
                x-apifox-orders:
                  - code
                  - msg
                  - data
              example:
                code: 200
                msg: null
                data: null
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: 接口列表/订单接口
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/5657281/apis/api-260030651-run
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

```