@vobs/payment 0.3.0 → 1.2.0

package/src/alipay/alipay.test.ts

@@ -0,0 +1,231 @@
+import { describe, expect, it, vi } from 'vitest'
+import { AlipayConfig } from './config'
+import { AlipayApiError, unwrapResponse } from './response'
+import { createNotifyHandler } from './notify'
+import { createQuery } from './query'
+import { createRefund } from './refund'
+import { createWapPay } from './wap'
+import { alipayPlugin, ALIPAY_KEY } from './plugin'
+import type { AlipayClient } from './client'
+import type { AlipayClientOptions } from './types'
+import type { VobsContext } from '@vobs/vobs'
+
+function makeClient(sdkOverrides: Partial<AlipayClient['sdk']> = {}): AlipayClient {
+  const sdk = {
+    exec: vi.fn(),
+    checkNotifySign: vi.fn(),
+    pageExecute: vi.fn(),
+    ...sdkOverrides
+  }
+  const config = new AlipayConfig({
+    appId: '2021000000000000',
+    privateKey: 'test-private-key',
+    alipayPublicKey: 'test-public-key'
+  })
+  return { config, sdk } as unknown as AlipayClient
+}
+
+const baseNotify = {
+  appId: '2021000000000000',
+  outTradeNo: 'ORDER-1',
+  totalAmount: '299.00',
+  tradeStatus: 'TRADE_SUCCESS'
+}
+
+describe('alipay response unwrapping', () => {
+  it('unwrapResponse 业务失败时抛出 AlipayApiError 并携带 sub_code', () => {
+    try {
+      unwrapResponse({
+        alipay_trade_query_response: {
+          code: '40004',
+          msg: 'Business Failed',
+          sub_code: 'ACQ.TRADE_NOT_EXIST',
+          sub_msg: '交易不存在'
+        }
+      }, 'alipay.trade.query')
+      expect.unreachable()
+    } catch (error) {
+      expect(error).toBeInstanceOf(AlipayApiError)
+      const apiError = error as AlipayApiError
+      expect(apiError.code).toBe('40004')
+      expect(apiError.subCode).toBe('ACQ.TRADE_NOT_EXIST')
+      expect(apiError.message).toContain('ACQ.TRADE_NOT_EXIST')
+    }
+  })
+
+  it('unwrapResponse 成功响应返回业务体', () => {
+    const body = { code: '10000', msg: 'Success', trade_no: 'T-1' }
+    expect(unwrapResponse({ alipay_trade_query_response: body }, 'alipay.trade.query')).toBe(body)
+  })
+})
+
+describe('alipay query', () => {
+  it('query 成功时映射 snake_case 响应字段', async () => {
+    const client = makeClient()
+    ;(client.sdk.exec as ReturnType<typeof vi.fn>).mockResolvedValue({
+      alipay_trade_query_response: {
+        code: '10000',
+        msg: 'Success',
+        trade_no: 'T-1',
+        out_trade_no: 'ORDER-1',
+        buyer_logon_id: '138****8000',
+        trade_status: 'TRADE_SUCCESS',
+        total_amount: '299.00',
+        receipt_amount: '299.00',
+        buyer_pay_amount: '289.00'
+      }
+    })
+
+    const result = await createQuery(client).query({ outTradeNo: 'ORDER-1' })
+    expect(result.tradeStatus).toBe('TRADE_SUCCESS')
+    expect(result.totalAmount).toBe('299.00')
+    expect(result.buyerPayAmount).toBe('289.00')
+    expect(result.sendPayDate).toBe('')
+    expect(result.gmtClose).toBeNull()
+  })
+
+  it('query 业务失败时抛出 AlipayApiError，不返回伪成功结果', async () => {
+    const client = makeClient()
+    ;(client.sdk.exec as ReturnType<typeof vi.fn>).mockResolvedValue({
+      alipay_trade_query_response: {
+        code: '40004',
+        sub_code: 'ACQ.TRADE_NOT_EXIST',
+        sub_msg: '交易不存在'
+      }
+    })
+
+    await expect(createQuery(client).query({ outTradeNo: 'ORDER-404' }))
+      .rejects.toThrow('ACQ.TRADE_NOT_EXIST')
+  })
+})
+
+describe('alipay refund', () => {
+  it('refund 成功时映射 refund_fee 并提供默认值', async () => {
+    const client = makeClient()
+    ;(client.sdk.exec as ReturnType<typeof vi.fn>).mockResolvedValue({
+      alipay_trade_refund_response: {
+        code: '10000',
+        trade_no: 'T-1',
+        out_trade_no: 'ORDER-1',
+        refund_fee: '10.00',
+        fund_change: 'Y'
+      }
+    })
+
+    const result = await createRefund(client).refund({ outTradeNo: 'ORDER-1', refundAmount: '10.00' })
+    expect(result.refundAmount).toBe('10.00')
+    expect(result.fundChange).toBe('Y')
+    expect(result.gmtRefundPay).toBe('')
+    expect(result.refundDetailItemList).toBeNull()
+  })
+
+  it('close 业务失败时抛出 AlipayApiError', async () => {
+    const client = makeClient()
+    ;(client.sdk.exec as ReturnType<typeof vi.fn>).mockResolvedValue({
+      alipay_trade_close_response: {
+        code: '40004',
+        sub_code: 'ACQ.TRADE_STATUS_ERROR',
+        sub_msg: '交易状态不合法'
+      }
+    })
+
+    await expect(createRefund(client).close({ outTradeNo: 'ORDER-1' }))
+      .rejects.toBeInstanceOf(AlipayApiError)
+  })
+})
+
+describe('alipay notify validation', () => {
+  it('app_id 与配置一致且无期望值时通过', () => {
+    const handler = createNotifyHandler(makeClient())
+    expect(handler.validate(baseNotify as never).valid).toBe(true)
+  })
+
+  it('app_id 不匹配时报告错误', () => {
+    const handler = createNotifyHandler(makeClient())
+    const result = handler.validate({ ...baseNotify, appId: 'other-app' } as never)
+    expect(result.valid).toBe(false)
+    expect(result.errors[0]).toContain('app_id')
+  })
+
+  it('订单号与金额期望值不一致时报告错误', () => {
+    const handler = createNotifyHandler(makeClient())
+    const result = handler.validate(baseNotify as never, { outTradeNo: 'ORDER-2', totalAmount: '300.00' })
+    expect(result.valid).toBe(false)
+    expect(result.errors.some(error => error.includes('out_trade_no'))).toBe(true)
+    expect(result.errors.some(error => error.includes('total_amount'))).toBe(true)
+  })
+
+  it('金额按数值比较，"299.0" 与 "299.00" 视为一致', () => {
+    const handler = createNotifyHandler(makeClient())
+    const result = handler.validate({ ...baseNotify, totalAmount: '299.0' } as never, { totalAmount: '299.00' })
+    expect(result.valid).toBe(true)
+  })
+
+  it('非终态 trade_status 报告错误', () => {
+    const handler = createNotifyHandler(makeClient())
+    const result = handler.validate({ ...baseNotify, tradeStatus: 'WAIT_BUYER_PAY' } as never)
+    expect(result.valid).toBe(false)
+    expect(result.errors[0]).toContain('trade_status')
+  })
+
+  it('verify 透传 raw 参数，SDK 异常时返回 false', () => {
+    const client = makeClient()
+    ;(client.sdk.checkNotifySign as ReturnType<typeof vi.fn>).mockImplementation((_params: unknown, raw?: boolean) => {
+      expect(raw).toBe(true)
+      return true
+    })
+    const handler = createNotifyHandler(client)
+    expect(handler.verify({ a: '1' }, true)).toBe(true)
+
+    const broken = makeClient()
+    ;(broken.sdk.checkNotifySign as ReturnType<typeof vi.fn>).mockImplementation(() => {
+      throw new Error('bad key')
+    })
+    expect(createNotifyHandler(broken).verify({ a: '1' })).toBe(false)
+  })
+})
+
+describe('alipay plugin lifecycle', () => {
+  it('安装自建客户端并在卸载时销毁', () => {
+    const provide = vi.fn()
+    const plugin = alipayPlugin({
+      config: { appId: '2021000000000000', privateKey: 'k', alipayPublicKey: 'p' } as AlipayClientOptions
+    })
+    const cleanup = plugin.install?.({ provide } as unknown as VobsContext)
+    const client = provide.mock.calls[0]![1] as AlipayClient
+    expect(provide).toHaveBeenCalledWith(ALIPAY_KEY, client)
+    expect(typeof cleanup).toBe('function')
+    cleanup!()
+    expect(() => client.sdk).toThrow('客户端已销毁')
+  })
+
+  it('外部传入的客户端在卸载时不被销毁', () => {
+    const client = makeClient()
+    const provide = vi.fn()
+    const plugin = alipayPlugin({ client })
+    const cleanup = plugin.install?.({ provide } as unknown as VobsContext)
+    expect(provide).toHaveBeenCalledWith(ALIPAY_KEY, client)
+    expect(cleanup).toBeUndefined()
+    expect(() => client.sdk).not.toThrow()
+  })
+})
+
+describe('alipay wap pay', () => {
+  it('wap.pay 使用 QUICK_WAP_WAY 产品码并透传 quit_url', async () => {
+    const client = makeClient()
+    ;(client.sdk.pageExecute as ReturnType<typeof vi.fn>).mockReturnValue('<form name="pay">wap</form>')
+
+    const result = await createWapPay(client).pay({
+      outTradeNo: 'ORDER-9',
+      totalAmount: '1.00',
+      subject: 'H5 会员',
+      quitUrl: 'https://merchant.example.com/quit'
+    })
+
+    expect(result.formHtml).toBe('<form name="pay">wap</form>')
+    const [apiName, , payload] = (client.sdk.pageExecute as ReturnType<typeof vi.fn>).mock.calls[0] as unknown as [string, string, Record<string, any>]
+    expect(apiName).toBe('alipay.trade.wap.pay')
+    expect(payload.bizContent.productCode).toBe('QUICK_WAP_WAY')
+    expect(payload.bizContent.quitUrl).toBe('https://merchant.example.com/quit')
+  })
+})

package/src/alipay/client.ts

@@ -0,0 +1,67 @@
+import { AlipaySdk } from 'alipay-sdk'
+import { AlipayConfig } from './config'
+import type { AlipayClientOptions, AlipayKeyType } from './types'
+
+/**
+ * 支付宝客户端封装
+ *
+ * 封装 alipay-sdk 的 AlipaySdk 实例，提供统一的生命周期管理。
+ * 可独立使用，也可通过 alipayPlugin 注册到 vobs 框架。
+ *
+ * @example
+ * ```ts
+ * const client = new AlipayClient({
+ *   appId: '202100...',
+ *   privateKey: '...',
+ *   alipayPublicKey: '...',
+ *   gateway: 'https://openapi-sandbox.dl.alipaydev.com/gateway.do'
+ * })
+ * ```
+ */
+export class AlipayClient {
+  readonly config: AlipayConfig
+  private _sdk: AlipaySdk
+  private _disposed = false
+
+  constructor(options: AlipayClientOptions) {
+    this.config = new AlipayConfig(options)
+    this._sdk = this.createSdk(options)
+  }
+
+  /** 获取底层 AlipaySdk 实例 */
+  get sdk(): AlipaySdk {
+    this.ensureActive()
+    return this._sdk
+  }
+
+  /** 更新配置并重建 SDK 实例 */
+  updateConfig(patch: Partial<AlipayClientOptions>): void {
+    this.ensureActive()
+    this.config.update(patch)
+    this._sdk = this.createSdk(this.config.options as AlipayClientOptions)
+  }
+
+  /** 销毁客户端 */
+  dispose(): void {
+    this._disposed = true
+    ;(this._sdk as any) = null
+  }
+
+  private createSdk(options: AlipayClientOptions): AlipaySdk {
+    return new AlipaySdk({
+      appId: options.appId,
+      privateKey: options.privateKey,
+      alipayPublicKey: options.alipayPublicKey,
+      signType: options.signType ?? 'RSA2',
+      gateway: options.gateway,
+      timeout: options.timeout ?? 5000,
+      keyType: (options.keyType ?? 'PKCS1') as AlipayKeyType
+    })
+  }
+
+  private ensureActive(): void {
+    if (this._disposed) {
+      throw new Error('AlipayClient: 客户端已销毁')
+    }
+  }
+}

package/src/alipay/config.ts

@@ -0,0 +1,72 @@
+import type { AlipayClientOptions } from './types'
+
+/**
+ * 支付宝配置管理
+ * 遵循 vobs 生命周期管理：可创建、可销毁、可替换
+ */
+export class AlipayConfig {
+  private _options: AlipayClientOptions
+
+  constructor(options: AlipayClientOptions) {
+    this.validate(options)
+    this._options = { ...options }
+  }
+
+  /** 获取完整配置 */
+  get options(): Readonly<AlipayClientOptions> {
+    return this._options
+  }
+
+  /** 应用 ID */
+  get appId(): string {
+    return this._options.appId
+  }
+
+  /** 网关地址 */
+  get gateway(): string {
+    return this._options.gateway ?? 'https://openapi.alipay.com/gateway.do'
+  }
+
+  /** 异步通知地址 */
+  get notifyUrl(): string | undefined {
+    return this._options.notifyUrl
+  }
+
+  /** 同步跳转地址 */
+  get returnUrl(): string | undefined {
+    return this._options.returnUrl
+  }
+
+  /** 更新配置（部分更新） */
+  update(patch: Partial<AlipayClientOptions>): void {
+    const merged = { ...this._options, ...patch }
+    this.validate(merged)
+    this._options = merged
+  }
+
+  /** 替换配置 */
+  replace(options: AlipayClientOptions): void {
+    this.validate(options)
+    this._options = { ...options }
+  }
+
+  /** 创建沙箱配置的快捷方法 */
+  static forSandbox(options: Omit<AlipayClientOptions, 'gateway'>): AlipayConfig {
+    return new AlipayConfig({
+      ...options,
+      gateway: 'https://openapi-sandbox.dl.alipaydev.com/gateway.do'
+    })
+  }
+
+  private validate(options: AlipayClientOptions): void {
+    if (!options.appId) {
+      throw new Error('AlipayConfig: appId 不能为空')
+    }
+    if (!options.privateKey) {
+      throw new Error('AlipayConfig: privateKey 不能为空')
+    }
+    if (!options.alipayPublicKey) {
+      throw new Error('AlipayConfig: alipayPublicKey 不能为空')
+    }
+  }
+}

package/src/alipay/index.ts

@@ -0,0 +1,32 @@
+export { AlipayClient } from './client'
+export { AlipayConfig } from './config'
+export { AlipayApiError } from './response'
+export { createPagePay } from './payment'
+export { createWapPay } from './wap'
+export { createQuery } from './query'
+export { createRefund } from './refund'
+export { createNotifyHandler } from './notify'
+export { alipayPlugin, useAlipay, ALIPAY_KEY } from './plugin'
+export type { AlipayPluginOptions } from './plugin'
+export type {
+  AlipayClientOptions,
+  AlipayKeyType,
+  AlipaySdkConfig,
+  AlipaySdkSignType,
+  AlipayPagePayConfig,
+  AlipayPagePayParams,
+  AlipayPagePayResult,
+  AlipayWapPayConfig,
+  AlipayWapPayParams,
+  AlipayWapPayResult,
+  AlipayQueryParams,
+  AlipayQueryResult,
+  AlipayRefundParams,
+  AlipayRefundResult,
+  AlipayRefundQueryParams,
+  AlipayRefundQueryResult,
+  AlipayCloseParams,
+  AlipayCloseResult,
+  AlipayNotifyParams,
+  TradeStatus
+} from './types'

package/src/alipay/notify.ts

@@ -0,0 +1,92 @@
+import type { AlipayClient } from './client'
+import type { AlipayNotifyParams, TradeStatus } from './types'
+
+/**
+ * 异步通知处理
+ *
+ * 支付宝在交易状态变更时，通过 POST 请求 notify_url 发送异步通知。
+ * 处理要点：
+ * 1. 收到通知后必须先验签
+ * 2. 验签后校验关键业务字段（app_id、out_trade_no、total_amount）
+ * 3. 处理成功后返回字符串 "success"（仅此 7 个字符）
+ * 4. 需做幂等处理，过滤重复通知
+ */
+export function createNotifyHandler(client: AlipayClient) {
+  return {
+    /**
+     * 验签异步通知
+     * @param params 异步通知参数（支付宝 POST 过来的原始参数）
+     * @param raw 使用原始报文验签（推荐：v4.15+ 支持，规避 encodeURIComponent 差异导致的验签失败）
+     * @returns 验签是否通过
+     */
+    verify(params: Record<string, any>, raw = false): boolean {
+      try {
+        return client.sdk.checkNotifySign(params, raw)
+      } catch {
+        return false
+      }
+    },
+
+    /**
+     * 校验异步通知的业务字段
+     *
+     * 验签只保证通知确实来自支付宝，不保证通知与你系统中的订单一致；
+     * 因此除了 app_id，还应传入商户侧的期望值（outTradeNo / totalAmount）进行比对。
+     * @param params 异步通知参数
+     * @param expected 商户侧期望值：outTradeNo 订单号、totalAmount 订单金额（单位元）
+     */
+    validate(
+      params: AlipayNotifyParams,
+      expected?: { outTradeNo?: string; totalAmount?: string }
+    ): NotifyValidationResult {
+      const errors: string[] = []
+
+      // 校验 app_id
+      if (params.appId !== client.config.appId) {
+        errors.push(`app_id 不匹配: 期望 ${client.config.appId}，收到 ${params.appId}`)
+      }
+
+      // 校验 out_trade_no 与商户订单一致
+      if (expected?.outTradeNo && params.outTradeNo !== expected.outTradeNo) {
+        errors.push(`out_trade_no 不匹配: 期望 ${expected.outTradeNo}，收到 ${params.outTradeNo}`)
+      }
+
+      // 校验 total_amount 与订单金额一致（金额为两位小数的服务端字符串，按数值比较）
+      if (expected?.totalAmount && Number(params.totalAmount) !== Number(expected.totalAmount)) {
+        errors.push(`total_amount 不匹配: 期望 ${expected.totalAmount}，收到 ${params.totalAmount}`)
+      }
+
+      // 校验 trade_status
+      const validStatuses: TradeStatus[] = ['TRADE_SUCCESS', 'TRADE_FINISHED']
+      if (!validStatuses.includes(params.tradeStatus as TradeStatus)) {
+        errors.push(`trade_status 非终态: ${params.tradeStatus}`)
+      }
+
+      return {
+        valid: errors.length === 0,
+        errors
+      }
+    },
+
+    /**
+     * 生成支付宝异步通知的成功响应
+     * 处理完成后必须返回字符串 "success"
+     */
+    successResponse(): string {
+      return 'success'
+    },
+
+    /**
+     * 生成支付宝异步通知的失败响应
+     * 返回空字符串或非 success 内容，支付宝会重试通知
+     */
+    failResponse(): string {
+      return 'fail'
+    }
+  }
+}
+
+export interface NotifyValidationResult {
+  valid: boolean
+  errors: string[]
+}

package/src/alipay/payment.ts

@@ -0,0 +1,60 @@
+import type { AlipayClient } from './client'
+import type {
+  AlipayPagePayConfig,
+  AlipayPagePayParams,
+  AlipayPagePayResult
+} from './types'
+
+/**
+ * 电脑网站支付 (alipay.trade.page.pay)
+ *
+ * 生成支付宝支付表单 HTML，前端渲染后自动提交表单跳转至支付宝收银台。
+ *
+ * ⚠️ 必须使用 pageExecute() 方法，禁止使用 exec()。
+ * ⚠️ 返回值为 HTML 表单字符串，不是 URL，前端必须渲染 form 并自动提交。
+ * ⚠️ 支付结果以异步通知或查询接口为准，不可依赖同步跳转。
+ */
+export function createPagePay(client: AlipayClient) {
+  return {
+    /**
+     * 发起电脑网站支付
+     * @param config 支付配置
+     * @returns 支付表单 HTML
+     */
+    async pay(config: AlipayPagePayConfig): Promise<AlipayPagePayResult> {
+      const { outTradeNo, totalAmount, subject, body, passbackParams } = config
+
+      const bizParams: AlipayPagePayParams = {
+        outTradeNo,
+        totalAmount,
+        subject,
+        productCode: 'FAST_INSTANT_TRADE_PAY',
+        body,
+        passbackParams,
+        returnUrl: client.config.returnUrl,
+        notifyUrl: client.config.notifyUrl
+      }
+
+      // 使用 pageExecute() 生成 POST 表单 HTML
+      // 注意：必须使用 pageExecute，不能使用 exec()
+      const formHtml = client.sdk.pageExecute(
+        'alipay.trade.page.pay',
+        'POST',
+        { bizContent: sanitizeParams(bizParams) }
+      )
+
+      return { formHtml }
+    }
+  }
+}
+
+/** 移除 undefined 字段 */
+function sanitizeParams<T extends Record<string, any>>(params: T): Record<string, any> {
+  const result: Record<string, any> = {}
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== undefined && value !== null) {
+      result[key] = value
+    }
+  }
+  return result
+}

package/src/alipay/plugin.ts

@@ -0,0 +1,64 @@
+import { createInjectionKey, inject, type VobsPlugin, type VobsContext } from '@vobs/vobs'
+import { AlipayClient } from './client'
+import type { AlipayClientOptions } from './types'
+
+export const ALIPAY_KEY = createInjectionKey<AlipayClient>('vobs.payment.alipay')
+
+export interface AlipayPluginOptions {
+  /** 支付宝客户端配置（未传入 client 时必填） */
+  config?: AlipayClientOptions
+  /** 可选的已有客户端实例（指定后忽略 config） */
+  client?: AlipayClient
+}
+
+/**
+ * 支付宝支付插件
+ *
+ * 将 AlipayClient 注入到 vobs 框架中，可通过 useAlipay() 获取。
+ *
+ * @example
+ * ```ts
+ * createVobs({
+ *   render: App,
+ *   plugins: [
+ *     alipayPlugin({
+ *       config: {
+ *         appId: '202100...',
+ *         privateKey: '...',
+ *         alipayPublicKey: '...',
+ *       }
+ *     })
+ *   ]
+ * })
+ * ```
+ */
+export function alipayPlugin(options: AlipayPluginOptions): VobsPlugin {
+  return {
+    name: '@vobs/payment/alipay',
+    version: '0.1.0',
+    install(context: VobsContext) {
+      if (!options.client && !options.config) {
+        throw new Error('Vobs Payment: alipayPlugin 需要提供 config 或 client 之一')
+      }
+      // 仅销毁插件自建的客户端；外部传入的实例由其所有者负责生命周期。
+      const ownClient = !options.client
+      const client = options.client ?? new AlipayClient(options.config!)
+      context.provide(ALIPAY_KEY, client)
+      return ownClient ? () => client.dispose() : undefined
+    }
+  }
+}
+
+/**
+ * 获取支付宝客户端实例
+ * 必须在已安装 alipayPlugin 的组件或上下文中调用
+ */
+export function useAlipay(): AlipayClient {
+  const client = inject(ALIPAY_KEY)
+  if (!client) {
+    throw new Error(
+      'Vobs Payment: 找不到 AlipayClient，请安装 alipayPlugin'
+    )
+  }
+  return client
+}

package/src/alipay/query.ts

@@ -0,0 +1,52 @@
+import type { AlipayClient } from './client'
+import { unwrapResponse } from './response'
+import type { AlipayQueryParams, AlipayQueryResult, TradeStatus } from './types'
+
+/**
+ * 交易查询 (alipay.trade.query)
+ *
+ * 查询支付宝交易状态，用于确认支付结果。
+ * 当异步通知未收到时，应主动调用此接口兜底。
+ */
+export function createQuery(client: AlipayClient) {
+  return {
+    /**
+     * 查询交易状态
+     * @param params 查询参数（outTradeNo 和 tradeNo 至少传一个）
+     * @throws {AlipayApiError} 业务失败（如 ACQ.TRADE_NOT_EXIST）时抛出
+     */
+    async query(params: AlipayQueryParams): Promise<AlipayQueryResult> {
+      const alipayResponse = unwrapResponse(
+        await client.sdk.exec('alipay.trade.query', {
+          bizContent: params
+        }),
+        'alipay.trade.query'
+      )
+
+      return {
+        tradeNo: alipayResponse.trade_no,
+        outTradeNo: alipayResponse.out_trade_no,
+        buyerLogonId: alipayResponse.buyer_logon_id,
+        tradeStatus: alipayResponse.trade_status as TradeStatus,
+        totalAmount: alipayResponse.total_amount,
+        receiptAmount: alipayResponse.receipt_amount ?? '0.00',
+        buyerPayAmount: alipayResponse.buyer_pay_amount ?? '0.00',
+        sendPayDate: alipayResponse.send_pay_date ?? '',
+        gmtPayment: alipayResponse.gmt_payment ?? null,
+        gmtClose: alipayResponse.gmt_close ?? null,
+        refundAmount: alipayResponse.refund_amount ?? '0.00',
+        subject: alipayResponse.subject ?? '',
+        passbackParams: alipayResponse.passback_params ?? null,
+        fundChannel: alipayResponse.fund_channel ?? null
+      }
+    },
+
+    /**
+     * 判断交易是否支付成功
+     * 只有 TRADE_SUCCESS 或 TRADE_FINISHED 才表示支付成功
+     */
+    isSuccessful(status: TradeStatus): boolean {
+      return status === 'TRADE_SUCCESS' || status === 'TRADE_FINISHED'
+    }
+  }
+}