payment-kit 1.24.4 → 1.25.1

package/src/locales/zh.tsx

@@ -7,6 +7,9 @@ export default flat({
     estimated: '预估',
     total: '总量',
     active: '生效中',
+    inactive: '未生效',
+    enabled: '已启用',
+    disabled: '已禁用',
     every: '每',
     metadata: {
       label: '元数据',
@@ -38,6 +41,9 @@ export default flat({
     estimatedDuration: '预计可用 {duration}',
     detail: '详情',
     setting: '配置',
+    slippage: '滑点下限',
+    slippageMinRate: '最低可接受汇率 {rate} {currency}',
+    slippageTooltip: '自动扣款时可接受的最低汇率，当汇率低于此值时将暂停扣款',
     welcome: '欢迎使用 Payment Kit',
     welcomeDesc: '从基础功能开始，轻松接入支付功能。选择下方任意功能，立即开始使用。',
     quickStart: '快速入门指南',
@@ -53,10 +59,14 @@ export default flat({
     copyTip: '请手动复制',
     save: '保存',
     saving: '保存中...',
+    saved: '保存成功',
+    refresh: '刷新',
     cancel: '取消',
     back: '返回',
     know: '知道了',
     confirm: '确认',
+    increased: '上涨',
+    decreased: '下跌',
     edit: '编辑',
     view: '查看',
     select: '选择',
@@ -74,7 +84,6 @@ export default flat({
     events: '事件',
     details: '详情',
     discount: '折扣',
-    inactive: '无效',
     deleted: '已删除',
     days: {
       sunday: '星期日',
@@ -772,6 +781,33 @@ export default flat({
         description: '输入限制单次购买的最大数量, 0表示无限制',
       },
       inventory: '库存设置',
+      dynamicPricing: {
+        label: '启用动态定价',
+        description: '价格根据实时汇率波动',
+        config: {
+          title: '动态定价配置',
+          baseAmount: {
+            label: '基准价格',
+            description: '以法定货币计算的基准价格',
+            required: '基准价格是必需的',
+          },
+        },
+        validation: {
+          checking: '正在检查汇率可用性...',
+          // eslint-disable-next-line no-template-curly-in-string
+          rateLine: '当前汇率：1 {currency} ≈ ${rate}',
+          // eslint-disable-next-line no-template-curly-in-string
+          usdLine: '参考 USD：≈ ${amount}',
+          error: '获取汇率失败，货币不支持或者数据源异常',
+          // eslint-disable-next-line no-template-curly-in-string
+          estimatedLine: '预估数量：≈ {amount} {currency}',
+          useAmount: '填入',
+        },
+      },
+      referencePricing: {
+        label: '参考汇率定价',
+        description: '仅用于参考并快速填充币种数量，不会开启动态定价',
+      },
     },
     coupon: {
       create: '创建优惠券',
@@ -1292,6 +1328,8 @@ export default flat({
       finalizedAt: '已完成时间',
       paidAt: '支付日期',
       summary: '摘要',
+      billingContextNote: '本账单金额基于结算时的实时价格计算。',
+      dynamicPricingNote: '本账单使用动态定价并锁定了汇率。',
       billTo: '开具给',
       billing: '计费方式',
       download: '下载PDF',
@@ -1766,6 +1804,69 @@ export default flat({
       totalCreditUsed: '总使用额度',
       transactionDate: '交易时间',
     },
+    exchangeRateProvider: {
+      title: '汇率数据源',
+      subtitle: '管理动态定价使用的汇率数据源',
+      medianStrategyNote: '系统会自动从多个数据源计算汇率。只有当数据源长期异常或需要临时禁用时才需要在这里处理。',
+      disableConfirmTitle: '确认停用该数据源？',
+      disableConfirmMessage: '停用后可能影响动态计价支付流程，确定要停用吗？',
+      table: {
+        name: '名称',
+        participation: '参与计算',
+        health: '健康度',
+        recentActivity: '最近活动',
+        trustLevel: '可信度',
+        trustLevelTip: '表示可信度与参与资格，不表示优先使用顺序',
+        enabled: '启用',
+        lastUpdate: '最近更新：{time}',
+        failures24h: '24h 失败次数：{count}',
+      },
+      participation: {
+        included: '已参与',
+        excluded: '已排除',
+      },
+      health: {
+        active: '健康',
+        degraded: '不稳定',
+        paused: '异常',
+        inactive: '异常',
+      },
+      status: {
+        active: '正常',
+        degraded: '降级',
+        paused: '已暂停',
+        inactive: '停用',
+      },
+      create: {
+        title: '新增数据源',
+        primaryAction: '新增汇率数据源',
+      },
+      edit: {
+        title: '编辑 {name}',
+        name: '名称',
+        nameHelp: '数据源的唯一标识',
+        nameRequired: '名称必填',
+        type: '数据源类型',
+        typeHelp: '数据源类型。创建后不可修改。',
+        baseUrl: '接口地址（可选）',
+        baseUrlHelp: '自定义接口地址，用于代理或自建实例。默认：{defaultUrl}',
+        apiKey: 'API Key',
+        apiKeyHelp: '访问数据源的 API 密钥。',
+        apiKeyLinkText: 'API Key 管理地址：',
+        apiKeyLinkAction: 'CoinMarketCap 账户',
+        testConnection: '测试连接',
+        testing: '测试中...',
+        testSuccess: '连接成功（{symbol}/USD：{rate}，{time}ms）',
+        testFailed: '连接失败：{error}',
+        enabled: '启用',
+        priority: '优先级',
+        priorityHelp: '数字越小优先级越高。系统按优先级顺序使用数据源。',
+        status: '状态',
+        statusHelp: '设置为"已暂停"可临时禁用此数据源。',
+        pausedReason: '暂停原因',
+        pausedReasonHelp: '说明为何暂停此数据源（可选）。',
+      },
+    },
   },
   empty: {
     image: '无图片',
@@ -1868,6 +1969,16 @@ export default flat({
       donation: '打赏记录',
       creditsInfo: '总共包含 {amount}',
       appliedDiscounts: '已应用优惠',
+      priceChanged: '汇率已变动 {percent}%。支付金额将会更新，是否继续？',
+      paymentCancelled: '支付已取消',
+      paymentMethodChanged: '支付方式已更换',
+      priceChangeTitle: '价格已变动',
+      priceChangeDescription: '汇率{direction}了 {percent}%，支付金额将会更新。',
+      currentPaymentMethod: '当前支付方式',
+      otherPaymentMethods: '或使用其他方式支付',
+      confirmAndPay: '确认并支付',
+      switchAndPay: '切换并支付',
+      current: '当前',
     },
     payout: {
       empty: '没有收款记录',
@@ -1884,6 +1995,37 @@ export default flat({
       alert: '您有欠费账单需要处理，请及时付款以避免服务中断',
       title: '结清欠费账单',
     },
+
+    quote: {
+      title: '价格锁定记录',
+      noQuotes: '此账单没有价格锁定记录',
+      id: '报价 ID',
+      pricingDetails: '定价详情',
+      baseAmount: '基础金额',
+      exchangeRate: '汇率',
+      consensusMethod: '汇率算法',
+      // eslint-disable-next-line no-template-curly-in-string
+      referenceRate: '参考汇率：1 {symbol} ≈ ${rate}',
+      quotedAmount: '锁定金额',
+      providerInfo: '汇率来源',
+      provider: '数据源',
+      rateTimestamp: '汇率时间',
+      slippage: '滑点',
+      lifecycle: '生命周期',
+      expiresAt: '过期时间',
+      riskInfo: '风险信息',
+      deviation: '价格偏差',
+      anomalyDetected: '检测到异常',
+      degraded: '降级',
+      status: {
+        active: '活跃',
+        used: '已使用',
+        paid: '已支付',
+        expired: '已过期',
+        cancelled: '已取消',
+        failed: '失败',
+      },
+    },
   },
   integrations: {
     description: '用于配置和管理 Payment Kit 与你应用之间的集成方式。',

package/src/pages/admin/billing/invoices/detail.tsx

@@ -7,7 +7,7 @@ import {
   TxGas,
   TxLink,
   api,
-  formatBNStr,
+  formatAmount,
   formatError,
   formatTime,
   getInvoiceStatusColor,
@@ -21,7 +21,7 @@ import type {
   TPaymentLink,
 } from '@blocklet/payment-types';
 import { ArrowBackOutlined } from '@mui/icons-material';
-import { Alert, Box, Button, CircularProgress, Divider, Stack, Typography } from '@mui/material';
+import { Alert, Box, Button, CircularProgress, Divider, Stack, Tooltip, Typography } from '@mui/material';
 import { styled } from '@mui/system';
 import { useRequest, useSetState } from 'ahooks';
 import { Link } from 'react-router-dom';
@@ -53,6 +53,7 @@ const fetchData = (
     checkoutSession: TCheckoutSession;
     paymentLink: TPaymentLink;
     relatedCreditGrants?: TCreditGrantExpanded[];
+    quotes?: any[];
   }
 > => {
   return api.get(`/api/invoices/${id}?sync=true`).then((res: any) => res.data);
@@ -150,6 +151,16 @@ export default function InvoiceDetail(props: { id: string }) {
             <InvoiceActions data={data} onChange={runAsync} variant="normal" />
           </Box>
         </Stack>
+        {data.status === 'uncollectible' && data.metadata?.slippage?.below_threshold && (
+          <Alert severity="warning" sx={{ mt: 2 }}>
+            <Typography variant="body2">
+              {t('payment.customer.invoice.slippageExceededDetail', {
+                currentRate: data.metadata.slippage.rate_at_invoice || '—',
+                minRate: data.metadata.slippage.min_acceptable_rate || '—',
+              })}
+            </Typography>
+          </Alert>
+        )}
         <Box
           sx={{
             mt: 4,
@@ -193,7 +204,7 @@ export default function InvoiceDetail(props: { id: string }) {
                 for
               </Typography>
               <Typography variant="h2" sx={{ fontWeight: 600 }}>
-                {formatBNStr(data.total, data.paymentCurrency.decimal)} {data.paymentCurrency.symbol}
+                {formatAmount(data.total, data.paymentCurrency.decimal)} {data.paymentCurrency.symbol}
               </Typography>
             </Stack>
             <Copyable text={props.id} style={{ marginLeft: 4 }} />
@@ -224,7 +235,24 @@ export default function InvoiceDetail(props: { id: string }) {
             }}>
             <InfoMetric
               label={t('common.status')}
-              value={<Status label={data.status} color={getInvoiceStatusColor(data.status)} />}
+              value={
+                <Stack direction="row" spacing={1} alignItems="center">
+                  <Status label={data.status} color={getInvoiceStatusColor(data.status)} />
+                  {data.status === 'uncollectible' && data.metadata?.slippage?.below_threshold && (
+                    <Tooltip
+                      title={t('payment.customer.invoice.slippageExceededDetail', {
+                        currentRate: data.metadata.slippage.rate_at_invoice || '—',
+                        minRate: data.metadata.slippage.min_acceptable_rate || '—',
+                      })}
+                      arrow
+                      placement="top">
+                      <span>
+                        <Status label={t('payment.customer.invoice.slippageExceeded')} color="warning" />
+                      </span>
+                    </Tooltip>
+                  )}
+                </Stack>
+              }
               divider
             />
             {data.subscription && (
@@ -390,6 +418,15 @@ export default function InvoiceDetail(props: { id: string }) {
           <Divider />
           <Box className="section">
             <SectionHeader title={t('admin.summary')} />
+            <Typography
+              variant="body2"
+              sx={{
+                color: 'text.secondary',
+                mb: 2,
+                fontSize: '0.875rem',
+              }}>
+              {t('admin.invoice.billingContextNote')}
+            </Typography>
             <Box className="section-body">
               <InvoiceTable invoice={data} emptyNodeText={t('empty.summary')} mode="admin" />
             </Box>

package/src/pages/admin/products/exchange-rate-providers/edit-dialog.tsx

@@ -0,0 +1,354 @@
+import { useLocaleContext } from '@arcblock/ux/lib/Locale/context';
+import Dialog from '@arcblock/ux/lib/Dialog';
+import Toast from '@arcblock/ux/lib/Toast';
+import { api, formatError } from '@blocklet/payment-react';
+import {
+  Alert,
+  Button,
+  CircularProgress,
+  FormControl,
+  FormHelperText,
+  InputLabel,
+  Link,
+  MenuItem,
+  Select,
+  Stack,
+  TextField,
+  Typography,
+} from '@mui/material';
+import { useSetState } from 'ahooks';
+import { useEffect } from 'react';
+
+interface ExchangeRateProvider {
+  id: string;
+  name: string;
+  type: 'token-data' | 'coingecko' | 'coinmarketcap';
+  enabled: boolean;
+  priority: number;
+  status: 'active' | 'degraded' | 'paused' | 'inactive';
+  paused_reason: string | null;
+  config: Record<string, any> | null;
+}
+
+interface EditProviderDialogProps {
+  provider: ExchangeRateProvider;
+  isCreate?: boolean;
+  open: boolean;
+  onClose: () => void;
+  onSave: () => void;
+}
+
+const BASE_URL_PLACEHOLDERS = {
+  'token-data': 'https://token-data.arcblock.io',
+  coingecko: 'https://api.coingecko.com/api/v3',
+  coinmarketcap: 'https://pro-api.coinmarketcap.com/v1',
+};
+
+const API_KEY_PLACEHOLDERS = {
+  coinmarketcap: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+  coingecko: 'CG-xxxxxxxxxxxxxxxxxxxxxxxx',
+};
+
+const TYPE_NAME_DEFAULTS: Record<ExchangeRateProvider['type'], string> = {
+  'token-data': 'Token Data',
+  coingecko: 'CoinGecko',
+  coinmarketcap: 'CoinMarketCap',
+};
+
+export default function EditProviderDialog({
+  provider,
+  isCreate = false,
+  open,
+  onClose,
+  onSave,
+}: EditProviderDialogProps) {
+  const { t } = useLocaleContext();
+  const [state, setState] = useSetState({
+    name: provider.name || '',
+    type: provider.type || 'token-data',
+    base_url: provider.config?.base_url || '',
+    api_key: provider.config?.api_key || '',
+    priority: provider.priority,
+    status: provider.status,
+    paused_reason: provider.paused_reason || '',
+    loading: false,
+    error: null as string | null,
+    testing: false,
+    testResult: null as {
+      success: boolean;
+      responseTime?: number;
+      error?: string;
+      rate?: string;
+      timestamp?: number;
+      symbol?: string;
+    } | null,
+    apiKeyTouched: false,
+  });
+
+  useEffect(() => {
+    setState({
+      name: provider.name || '',
+      type: provider.type || 'token-data',
+      base_url: provider.config?.base_url || '',
+      api_key: provider.config?.api_key || '',
+      priority: provider.priority,
+      status: provider.status,
+      paused_reason: provider.paused_reason || '',
+      error: null,
+      apiKeyTouched: false,
+    });
+  }, [provider, open]);
+
+  const handleSave = async () => {
+    if (isCreate && !state.name.trim()) {
+      setState({ error: t('admin.exchangeRateProvider.edit.nameRequired') });
+      return;
+    }
+
+    try {
+      setState({ loading: true, error: null });
+
+      const updates: any = {
+        name: state.name.trim(),
+        type: state.type,
+        priority: state.priority,
+        status: state.status,
+        config: {
+          ...(state.base_url && { base_url: state.base_url }),
+        },
+      };
+      if (isCreate || state.apiKeyTouched) {
+        updates.config.api_key = state.api_key;
+      }
+
+      if (state.status === 'paused' && state.paused_reason) {
+        updates.paused_reason = state.paused_reason;
+      } else if (state.status !== 'paused') {
+        updates.paused_reason = null;
+      }
+
+      if (isCreate) {
+        await api.post('/api/exchange-rate-providers', updates);
+      } else {
+        await api.put(`/api/exchange-rate-providers/${provider.id}`, updates);
+      }
+      onSave();
+    } catch (err) {
+      setState({ error: formatError(err) });
+      Toast.error(formatError(err));
+    } finally {
+      setState({ loading: false });
+    }
+  };
+
+  const handleCancel = () => {
+    setState({
+      name: provider.name || '',
+      type: provider.type || 'token-data',
+      base_url: provider.config?.base_url || '',
+      api_key: provider.config?.api_key || '',
+      priority: provider.priority,
+      status: provider.status,
+      paused_reason: provider.paused_reason || '',
+      error: null,
+      testing: false,
+      testResult: null,
+      apiKeyTouched: false,
+    });
+    onClose();
+  };
+
+  const handleTestConnection = async () => {
+    setState({ testing: true, testResult: null });
+
+    try {
+      const response = await api.post('/api/exchange-rate-providers/test-connection', {
+        type: state.type,
+        provider_id: isCreate ? undefined : provider.id,
+        config: {
+          ...(state.base_url && { base_url: state.base_url }),
+          ...(state.apiKeyTouched && { api_key: state.api_key }),
+        },
+      });
+
+      setState({ testResult: response.data });
+    } catch (err) {
+      setState({
+        testResult: {
+          success: false,
+          error: formatError(err),
+        },
+      });
+    } finally {
+      setState({ testing: false });
+    }
+  };
+
+  return (
+    <Dialog
+      open={open}
+      onClose={handleCancel}
+      maxWidth="sm"
+      fullWidth
+      title={
+        isCreate
+          ? t('admin.exchangeRateProvider.create.title')
+          : t('admin.exchangeRateProvider.edit.title', { name: provider.name })
+      }
+      PaperProps={{
+        sx: {
+          borderRadius: 2,
+        },
+      }}
+      actions={
+        <Stack direction="row" spacing={2}>
+          <Button variant="outlined" onClick={handleCancel} disabled={state.loading}>
+            {t('common.cancel')}
+          </Button>
+          <Button variant="contained" onClick={handleSave} disabled={state.loading}>
+            {state.loading ? t('common.saving') : t('common.save')}
+          </Button>
+        </Stack>
+      }>
+      <Stack spacing={3}>
+        {state.error && (
+          <Alert severity="error" onClose={() => setState({ error: null })}>
+            {state.error}
+          </Alert>
+        )}
+
+        <TextField
+          label={t('admin.exchangeRateProvider.edit.name')}
+          value={state.name}
+          onChange={(e) => setState({ name: e.target.value })}
+          helperText={t('admin.exchangeRateProvider.edit.nameHelp')}
+          fullWidth
+          required
+          disabled={false}
+        />
+
+        <FormControl fullWidth required>
+          <InputLabel>{t('admin.exchangeRateProvider.edit.type')}</InputLabel>
+          <Select
+            value={state.type}
+            label={t('admin.exchangeRateProvider.edit.type')}
+            onChange={(e) => {
+              const nextType = e.target.value as ExchangeRateProvider['type'];
+              setState((prev) => {
+                const shouldDefaultName = isCreate && (!prev.name || prev.name === TYPE_NAME_DEFAULTS[prev.type]);
+                return {
+                  type: nextType,
+                  name: shouldDefaultName ? TYPE_NAME_DEFAULTS[nextType] : prev.name,
+                };
+              });
+            }}
+            disabled={!isCreate}>
+            <MenuItem value="token-data">Token Data (ArcBlock)</MenuItem>
+            <MenuItem value="coingecko">CoinGecko</MenuItem>
+            <MenuItem value="coinmarketcap">CoinMarketCap</MenuItem>
+          </Select>
+          <FormHelperText>{t('admin.exchangeRateProvider.edit.typeHelp')}</FormHelperText>
+        </FormControl>
+
+        <TextField
+          label={t('admin.exchangeRateProvider.edit.baseUrl')}
+          value={state.base_url}
+          onChange={(e) => setState({ base_url: e.target.value })}
+          helperText={t('admin.exchangeRateProvider.edit.baseUrlHelp', {
+            defaultUrl: BASE_URL_PLACEHOLDERS[state.type] || '',
+          })}
+          placeholder={BASE_URL_PLACEHOLDERS[state.type] || ''}
+          fullWidth
+        />
+
+        {state.type === 'coinmarketcap' && (
+          <Stack spacing={1}>
+            <TextField
+              label={t('admin.exchangeRateProvider.edit.apiKey')}
+              value={state.api_key}
+              onChange={(e) => setState({ api_key: e.target.value, apiKeyTouched: true })}
+              helperText={t('admin.exchangeRateProvider.edit.apiKeyHelp')}
+              placeholder={API_KEY_PLACEHOLDERS[state.type] || ''}
+              type="password"
+              fullWidth
+            />
+            <Typography variant="caption" color="text.secondary">
+              {t('admin.exchangeRateProvider.edit.apiKeyLinkText')}{' '}
+              <Link href="https://pro.coinmarketcap.com/account" target="_blank" rel="noreferrer">
+                {t('admin.exchangeRateProvider.edit.apiKeyLinkAction')}
+              </Link>
+            </Typography>
+          </Stack>
+        )}
+
+        <Stack direction="row" spacing={2} alignItems="flex-start">
+          <Button
+            variant="outlined"
+            onClick={handleTestConnection}
+            disabled={state.testing}
+            startIcon={state.testing ? <CircularProgress size={16} /> : undefined}>
+            {state.testing
+              ? t('admin.exchangeRateProvider.edit.testing')
+              : t('admin.exchangeRateProvider.edit.testConnection')}
+          </Button>
+        </Stack>
+
+        {state.testResult && (
+          <Alert
+            severity={state.testResult.success ? 'success' : 'error'}
+            onClose={() => setState({ testResult: null })}>
+            {state.testResult.success
+              ? t('admin.exchangeRateProvider.edit.testSuccess', {
+                  time: state.testResult.responseTime,
+                  rate: state.testResult.rate,
+                  symbol: state.testResult.symbol,
+                  timestamp: state.testResult.timestamp,
+                })
+              : t('admin.exchangeRateProvider.edit.testFailed', {
+                  error: state.testResult.error,
+                })}
+          </Alert>
+        )}
+
+        <TextField
+          label={t('admin.exchangeRateProvider.edit.priority')}
+          type="number"
+          value={state.priority}
+          onChange={(e) => {
+            const value = parseInt(e.target.value, 10);
+            setState({ priority: Number.isNaN(value) ? 1 : Math.max(1, value) });
+          }}
+          helperText={t('admin.exchangeRateProvider.edit.priorityHelp')}
+          fullWidth
+          inputProps={{ min: 1 }}
+        />
+
+        <FormControl fullWidth>
+          <InputLabel>{t('admin.exchangeRateProvider.edit.status')}</InputLabel>
+          <Select
+            value={state.status}
+            label={t('admin.exchangeRateProvider.edit.status')}
+            onChange={(e) => setState({ status: e.target.value as any })}>
+            <MenuItem value="active">{t('admin.exchangeRateProvider.status.active')}</MenuItem>
+            <MenuItem value="degraded">{t('admin.exchangeRateProvider.status.degraded')}</MenuItem>
+            <MenuItem value="paused">{t('admin.exchangeRateProvider.status.paused')}</MenuItem>
+            <MenuItem value="inactive">{t('admin.exchangeRateProvider.status.inactive')}</MenuItem>
+          </Select>
+          <FormHelperText>{t('admin.exchangeRateProvider.edit.statusHelp')}</FormHelperText>
+        </FormControl>
+
+        {state.status === 'paused' && (
+          <TextField
+            label={t('admin.exchangeRateProvider.edit.pausedReason')}
+            value={state.paused_reason}
+            onChange={(e) => setState({ paused_reason: e.target.value })}
+            multiline
+            rows={3}
+            fullWidth
+            helperText={t('admin.exchangeRateProvider.edit.pausedReasonHelp')}
+          />
+        )}
+      </Stack>
+    </Dialog>
+  );
+}