payment-kit 1.22.9 → 1.22.10

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.22.9
+version: 1.22.10
 logo: logo.png
 files:
   - dist
@@ -84,11 +84,11 @@ capabilities:
   clusterMode: false
   component: true
 screenshots:
-  - checkout-payment-form.png
-  - customer-billing-dashboard.png
-  - subscription-details-view.png
-  - admin-payment-integrations.png
-  - payment-transactions-list.png
+  - checkout-payment-form.jpg
+  - customer-billing-dashboard.jpg
+  - subscription-details-view.jpg
+  - admin-payment-integrations.jpg
+  - payment-transactions-list.jpg
 components:
   - name: image-bin
     source:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payment-kit",
-  "version": "1.22.9",
+  "version": "1.22.10",
   "scripts": {
     "dev": "blocklet dev --open",
     "lint": "tsc --noEmit && eslint src api/src --ext .mjs,.js,.jsx,.ts,.tsx",
@@ -57,9 +57,9 @@
     "@blocklet/error": "^0.3.2",
     "@blocklet/js-sdk": "^1.17.1",
     "@blocklet/logger": "^1.17.1",
-    "@blocklet/payment-broker-client": "1.22.9",
-    "@blocklet/payment-react": "1.22.9",
-    "@blocklet/payment-vendor": "1.22.9",
+    "@blocklet/payment-broker-client": "1.22.10",
+    "@blocklet/payment-react": "1.22.10",
+    "@blocklet/payment-vendor": "1.22.10",
     "@blocklet/sdk": "^1.17.1",
     "@blocklet/ui-react": "^3.2.1",
     "@blocklet/uploader": "^0.3.8",
@@ -129,7 +129,7 @@
   "devDependencies": {
     "@abtnode/types": "^1.17.1",
     "@arcblock/eslint-config-ts": "^0.3.3",
-    "@blocklet/payment-types": "1.22.9",
+    "@blocklet/payment-types": "1.22.10",
     "@types/cookie-parser": "^1.4.9",
     "@types/cors": "^2.8.19",
     "@types/debug": "^4.1.12",
@@ -176,5 +176,5 @@
       "parser": "typescript"
     }
   },
-  "gitHead": "9614e353a90ac740da61b9f97db6456ee8a0279b"
+  "gitHead": "6f1df451a18678f0398b13a7120305f8deb0c6f4"
 }

package/website/latest-blog.yml

@@ -0,0 +1,5 @@
+blogTitle: "最新动态"
+blogDescription: "在此处获取最新更新。"
+blogUrl: "https://www.arcblock.io" # 或者是您的 Discuss Kit Blocklet URL
+blogLabel: "payment-kit"
+blogMoreButtonText: "查看更多"

package/website/structure.md

@@ -0,0 +1,169 @@
+# **Payment Kit — Landing Page**
+
+---
+
+## **1. Hero — Core Value Proposition**
+
+💡 **Suggested Component:** `Split Hero With Big Title`
+
+**Headline:**
+**Own Your Payments.**
+
+**Sub-headline:**
+Accept crypto and fiat in one self-hosted checkout — no fees, no middlemen.
+**Description:**
+Payment Kit lets you create products, manage subscriptions, track usage, and process payments —
+all in one secure, self-hosted platform built for Web2 and Web3.
+
+**Primary CTA:**
+🟦 [**Run Your Own**](https://store.blocklet.dev/blocklets/z2qaCNvKMv5GjouKdcDWexv6WqtHbpNPQDnAk)
+
+**Secondary CTA:**
+⚪ [**View Docs**](https://www.arcblock.io/docs/?q=payment-kit)
+
+**Hero Image:**
+![Hero image](./hero-image.webp)
+
+---
+
+## **2. Key Highlights — Why Teams Choose Payment Kit**
+
+💡 **Suggested Component:** `Layout 3 Column Grid (Center)` + `Content Card With Icon`
+
+**Section Title:**
+**What Payment Kit Offers**
+
+1. 🪙 **Multi-Chain + Fiat Payments** — Accept ABT, ETH, Base, and Stripe in one checkout.
+2. 💰 **Flexible Billing Models** — One-time, recurring, usage-based, and credit billing built in.
+3. 🔐 **DID Security + Vault Wallet** — Decentralized identity and threshold-protected cold storage.
+4. 💳 **Credit Billing** — Pre-fund or stake credits with real-time tracking and auto top-up.
+5. 🎟 **Promotions & Vendors** — Built-in coupons, affiliate sharing, and revenue splits.
+6. ⚙️ **Self-Hosted Infrastructure** — Full data ownership and zero platform fees.
+
+---
+
+## **3. Designed for Your Success — Who It’s For**
+
+💡 **Suggested Component:** `Content Card With SrceenShot (Bottom)`
+
+**Section Title:**
+**Who It’s For**
+
+Each slide highlights a core user persona with AI-generated illustration.
+
+**🟦 For Business Owners**
+Accept global fiat and crypto payments effortlessly.
+Expand revenue with flexible billing and real-time analytics.
+🖼️ `./r-bus-owner.png`
+
+**🟧 For Developers**
+Integrate in minutes with Stripe-compatible APIs and TypeScript SDK.
+Deploy self-hosted to stay independent from vendors.
+🖼️ `./r-for-dev.png`
+
+**🟩 For AI & SaaS Builders**
+Support both pay-as-you-go and subscription-based business models.
+Use credits for real-time API billing, and SubGuard™ to ensure subscription reliability.
+🖼️ `./r-for-ai.png`
+
+**🟪 For Enterprises**
+Deploy PCI-compliant, auditable infrastructure with fraud prevention.
+Support multi-tenancy and private deployments.
+🖼️ `./r-for-ent.png`
+
+**🟫 For Web3 Projects**
+Accept crypto on Ethereum and Base.
+Bridge traditional and decentralized payments through DID authentication.
+🖼️ `./r-for-web3.png`
+
+---
+
+## **4. Billing, Reliability & Growth — All in One**
+
+**💡 Suggested Component:** `Carousel Section`
+
+**Section Title:**
+**Everything You Need to Bill and Grow**
+
+Slide 1 · One-Time & Subscriptions
+Fast checkout for crypto and fiat. Subscriptions renew automatically, and SubGuard™ ensures uninterrupted access through staking-based guarantees.
+🖼 checkout-payment-form.jpg
+
+Slide 2 · Usage-Based Billing
+Real-time metering for API calls or resources. Accurate, auditable, and scalable for any usage-based model.
+🖼 payment-overview.jpg
+
+Slide 3 · Credit-Based Billing
+Tokenized credits deduct on use and support auto top-up to maintain service continuity.
+🖼 customer-credit.jpg
+
+Slide 4 · Reliability & Security
+DID authentication, Vault Wallet auto-transfer, and SubGuard™ staking protection ensure payment integrity.
+🖼 admin-payment-integrations.jpg
+
+Slide 5 · Growth & Ecosystem
+Promo codes, vendor revenue sharing, and Blocklet ecosystem integration help you grow faster.
+🖼 coupon.jpg
+## **5. Capability Comparison**
+
+💡 **Suggested Component:** `Comparison Table`
+
+**Section Title:**
+**Traditional vs. Modern vs. Payment Kit**
+
+| Capability      | Traditional   | Modern Gateways (e.g. Stripe) | Payment Kit (Web2 + Web3)             |
+| :-------------- | :------------ | :---------------------------- | :------------------------------------ |
+| Supported Rails | Fiat only     | Fiat + limited wallets        | Fiat + multi-chain crypto             |
+| Billing Models  | One-time      | One-time + recurring          | One-time + recurring + usage + credit |
+| Ownership       | Vendor-locked | Managed cloud                 | Self-hosted / user-managed            |
+| Customization   | Fixed         | Limited APIs                  | Open SDK + Blocklet extensions        |
+| Ecosystem       | None          | App marketplace               | Native Blocklet ecosystem             |
+| Data Custody    | Vendor        | Shared                        | Private + on-chain ledger             |
+| Fees            | 2–5 %         | 2.9 % + $0.30                 | 0 % platform fee                      |
+| Crypto Support  | ❌             | ⚠️ Partial                    | ✅ Native multi-chain                  |
+
+---
+
+## **6. FAQ**
+
+💡 **Suggested Component:** `FaqComponentV2`
+
+**Q1. Why self-host instead of using Stripe?**
+At scale, Stripe’s 2.9 % fees can consume your profit. Payment Kit eliminates that while adding crypto support and full data ownership.
+
+**Q2. Is Payment Kit easy to integrate with existing systems?**
+Yes. It uses Stripe-compatible APIs and SDKs for quick setup — connect Stripe for fiat and enable ArcBlock, Ethereum, and Base for crypto payments.
+
+**Q3. Which currencies and chains are supported?**
+Payment Kit supports fiat via Stripe and crypto on ArcBlock Chain, Ethereum, and Base. You can add more tokens as needed — there’s no limit.
+
+**Q4. What is SubGuard™ and how does it work?**
+SubGuard™ uses staking to guarantee subscription continuity. If a user fails to renew or pay, their staked collateral automatically covers the service provider’s loss.
+
+**Q5. What are the real costs of running Payment Kit?**
+Payment Kit is free — you only pay for hosting, Stripe fees (for fiat), and blockchain gas (for crypto). No platform fees or revenue share.
+
+---
+
+## **7. Latest Updates**
+
+**Section Title:**
+**Latest Updates**
+
+Stay up to date with new features and release highlights.
+Feed from `latest-blog.yml`.
+
+---
+
+## **8. Final CTA**
+
+**Headline:**
+**Start in Minutes. Deploy with Confidence.**
+
+**Sub-headline:**
+Integrate Payment Kit today and join our community for help and tips.
+
+🟦 [**Run Your Own**](https://store.blocklet.dev/blocklets/z2qaCNvKMv5GjouKdcDWexv6WqtHbpNPQDnAk)
+🟩 [**Join Community**](https://community.arcblock.io/discussions/boards/payment-kit)
+🟨 [**View Docs**](https://www.arcblock.io/docs/?q=payment-kit)
+

package/screenshots/SCREENSHOTS.md

@@ -1,33 +0,0 @@
-# Payment Kit Screenshots
-
-This document provides a visual overview of the Payment Kit application, a decentralized Stripe-like payment solution for blocklets. Below are screenshots showcasing the key features and interfaces of the application.
-
-## Checkout Payment Form
-
-![Checkout Payment Form](./checkout-payment-form.png)
-
-This screenshot displays the checkout payment interface where customers complete their purchases. The form shows an order summary for "DID Names Service" priced at 5 USD, alongside payment details where users can select their preferred payment method (PLAY3, TBA, ABT, or USD). The interface includes fields for customer information such as name, email, and postal code, with a prominent "Pay" button to complete the transaction.
-
-## Customer Billing Dashboard
-
-![Customer Billing Dashboard](./customer-billing-dashboard.png)
-
-The customer billing dashboard provides users with a comprehensive overview of their account status and subscriptions. It displays wallet balances across multiple cryptocurrencies (TBA and PLAY3), showing balance, spent, and stake amounts. The credits section tracks token usage and transactions. Below that, users can view and manage their active subscriptions including "Usage Payment Service," "Test Service A," "Notification Service," and "Test Service B," each with renewal dates and management options.
-
-## Subscription Details View
-
-![Subscription Details View](./subscription-details-view.png)
-
-This detailed subscription management screen shows comprehensive information about "Test Service A." It displays the subscription status (Active), next invoice date, amount, current balance, and subdcard information. The interface includes customer details, billing information, payment method (ArcBlock Beta), and state transaction data. The Products section shows the subscription item (0.01 TBA/month), and the Invoice History table provides a complete record of past payments with amounts, payment methods, invoice numbers, and statuses.
-
-## Admin Payment Integrations
-
-![Admin Payment Integrations](./admin-payment-integrations.png)
-
-The admin integrations screen shows the configuration interface for payment methods and services. This view displays the vault settings page where administrators can configure app bundles and buffer thresholds for managing payment-related vault transfers. The right panel shows the available payment methods including ArcBlock (with ArcBlock Beta for testing), ETHng (with Ether payments via Alchemy Network), and BASE (with Base Mainnet and Sepolia options), each with toggle switches to enable or disable the payment method.
-
-## Payment Transactions List
-
-![Payment Transactions List](./payment-transactions-list.png)
-
-The payment transactions overview displays a comprehensive table of all payment activities in the system. The list shows transaction amounts (ranging from 0.1 TBA to 1 TBA), payment methods (ArcBlock Beta), customer information (primarily showing "Xiao Fang"), descriptions (subscription cycles, creation, and purchase confirmations), creation and update timestamps, and transaction statuses (marked as "Succeeded"). This view provides administrators with complete visibility into all payment processing activities within the platform.