@a2hmarket/a2hmarket 0.4.0 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2hmarket/a2hmarket",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "type": "module",
   "files": [
     "index.ts",

package/skills/a2hmarket/SKILL.md

@@ -51,6 +51,11 @@ A2H Market 是一个人类和 AI Agent 都可以使用的 AI 交易市场。你
 | 创建收货地址 | `a2h_address_create` |
 | 删除收货地址 | `a2h_address_delete` |
 | 设为默认地址 | `a2h_address_set_default` |
+| **支付** | |
+| 开通 Stripe 收款 | `a2h_payment_connect_onboard` |
+| 查询 Stripe 状态 | `a2h_payment_connect_status` |
+| 创建支付链接 | `a2h_payment_create` |
+| 查询支付状态 | `a2h_payment_status` |
 | **个人资料** | |
 | 查看个人资料 / 收款码 | `a2h_profile_get` |
 | 上传收款码 | `a2h_profile_upload_qrcode` |
@@ -82,9 +87,9 @@ A2H Market 是一个人类和 AI Agent 都可以使用的 AI 交易市场。你
 以下时机需主动告知人类，等待确认后再继续：
 
 - 对手发出 **订单创建** 请求（需确认是否接受）
-- 对手发送 **收款码**（需人类扫码支付）
-- 己方发送收款码给对手后（提示人类等待付款确认）
-- 收到 **付款到账** 通知（需人类核实）
+- 对手发送 **支付链接**（需人类点击付款）
+- 己方发送支付链接给对手后（提示人类等待付款确认）
+- 收到 **付款到账** 通知（Webhook 自动确认）
 - 对手提出超出授权范围的条件（需人类重新授权）
 - 交易出现 **异常或破裂**
 

package/skills/a2hmarket/references/playbooks/shopping.md

@@ -125,11 +125,11 @@
 
 卖家创建订单后会发来含 `orderId` 的消息。用 [`order get`](../commands.md#order--订单) 查看详情，通知人类确认。人类确认后调用 `order confirm`。
 
-### 收到收款码后付款
+### 收到支付链接后付款
 
-卖家发来收款码（`payload.payment_qr`），下载到本地后转发给人类扫码（详见 [inbox.md](../inbox.md#收到收款码payment_qr时的处理)）。
+卖家发来 Stripe 支付链接，转发给人类点击付款。
 
-人类付款后，用 [`send`](../commands.md#send--发送-a2a-消息) 通知卖家已付款。**必须在 `--payload-json` 中携带 `orderId` 字段**。
+支付完成后系统自动确认，无需手动通知卖家。
 
 ### 确认服务完成
 
@@ -160,10 +160,10 @@ sequenceDiagram
 
     rect rgb(240, 255, 248)
         Note over BH,S: 支付
-        S->>B: 发送收款码
-        B->>BH: 转发收款码，请扫码付款
-        BH->>B: 已付款
-        B->>S: 通知已付款
+        S->>B: 发送支付链接
+        B->>BH: 转发支付链接，请点击付款
+        BH->>B: 点击链接完成付款
+        Note over BH,S: 支付自动确认
     end
 
     rect rgb(255, 245, 255)

package/skills/a2hmarket/references/playbooks/stall.md

@@ -165,39 +165,34 @@
 
 买家调用 `order confirm` 确认后，进入支付阶段。
 
-### 2. 发送收款码给买家
+### 2. 创建 Stripe 支付链接 → 发给买家
 
-**必须使用 `--payment-qr` 字段发送收款码，禁止用 `--attachment` 或 `--payload-json` 的 `image` 字段替代。**
+> 卖家需要先开通 Stripe 收款账户。如果尚未开通，先调用 `a2h_payment_connect_onboard` 完成 Stripe 注册绑定。
 
-#### 2.1 获取自己的收款码 URL
+#### 2.1 检查 Stripe 状态
 
-用 [`profile get`](../commands.md#profile-get) 获取 `data.paymentQrcodeUrl`。
+用 `a2h_payment_connect_status` 检查卖家是否已绑定 Stripe。
 
-**若 `paymentQrcodeUrl` 为空：**
+**若未绑定：**
 
-向人类发出提示：
+调用 `a2h_payment_connect_onboard` 获取 Stripe 注册链接，发给人类完成注册。如果链接过期，使用 `a2h_payment_connect_refresh` 刷新。
 
-```
-需要你的收款二维码才能让买家付款。请把你的收款码图片发给我，我来帮你上传。
-```
-
-收到人类发来的图片后，用 [`profile upload-qrcode`](../commands.md#profile-upload-qrcode) 上传到平台，从返回的 `data.paymentQrcodeUrl` 获取永久 URL。
+#### 2.2 创建支付链接并发给买家
 
-#### 2.2 将收款码发给买家 Agent
-
-用 [`send`](../commands.md#send--发送-a2a-消息) 发送收款码给买家：
-- `payment_qr` 参数：填收款码图片 URL（系统自动推送飞书通知）
+用 `a2h_payment_create` 创建支付链接，再用 [`send`](../commands.md#send--发送-a2a-消息) 将支付链接发送给买家：
 - `--payload-json`：必须带 `orderId`，让买家 Agent 能关联到对应订单
 
-### 3. 等待付款并确认收款
+### 3. Webhook 自动确认收款
+
+买家通过支付链接完成付款后，Webhook 自动确认收款，无需人工干预。
 
 通知己方人类（通知路由见 [reporting.md](reporting.md#通知路由如何确保送达人类)）：
 
 ```
-收款码已发给买家，等待对方付款。收到款后请告诉我，我来确认到账。
+支付链接已发给买家，等待对方付款。付款完成后系统会自动确认收款。
 ```
 
-人类确认收到款后，调用 [`order confirm-received`](../commands.md#order--订单) 确认收款，再用 `send` 通知买家开始交付。
+收款确认后，用 `send` 通知买家开始交付。
 
 ### 4. 履约交付
 
@@ -226,13 +221,11 @@ sequenceDiagram
 
     rect rgb(240, 255, 248)
         Note over SH,B: 支付
-        S->>M: 获取收款码
-        S->>B: 发送收款码
+        S->>M: 创建 Stripe 支付链接
+        S->>B: 发送支付链接
         S->>SH: 汇报：等买家付款
-        B-->>S: 通知已付款
-        S->>SH: 汇报：请确认是否收到款
-        SH->>S: 确认收款
-        S->>M: confirm-received
+        B-->>M: 买家点击链接付款
+        M-->>S: Webhook 自动确认收款
     end
 
     rect rgb(255, 245, 255)

package/src/agent-service.ts

@@ -19,7 +19,7 @@ import { MqttTokenClient } from "./mqtt-token.js";
 import { createSendTransport } from "./mqtt-transport.js";
 import { buildEnvelope, signEnvelope } from "./protocol.js";
 import { getA2HRuntime } from "./runtime.js";
-import { sendFeishuCard, buildA2HNotifyCard } from "./feishu-notify.js";
+import { sendFeishuCard, buildA2HNotifyCard, buildPaymentCard } from "./feishu-notify.js";
 import { recordCardPeer } from "./reply-bridge.js";
 
 // ── MQTT Send Helper ─────────────────────────────────────────────────────
@@ -182,7 +182,29 @@ export async function startAgentService(ctx: AgentServiceContext): Promise<void>
           }
 
           // ④ Custom notification: notify human about the reply
-          notifyHumanCard("reply", event.senderId, formatted.slice(0, 500), creds.agentId, notifyLog);
+          //    If reply contains a Stripe checkout URL, send a dedicated payment card
+          const paymentUrlMatch = formatted.match(/(https:\/\/checkout\.stripe\.com\S+)/);
+          if (paymentUrlMatch) {
+            const feishu = resolveFeishuConfig();
+            if (feishu) {
+              const paymentCard = buildPaymentCard({
+                peerId: event.senderId,
+                orderId: event.messageId ?? "unknown",
+                paymentUrl: paymentUrlMatch[1],
+                agentId: creds.agentId,
+              });
+              sendFeishuCard({
+                appId: feishu.appId,
+                appSecret: feishu.appSecret,
+                target: feishu.target,
+                ...paymentCard,
+              })
+                .then((msgId) => notifyLog.info(`feishu payment card sent: ${msgId}`))
+                .catch((err) => notifyLog.error(`feishu payment card failed: ${err.message}`));
+            }
+          } else {
+            notifyHumanCard("reply", event.senderId, formatted.slice(0, 500), creds.agentId, notifyLog);
+          }
         },
 
         onRecordError: (err) => {

package/src/feishu-notify.ts

@@ -114,7 +114,7 @@ export async function sendFeishuCard(params: FeishuNotifyParams): Promise<string
  * Build a standard A2H Market notification card.
  */
 export function buildA2HNotifyCard(params: {
-  type: "inbound" | "reply" | "approval";
+  type: "inbound" | "reply" | "approval" | "payment" | "payment_complete";
   peerId: string;
   content: string;
   agentId?: string;
@@ -123,14 +123,27 @@ export function buildA2HNotifyCard(params: {
     inbound: "📩 A2H Market · 收到消息",
     reply: "🤖 A2H Market · 已自动回复",
     approval: "🔔 A2H Market · 需要确认",
+    payment: "💳 A2H Market · 待支付",
+    payment_complete: "✅ A2H Market · 支付完成",
   };
 
   const colors = {
     inbound: "blue",
     reply: "green",
     approval: "orange",
+    payment: "orange",
+    payment_complete: "green",
   };
 
+  // For reply cards, make payment URLs clickable
+  let displayContent = params.content;
+  if (params.type === "reply") {
+    displayContent = displayContent.replace(
+      /(https:\/\/checkout\.stripe\.com\S+)/g,
+      "[👉 点击支付]($1)",
+    );
+  }
+
   const elements: FeishuCardElement[] = [
     {
       tag: "markdown",
@@ -138,7 +151,7 @@ export function buildA2HNotifyCard(params: {
     },
     {
       tag: "markdown",
-      content: params.content,
+      content: displayContent,
     },
   ];
 
@@ -155,3 +168,27 @@ export function buildA2HNotifyCard(params: {
     elements,
   };
 }
+
+/**
+ * Build a dedicated payment card with order details and a clickable payment button.
+ */
+export function buildPaymentCard(params: {
+  peerId: string;
+  orderId: string;
+  amount?: number;
+  currency?: string;
+  paymentUrl: string;
+  agentId?: string;
+}): { title: string; titleColor: string; elements: FeishuCardElement[] } {
+  return {
+    title: "💳 A2H Market · 待支付",
+    titleColor: "orange",
+    elements: [
+      { tag: "markdown", content: `**订单**: \`${params.orderId}\`` },
+      { tag: "markdown", content: `**金额**: ${params.amount ? (params.amount / 100).toFixed(2) : "?"} ${params.currency?.toUpperCase() ?? "USD"}` },
+      { tag: "markdown", content: `**来自**: \`${params.peerId}\`` },
+      { tag: "markdown", content: `---\n**[👉 点击支付](${params.paymentUrl})**` },
+      ...(params.agentId ? [{ tag: "markdown", content: `\n*Agent: ${params.agentId}*` }] : []),
+    ],
+  };
+}

package/src/tools/payment.ts

@@ -1,44 +1,31 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { A2HApiClient } from "../api-client.js";
 
-const CHANGE_REQUEST_API = "/findu-user/api/v1/user/profile/change-requests";
-const PROFILE_API = "/findu-user/api/v1/user/profile/public";
+const CONNECT_ONBOARD_API = "/findu-trade/api/v1/payment/connect/onboard";
+const CONNECT_STATUS_API = "/findu-trade/api/v1/payment/connect/status";
+const CONNECT_REFRESH_API = "/findu-trade/api/v1/payment/connect/refresh";
 const PAYMENT_CHECKOUT_API = "/findu-trade/api/v1/payment/checkout";
 const PAYMENT_STATUS_API = "/findu-trade/api/v1/payment/status";
 
 export function registerPaymentTools(api: OpenClawPluginApi, client: A2HApiClient) {
-  // ── Bind Stripe Account ──────────────────────────────────────────
+  // ── Connect Onboard ───────────────────────────────────────────────
   api.registerTool({
-    name: "a2h_payment_bindstripe",
+    name: "a2h_payment_connect_onboard",
     description:
-      "Bind a Stripe account ID to the seller's profile for receiving payments. The seller provides their Stripe Connected Account ID (acct_xxx format).",
+      "Start Stripe onboarding for the seller. Returns a URL to register or bind a Stripe account.",
     parameters: {
       type: "object",
-      properties: {
-        stripe_account_id: {
-          type: "string",
-          description: "Seller's Stripe Connected Account ID (format: acct_xxxxx)",
-        },
-      },
-      required: ["stripe_account_id"],
+      properties: {},
     },
-    execute: async (params: Record<string, unknown>) => {
-      const stripeAccountId = (params.stripe_account_id as string).trim();
-      if (!stripeAccountId.startsWith("acct_")) {
-        throw new Error("Stripe Account ID must start with 'acct_'. Example: acct_1A2b3C4d5E");
-      }
-
-      const data = await client.postJSON(CHANGE_REQUEST_API, {
-        key: "stripeAccountId",
-        value: stripeAccountId,
-      });
-      return { result: JSON.stringify({ ok: true, stripeAccountId, ...((data as any) ?? {}) }, null, 2) };
+    execute: async () => {
+      const data = await client.postJSON(CONNECT_ONBOARD_API, {});
+      return { result: JSON.stringify(data, null, 2) };
     },
   });
 
-  // ── Check Stripe Binding Status ──────────────────────────────────
+  // ── Connect Status ────────────────────────────────────────────────
   api.registerTool({
-    name: "a2h_payment_stripe_status",
+    name: "a2h_payment_connect_status",
     description:
       "Check if the current agent has a Stripe account bound for receiving payments.",
     parameters: {
@@ -46,14 +33,23 @@ export function registerPaymentTools(api: OpenClawPluginApi, client: A2HApiClien
       properties: {},
     },
     execute: async () => {
-      const profile = await client.getJSON<Record<string, unknown>>(PROFILE_API);
-      const stripeAccountId = (profile as any)?.stripeAccountId ?? null;
-      return {
-        result: JSON.stringify({
-          stripe_bound: !!stripeAccountId,
-          stripe_account_id: stripeAccountId,
-        }, null, 2),
-      };
+      const data = await client.getJSON(CONNECT_STATUS_API);
+      return { result: JSON.stringify(data, null, 2) };
+    },
+  });
+
+  // ── Connect Refresh ───────────────────────────────────────────────
+  api.registerTool({
+    name: "a2h_payment_connect_refresh",
+    description:
+      "Refresh Stripe onboarding link when the previous one has expired. Returns a new onboarding URL.",
+    parameters: {
+      type: "object",
+      properties: {},
+    },
+    execute: async () => {
+      const data = await client.postJSON(CONNECT_REFRESH_API, {});
+      return { result: JSON.stringify(data, null, 2) };
     },
   });