payment-kit 1.20.10 → 1.20.11

package/README.md

@@ -1,46 +1,47 @@
 # Payment Kit
 
-The decentralized stripe for blocklet platform.
+The decentralized Stripe for the Blocklet platform.
 
 ## Contribution
 
 ### Development
 
-1. clone the repo
-2. run `make build`
-3. run `cd blocklets/core && blocklet dev`
+1. Clone the repository
+2. Run `make build`
+3. Run `cd blocklets/core && blocklet dev`
 
-##### when error
+#### Troubleshooting
 
-1. pre-start error component xxx is not running or unreachable
+**Error: "pre-start error component xxx is not running or unreachable"**
 
-- create .env.local file in this root
-  - add BLOCKLET_DEV_APP_DID="did:abt:your payment kit server did"
-  - add BLOCKLET_DEV_MOUNT_POINT="/example"
-- copy .env.local to be under the /core
-  - edit BLOCKLET_DEV_MOUNT_POINT="/"
+- Create a `.env.local` file in the project root
+  - Add `BLOCKLET_DEV_APP_DID="did:abt:your payment kit server did"`
+  - Add `BLOCKLET_DEV_MOUNT_POINT="/example"`
+- Copy `.env.local` to the `/core` directory
+  - Edit `BLOCKLET_DEV_MOUNT_POINT="/"`
 
-2. Insufficient fund to pay for tx cost from xxx, expected 1.0020909, got 0
-   - copy BLOCKLET_DEV_APP_DID
-   - transfer 2 TBA in your DID Wallet to your copied address
+**Error: "Insufficient funds to pay for transaction cost from xxx, expected 1.0020909, got 0"**
+
+- Copy the `BLOCKLET_DEV_APP_DID`
+- Transfer 2 TBA from your DID Wallet to the copied address
 
 ### Debug Stripe
 
-1. Install and login with instructions from: https://stripe.com/docs/stripe-cli
-2. Start your local payment-kit server, get it's port
+1. Install and log in following the instructions at: https://stripe.com/docs/stripe-cli
+2. Start your local Payment Kit server and note its port
 3. Run `stripe listen --forward-to http://127.0.0.1:8188/api/integrations/stripe/webhook --log-level=debug --latest`
 
 ### Test Stripe
 
-Invoices for subscriptions are not finalized automatically. You can use stripe postman collection to finalize it and then confirm the payment.
+Invoices for subscriptions are not finalized automatically. You can use the Stripe Postman collection to finalize them and then confirm the payment.
 
 ### Easter Eggs
 
-None public environment variables used in the code, can change the behavior of the payment-kit.
+Non-public environment variables used in the code that can change the behavior of Payment Kit:
 
-- PAYMENT_CHANGE_LOCKED_PRICE: allow change locked price, must be set to "1" to work
-- PAYMENT_RELOAD_SUBSCRIPTION_JOBS: reload subscription jobs on start, must be set to "1" to work
-- PAYMENT_BILLING_THRESHOLD: global default billing threshold, must be a number
-- PAYMENT_MIN_STAKE_AMOUNT: global min stake amount limit, must be a number
-- PAYMENT_DAYS_UNTIL_DUE: global default days until due, must be a number
-- PAYMENT_DAYS_UNTIL_CANCEL: global default days until cancel, must be a number
+- `PAYMENT_CHANGE_LOCKED_PRICE`: Allows changing locked price (must be set to "1" to enable)
+- `PAYMENT_RELOAD_SUBSCRIPTION_JOBS`: Reloads subscription jobs on start (must be set to "1" to enable)
+- `PAYMENT_BILLING_THRESHOLD`: Global default billing threshold (must be a number)
+- `PAYMENT_MIN_STAKE_AMOUNT`: Global minimum stake amount limit (must be a number)
+- `PAYMENT_DAYS_UNTIL_DUE`: Global default days until due (must be a number)
+- `PAYMENT_DAYS_UNTIL_CANCEL`: Global default days until cancellation (must be a number)

package/api/src/libs/invoice.ts

@@ -67,7 +67,7 @@ export async function getOneTimeProductInfo(invoiceId: string, paymentCurrency:
       include: [{ model: InvoiceItem, as: 'lines' }],
     });
     if (!doc) {
-      throw new Error(`Invoice not found in ${invoiceId}`);
+      throw new Error(`Invoice not found: ${invoiceId}`);
     }
     const json = doc.toJSON();
     const products = (await Product.findAll()).map((x) => x.toJSON());
@@ -733,19 +733,19 @@ export async function ensureOverdraftProtectionInvoiceAndItems({
   const invoicePrice = price?.currency_options?.find((x: any) => x.currency_id === paymentIntent?.currency_id);
 
   if (!subscription.overdraft_protection?.enabled) {
-    throw new Error('create overdraft protection invoice skipped due to overdraft protection not enabled');
+    throw new Error('Overdraft protection invoice creation skipped: overdraft protection is not enabled');
   }
 
   if (!invoicePrice) {
-    throw new Error('overdraft protection invoice price not found');
+    throw new Error('Overdraft protection invoice price not found');
   }
   const currency = await PaymentCurrency.findByPk(invoicePrice.currency_id);
   if (!currency) {
-    throw new Error('overdraft protection invoice currency not found');
+    throw new Error('Overdraft protection invoice currency not found');
   }
   const paymentMethod = await PaymentMethod.findByPk(currency?.payment_method_id);
   if (!paymentMethod) {
-    throw new Error('overdraft protection invoice payment method not found');
+    throw new Error('Overdraft protection invoice payment method not found');
   }
 
   if (paymentMethod.type !== 'arcblock') {
@@ -754,7 +754,7 @@ export async function ensureOverdraftProtectionInvoiceAndItems({
 
   const { unused } = await isSubscriptionOverdraftProtectionEnabled(subscription, paymentIntent?.currency_id);
   if (new BN(unused).lt(new BN(invoicePrice.unit_amount))) {
-    throw new Error('create overdraft protection invoice skipped due to insufficient overdraft protection');
+    throw new Error('Overdraft protection invoice creation skipped: insufficient overdraft protection funds');
   }
 
   const result = await createInvoiceWithItems({

package/api/src/locales/en.ts

@@ -54,45 +54,45 @@ export default flat({
 
     billingDiscrepancy: {
       title: '{productName} billing discrepancy',
-      body: 'Detected billing discrepancy for {productName}, please check.',
+      body: 'A billing discrepancy has been detected for {productName}. Please review your billing details.',
     },
 
     sendTo: 'Sent to',
     mintNFT: {
       title: '{collection} NFT minted',
-      message: 'A new {collection} NFT is minted and sent to your wallet, please check it out.',
+      message: 'A new {collection} NFT has been minted and sent to your wallet. Please check your wallet to view it.',
     },
 
     usageReportEmpty: {
       title: 'No usage report for {productName}',
-      body: 'No usage report for {productName} detected, please check.',
+      body: 'No usage report has been detected for {productName}. Please verify your usage reporting configuration.',
     },
 
     meteringSubscriptionDetection: {
       title: '[{appName}] Metering subscription detection',
-      body: 'During {startTimeStr} - {endTimeStr}, a total of {totalCount} subscriptions with usage-based billing were scanned. \nOut of these, {normalCount} were normal, while {abnormalCount} had anomalies, including {unreportedCount} unreported subscriptions and {discrepantCount} with billing discrepancies. \n\n Abnormal subscriptions:',
+      body: 'During {startTimeStr} - {endTimeStr}, a total of {totalCount} subscriptions with usage-based billing were scanned.\nOf these, {normalCount} were normal, while {abnormalCount} had anomalies, including {unreportedCount} unreported subscriptions and {discrepantCount} with billing discrepancies.\n\nAbnormal subscriptions:',
       healthyBody:
-        'During {startTimeStr} - {endTimeStr}, a total of {totalCount} subscriptions with usage-based billing were scanned, and all subscriptions were normal.',
+        'During {startTimeStr} - {endTimeStr}, a total of {totalCount} subscriptions with usage-based billing were scanned, and all subscriptions were functioning normally.',
       view: 'Manage subscriptions',
     },
 
     subscriptionTrialStart: {
       title: 'Welcome to the start of your {productName} trial',
-      body: 'Congratulations on your {productName} trial! The length of the trial is {trialDuration} and will end at {subscriptionTrialEnd}. Have fun with {productName}!',
+      body: 'Congratulations on starting your {productName} trial! Your trial period is {trialDuration} and will end on {subscriptionTrialEnd}. Enjoy exploring {productName}!',
     },
 
     subscriptionTrialWillEnd: {
       title: 'The {productName} trial will end soon',
       body: 'Your trial for {productName} will end in {willRenewDuration}. Please ensure your account balance is sufficient for automatic billing after the trial ends. Thank you for your support and trust!',
       unableToPayBody:
-        'Your trial for {productName} will end in {willRenewDuration}.Your current balance is {balance}, which is less than {price}, Please ensure your balance is sufficient for automatic billing. Thank you for your support and trust!',
+        'Your trial for {productName} will end in {willRenewDuration}. Your current balance is {balance}, which is less than {price}. Please ensure your balance is sufficient for automatic billing. Thank you for your support and trust!',
       unableToPayReason:
-        'The estimated payment amount is {price}, but the current balance is insufficient ({balance}), please ensure that your account has enough balance to avoid payment failure.',
+        'The estimated payment amount is {price}, but your current balance is insufficient ({balance}). Please ensure your account has enough balance to avoid payment failure.',
     },
 
     subscriptionSucceed: {
       title: "Congratulations! You've successfully subscribed to {productName}",
-      body: 'Thank you for successfully subscribing to {productName} on {at}. We will be happy to provide you with excellent service, and we wish you a pleasant experience.',
+      body: 'Thank you for successfully subscribing to {productName} on {at}. We are happy to provide you with excellent service, and we wish you a pleasant experience.',
     },
 
     oneTimePaymentSucceeded: {
@@ -102,7 +102,7 @@ export default flat({
 
     subscriptionUpgraded: {
       title: 'Congratulations! Your subscription plan for {productName} has been successfully upgraded',
-      body: 'Your subscription plan for {productName} has been successfully upgraded at {at}, thank you for your support, we wish you a pleasant experience!',
+      body: 'Your subscription plan for {productName} has been successfully upgraded on {at}. Thank you for your support, and we wish you a pleasant experience!',
     },
 
     subscriptionWillRenew: {
@@ -111,53 +111,53 @@ export default flat({
       unableToPayBody:
         'Your subscription to {productName} is scheduled for automatic payment on {at}({willRenewDuration} later). If you have any questions or need assistance, please feel free to contact us.',
       unableToPayReason:
-        'The estimated payment amount is {price}, but the current balance is insufficient ({balance}), please ensure that your account has enough balance to avoid payment failure.',
+        'The estimated payment amount is {price}, but your current balance is insufficient ({balance}). Please ensure your account has enough balance to avoid payment failure.',
       renewAmount: 'Payment amount',
       estimatedAmountNote: 'Estimate {amount}, billed based on final usage',
     },
 
     subscriptionRenewed: {
       title: '{productName} payment successful',
-      body: 'Payment for your subscription {productName} is successfully collected on {at}. Thanks for your continued support and trust, we wish you a pleasant journey when using this service!',
-      noExpenseIncurred: 'No expenses incurred during the service ',
+      body: 'Payment for your {productName} subscription was successfully collected on {at}. Thanks for your continued support and trust. We wish you a pleasant experience using this service!',
+      noExpenseIncurred: 'No expenses incurred during the service period',
     },
 
     subscriptionRenewFailed: {
       title: '{productName} automatic payment failed',
-      body: 'We are sorry to inform you that your {productName} failed to go through the automatic payment on {at}. If you have any questions, please contact us in time. Thank you!',
+      body: 'We are sorry to inform you that your {productName} automatic payment failed on {at}. If you have any questions, please contact us promptly. Thank you!',
       reason: {
-        noDidWallet: 'You have not bound DID Wallet, please bind DID Wallet to ensure sufficient balance',
-        noDelegation: 'Your DID Wallet has not been authorized, please update authorization',
+        noDidWallet: 'You have not connected a DID Wallet. Please connect your DID Wallet to ensure sufficient balance',
+        noDelegation: 'Your DID Wallet has not been authorized. Please update authorization',
         noTransferPermission:
-          'Your DID Wallet has not granted transfer permission to the application, please update authorization',
+          'Your DID Wallet has not granted transfer permission to the application. Please update authorization',
         noTokenPermission:
-          'Your DID Wallet has not granted token transfer permission to the application, please update authorization',
+          'Your DID Wallet has not granted token transfer permission to the application. Please update authorization',
         noTransferTo:
-          'Your DID Wallet has not granted the application automatic payment permission, please update authorization',
-        noEnoughAllowance: 'The deduction amount exceeds the single transfer limit, please update authorization',
-        noToken: 'Your account has no tokens, please add funds',
-        noEnoughToken: 'Your account token balance is {balance}, insufficient for {price}, please add funds',
-        noSupported: 'It is not supported to automatically pay with tokens, please check your package',
+          'Your DID Wallet has not granted automatic payment permission to the application. Please update authorization',
+        noEnoughAllowance: 'The deduction amount exceeds the single transfer limit. Please update authorization',
+        noToken: 'Your account has no tokens. Please add funds',
+        noEnoughToken: 'Your account token balance is {balance}, which is insufficient for {price}. Please add funds',
+        noSupported: 'Automatic payment with tokens is not supported. Please check your package',
         txSendFailed: 'Failed to send automatic payment transaction',
       },
     },
 
     autoRechargeFailed: {
       title: 'Auto Top-Up payment failed',
-      body: 'We are sorry to inform you that your {creditCurrencyName} auto top-up failed to go through the automatic payment on {at}. If you have any questions, please contact us in time. Thank you!',
+      body: 'We are sorry to inform you that your {creditCurrencyName} auto top-up automatic payment failed on {at}. If you have any questions, please contact us promptly. Thank you!',
       reason: {
-        noDidWallet: 'You have not bound DID Wallet, please bind DID Wallet to ensure sufficient balance',
-        noDelegation: 'Your DID Wallet has not been authorized, please update authorization',
+        noDidWallet: 'You have not connected a DID Wallet. Please connect your DID Wallet to ensure sufficient balance',
+        noDelegation: 'Your DID Wallet has not been authorized. Please update authorization',
         noTransferPermission:
-          'Your DID Wallet has not granted transfer permission to the application, please update authorization',
+          'Your DID Wallet has not granted transfer permission to the application. Please update authorization',
         noTokenPermission:
-          'Your DID Wallet has not granted token transfer permission to the application, please update authorization',
+          'Your DID Wallet has not granted token transfer permission to the application. Please update authorization',
         noTransferTo:
-          'Your DID Wallet has not granted the application automatic payment permission, please update authorization',
-        noEnoughAllowance: 'The deduction amount exceeds the single transfer limit, please update authorization',
-        noToken: 'Your account has no tokens, please add funds',
-        noEnoughToken: 'Your account token balance is {balance}, insufficient for {price}, please add funds',
-        noSupported: 'It is not supported to automatically pay with tokens, please check your package',
+          'Your DID Wallet has not granted automatic payment permission to the application. Please update authorization',
+        noEnoughAllowance: 'The deduction amount exceeds the single transfer limit. Please update authorization',
+        noToken: 'Your account has no tokens. Please add funds',
+        noEnoughToken: 'Your account token balance is {balance}, which is insufficient for {price}. Please add funds',
+        noSupported: 'Automatic payment with tokens is not supported. Please check your package',
         txSendFailed: 'Failed to send automatic payment transaction',
       },
     },
@@ -187,7 +187,7 @@ export default flat({
 
     customerRewardSucceeded: {
       title: 'Thanks for your reward of {amount}',
-      body: 'Thanks for your reward on {at}, the amount of reward is {amount}. Your support is our driving force, thanks for your generous support!',
+      body: 'Thank you for your reward on {at}. The reward amount is {amount}. Your support is our driving force. Thank you for your generous support!',
       received: '{address} has received {amount}',
       viewDetail: 'View Reference',
     },
@@ -204,14 +204,14 @@ export default flat({
       },
       sender: 'Payer',
       viewDetail: 'View Details',
-      sended: '{address} has sent {amount}',
+      sent: '{address} has sent {amount}',
     },
     subscriptWillCanceled: {
-      title: '{productName} subscription is about to be cancelled ',
+      title: '{productName} subscription is about to be cancelled',
       pastDue:
-        'Your subscription {productName} will be automatically unsubscribed by the system after {at} (after {willCancelDuration}) due to a long period of failure to automatically complete the automatic payment. Please handle the problem of automatic payment manually in time, so as not to affect the use. If you have any questions, please feel free to contact us.',
+        'Your {productName} subscription will be automatically cancelled by the system after {at} ({willCancelDuration} later) due to repeated automatic payment failures. Please resolve the automatic payment issue manually to avoid service interruption. If you have any questions, please feel free to contact us.',
       body: 'Your subscription to {productName} will be automatically canceled on {at} ({willCancelDuration} later). If you have any questions, please feel free to contact us.',
-      renewAmount: 'deduction amount ',
+      renewAmount: 'Deduction amount',
       cancelReason: 'Cancel reason',
       revokeStake: 'Revoke stake',
       adminCanceled: 'Admin canceled',

package/blocklet.yml

@@ -14,7 +14,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/payment-kit.git
 specVersion: 1.2.8
-version: 1.20.10
+version: 1.20.11
 logo: logo.png
 files:
   - dist

package/doc/vendor_fulfillment_system.md

@@ -1,63 +1,63 @@
-# 多供应商发货系统完整实现方案
+# Multi-Vendor Fulfillment System Complete Implementation
 
-## 📋 项目概述
+## 📋 Project Overview
 
-本文档总结了 Payment Kit 中多供应商发货系统的完整实现，包括架构设计、流程逻辑、技术实现和问题解决方案。
+This document summarizes the complete implementation of the multi-vendor fulfillment system in Payment Kit, including architecture design, process logic, technical implementation, and problem-solving solutions.
 
-## 🎯 系统目标
+## 🎯 System Goals
 
-### 核心需求
+### Core Requirements
 
-1. **多供应商支持**: 一个订单可以包含多个供应商的商品
-2. **异步发货**: 不同供应商可以独立、并行发货
-3. **状态协调**: 统一管理所有供应商的发货状态
-4. **容错机制**: 处理发货失败、重试、超时等异常情况
-5. **分成处理**: 所有供应商发货完成后，自动进行佣金分成
-6. **退款保障**: 任何供应商失败即全额退款，确保用户权益
+1. **Multi-vendor Support**: A single order can contain products from multiple vendors
+2. **Asynchronous Fulfillment**: Different vendors can fulfill orders independently and in parallel
+3. **State Coordination**: Unified management of fulfillment status across all vendors
+4. **Fault Tolerance**: Handle fulfillment failures, retries, timeouts, and other exceptional situations
+5. **Commission Processing**: Automatic commission distribution after all vendors complete fulfillment
+6. **Refund Protection**: Full refund if any vendor fails, ensuring user rights
 
-### 业务规则
+### Business Rules
 
-- **全部成功**: 所有供应商发货成功 → 进行佣金分成
-- **任何失败**: 有任何供应商失败、超时或超过重试次数 → **对已成功的供应商发起退货请求** → 全额退款给用户
-- **超时时间**: 5分钟无响应视为超时
-- **重试次数**: 最多3次重试
-- **退货机制**: 对已完成发货的供应商发起退货请求
+- **All Success**: All vendors fulfill successfully → Process commission distribution
+- **Any Failure**: If any vendor fails, times out, or exceeds retry limit → **Initiate return requests for successful vendors** → Full refund to user
+- **Timeout Period**: 5 minutes of no response is considered timeout
+- **Retry Limit**: Maximum 3 retries
+- **Return Mechanism**: Initiate return requests for vendors that have completed fulfillment
 
-## 🏗️ 系统架构
+## 🏗️ System Architecture
 
-### 架构模式: 协调器模式 (Coordinator Pattern)
+### Architecture Pattern: Coordinator Pattern
 
-#### 🔄 **核心流程 (文字版)**
+#### 🔄 **Core Process Flow (Text Version)**
 
 ```
 1. Payment Success
    ↓
 2. vendor-commission.ts
-   ├─ 检查供应商配置
-   ├─ 无供应商 → 直接冷钱包转账 ✅
-   └─ 有供应商 → 调用协调器
+   ├─ Check vendor configuration
+   ├─ No vendors → Direct cold wallet transfer ✅
+   └─ Has vendors → Call coordinator
 
 3. vendor-fulfillment-coordinator.ts
-   ├─ 启动发货流程
-   ├─ 初始化 vendor_info 状态
-   ├─ 为每个供应商创建发货任务
-   └─ 被动等待通知
+   ├─ Start fulfillment process
+   ├─ Initialize vendor_info status
+   ├─ Create fulfillment tasks for each vendor
+   └─ Wait passively for notifications
 
-4. vendor-fulfillment.ts (并行执行)
-   ├─ 供应商A发货 → 通知协调器 ✅
-   ├─ 供应商B发货 → 通知协调器 ✅
-   ├─ 供应商C发货 → 通知协调器 ❌
-   └─ 重试机制 (最多3次)
+4. vendor-fulfillment.ts (parallel execution)
+   ├─ Vendor A fulfills → Notify coordinator ✅
+   ├─ Vendor B fulfills → Notify coordinator ✅
+   ├─ Vendor C fulfills → Notify coordinator ❌
+   └─ Retry mechanism (max 3 times)
 
 5. vendor-fulfillment-coordinator.ts
-   ├─ 接收所有通知
-   ├─ 更新 vendor_info 状态 (事务+锁)
-   ├─ 检查整体状态
-   ├─ 全部成功 → 分成 + 冷钱包 ✅
-   └─ 任何失败 → 🔄 对已成功供应商发起退货请求 → 全额退款 ❌
+   ├─ Receive all notifications
+   ├─ Update vendor_info status (transaction + lock)
+   ├─ Check overall status
+   ├─ All success → Commission distribution + cold wallet ✅
+   └─ Any failure → 🔄 Initiate return requests for successful vendors → Full refund ❌
 ```
 
-#### 📊 **详细架构图**
+#### 📊 **Detailed Architecture Diagram**
 
 ```mermaid
 graph TD

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payment-kit",
-  "version": "1.20.10",
+  "version": "1.20.11",
   "scripts": {
     "dev": "blocklet dev --open",
     "lint": "tsc --noEmit && eslint src api/src --ext .mjs,.js,.jsx,.ts,.tsx",
@@ -56,8 +56,8 @@
     "@blocklet/error": "^0.2.5",
     "@blocklet/js-sdk": "^1.16.52-beta-20250912-112002-e3499e9c",
     "@blocklet/logger": "^1.16.52-beta-20250912-112002-e3499e9c",
-    "@blocklet/payment-react": "1.20.10",
-    "@blocklet/payment-vendor": "1.20.10",
+    "@blocklet/payment-react": "1.20.11",
+    "@blocklet/payment-vendor": "1.20.11",
     "@blocklet/sdk": "^1.16.52-beta-20250912-112002-e3499e9c",
     "@blocklet/ui-react": "^3.1.40",
     "@blocklet/uploader": "^0.2.10",
@@ -126,7 +126,7 @@
   "devDependencies": {
     "@abtnode/types": "^1.16.52-beta-20250912-112002-e3499e9c",
     "@arcblock/eslint-config-ts": "^0.3.3",
-    "@blocklet/payment-types": "1.20.10",
+    "@blocklet/payment-types": "1.20.11",
     "@types/cookie-parser": "^1.4.9",
     "@types/cors": "^2.8.19",
     "@types/debug": "^4.1.12",
@@ -173,5 +173,5 @@
       "parser": "typescript"
     }
   },
-  "gitHead": "1659d63120ced92167ec8681e51db96801b910ec"
+  "gitHead": "b69becabf1721f6238cf24004537bee1e4ade860"
 }

package/src/locales/en.tsx

@@ -11,11 +11,11 @@ export default flat({
       add: 'Add more metadata',
       edit: 'Edit metadata',
       empty: 'No metadata',
-      emptyTip: "You haven't added any metadata yet, you can add it",
+      emptyTip: "You haven't added any metadata yet. You can add it now",
       formMode: 'Switch to form mode',
       jsonMode: 'Switch to JSON mode',
       jsonPlaceholder: 'Enter JSON data...',
-      invalidJson: 'Invalid JSON format, please check your input',
+      invalidJson: 'Invalid JSON format. Please check your input',
       formatJson: 'Format JSON',
     },
     price: 'Price',
@@ -26,7 +26,7 @@ export default flat({
     minLength: 'Min {len} characters',
     invalidCharacters: 'Invalid characters',
     latinOnly:
-      'At least one letter and cannot include Chinese characters and special characters such as <, >、"、’ or \\',
+      'Must contain at least one letter and cannot include Chinese characters or special characters such as <, >, ", \' or \\',
     loading: 'Loading...',
     rechargeTime: 'Recharge Time',
     submit: 'Submit',
@@ -41,8 +41,8 @@ export default flat({
     quickStarts: 'Quick Starts',
     copy: 'Copy',
     copied: 'Copied',
-    copySuccess: 'Copy Success',
-    copyFailed: 'Copy Failed',
+    copySuccess: 'Copied successfully',
+    copyFailed: 'Copy failed',
     copyTip: 'Please copy manually',
     save: 'Save',
     cancel: 'Cancel',
@@ -254,7 +254,7 @@ export default flat({
         'Credit products are used to provide consumable credits to users, supporting both one-time purchase and package pricing models.',
       creditAmount: {
         label: 'Credit Amount',
-        placeholder: 'Amount of credits users get when purchasing this price',
+        placeholder: 'Amount of credits users receive when purchasing this price',
         help: 'Leave empty for pay-per-unit pricing, enter a number for fixed package deals',
         description: 'Purchase quantity determines the amount of Credits received',
       },
@@ -367,14 +367,14 @@ export default flat({
       archiveTip: 'Archiving will hide this product from new purchases. Are you sure you want to archive this product?',
       unarchive: 'Unarchive product',
       unarchiveTip:
-        'Unarchiving will enable this product from new purchases. Are you sure you want to unarchive this product?',
+        'Unarchiving will enable this product for new purchases. Are you sure you want to unarchive this product?',
       remove: 'Remove product',
       removeTip: 'Removing will hide this product from new purchases. Are you sure you want to remove this product?',
       archived: 'This product has been archived',
       archivedTip:
         "This product can't be added to new invoices, subscriptions, payment links, or pricing tables. Any existing subscriptions with this product remain active until canceled and any existing payment links or pricing tables are deactivated.",
       locked: 'This product is locked because at least one of its prices is used by a subscription or a payment.',
-      currencyNotAligned: 'all prices must have the same currency settings',
+      currencyNotAligned: 'All prices must have the same currency settings',
       image: {
         label: 'Image',
         add: 'Add image',
@@ -431,7 +431,7 @@ export default flat({
       vendorConfig: {
         title: 'Vendor Configuration',
         add: 'Add Vendor',
-        empty: 'No vendors configured. Click "Add Vendor" to configure vendor services.',
+        empty: 'No vendors configured. Click "Add Vendor" to configure vendor services',
         vendor: 'Vendor',
         vendorRequired: 'Vendor is required',
         productCode: 'Product Code',
@@ -508,7 +508,7 @@ export default flat({
         packageDesc: 'Price by number of units',
         graduated: 'Graduated Pricing',
         volume: 'Volume pricing',
-        custom: 'Customer choose price',
+        custom: 'Customer chooses price',
         usageBased: 'Usage-based',
         creditMetered: 'Credit metered',
       },
@@ -520,7 +520,7 @@ export default flat({
         selectMeter: 'Select meter',
         pricingNote: 'For metered products, pricing is automatically based on usage tracked by the selected meter.',
         description:
-          'Credit metered billing requires a corresponding Credit consumption. If the Credit is consumed, the corresponding service will stop.',
+          'Credit metered billing requires corresponding credit consumption. If credits are consumed, the corresponding service will stop.',
       },
       credit: {
         saveAsBasePrice: 'Set as Top-up Package',
@@ -557,7 +557,7 @@ export default flat({
         tip: '',
       },
       quantity: {
-        tip: 'Quantity must be equal or greater than 0',
+        tip: 'Quantity must be equal to or greater than 0',
       },
       quantityAvailable: {
         label: 'Available quantity',
@@ -597,10 +597,10 @@ export default flat({
       afterPay: 'After payment',
       products: 'Products',
       addProduct: 'Add another product',
-      requireBillingAddress: 'Collect customers billing addresses',
-      requirePhoneNumber: 'Collect customers phone numbers',
+      requireBillingAddress: 'Collect customer billing addresses',
+      requirePhoneNumber: 'Collect customer phone numbers',
       allowPromotionCodes: 'Allow promotion codes',
-      requireCrossSell: 'Require cross sell products selected if eligible',
+      requireCrossSell: 'Require cross-sell products to be selected if eligible',
       includeFreeTrial: 'Include a free trial',
       noStakeRequired: 'No stake required',
       showProductFeatures: 'Show product features',
@@ -684,7 +684,7 @@ export default flat({
         expiredUncapturedCharge: 'Expired uncaptured charge',
         amountRange: 'Refund amount must be between {min} and {max} {symbol}',
         amountHelper: 'Refund amount must be less than or equal to {max} {symbol}',
-        required: 'please fill in the refund information',
+        required: 'Please fill in the refund information',
         empty: 'The current order has been fully refunded',
       },
     },
@@ -718,11 +718,11 @@ export default flat({
       },
       name: {
         label: 'Name',
-        tip: 'Consumer facing',
+        tip: 'Customer-facing',
       },
       description: {
         label: 'Description',
-        tip: 'Not consumer facing',
+        tip: 'Not customer-facing',
       },
       stripe: {
         dashboard: {
@@ -749,11 +749,11 @@ export default flat({
         },
         api_host: {
           label: 'API Host',
-          tip: 'The graphql endpoint to send transaction to',
+          tip: 'The GraphQL endpoint to send transactions to',
         },
         explorer_host: {
           label: 'Explorer Host',
-          tip: 'The webapp endpoint to view transaction details',
+          tip: 'The web app endpoint to view transaction details',
         },
       },
       ethereum: {
@@ -763,11 +763,11 @@ export default flat({
         },
         api_host: {
           label: 'RPC Endpoint',
-          tip: 'The RPC endpoint to send transaction to',
+          tip: 'The RPC endpoint to send transactions to',
         },
         explorer_host: {
           label: 'Explorer Host',
-          tip: 'The webapp endpoint to view transaction details',
+          tip: 'The web app endpoint to view transaction details',
         },
         native_symbol: {
           label: 'Native Symbol',
@@ -775,7 +775,7 @@ export default flat({
         },
         confirmation: {
           label: 'Confirmation Count',
-          tip: 'How many blocks since transaction execution',
+          tip: 'Number of blocks required since transaction execution',
         },
       },
       evm: {
@@ -792,11 +792,11 @@ export default flat({
         },
         api_host: {
           label: 'RPC Endpoint',
-          tip: 'The RPC endpoint to send transaction to',
+          tip: 'The RPC endpoint to send transactions to',
         },
         explorer_host: {
           label: 'Explorer Host',
-          tip: 'The webapp endpoint to view transaction details',
+          tip: 'The web app endpoint to view transaction details',
         },
         native_symbol: {
           label: 'Native Symbol',
@@ -804,7 +804,7 @@ export default flat({
         },
         confirmation: {
           label: 'Confirmation Count',
-          tip: 'How many blocks since transaction execution',
+          tip: 'Number of blocks required since transaction execution',
         },
       },
     },