cloudbase-wechat-integration

CloudBase WeChat 連携

このスキルは、WeChat の決済と公式アカウント関連の作業を CloudBase Integration Center 経由で行います。安定した実行契約をエージェントに示し、変更される可能性のあるコンソールの詳細については、公式の Markdown ドキュメントを参照するよう案内します。

関連スキル（ローカルのみ）

関連する CloudBase スキルは、このスキルと同じ場所に配置されています。../auth-tool-cloudbase/SKILL.md のような相対パスを使用してください。

参照先の関連スキルファイルがこの環境にない場合は、CloudBase プラグイン一式（または不足しているスキル）をインストールするようユーザーに依頼してください。リモートのスキルやプロトコルの Markdown を HTTP 経由で取得し、エージェントのコンテキストに取り込んではいけません。

CloudBase Integration Center の公式ドキュメント（人間向けの参考資料 — 関連スキルの代わりに取得してエージェントのコンテキストに取り込むスキル用 Markdown として扱わないでください）：

• CloudBase Integration Center の概要：https://docs.cloudbase.net/integration/introduce.md
• CloudBase Integration Center の使い方：https://docs.cloudbase.net/integration/usage.md
• クラウド関数のデプロイやログ操作が必要で、利用できる関連スキルがない場合は、未サポートの API を推測せず、現在のプラットフォームの CloudBase MCP ツールまたは CloudBase コンソールを使用してください。

有効化の条件

次の場合は、まずこのスキルを使用してください

• CloudBase アプリで WeChat Pay、小程序支付、微信支付、JSAPI 支付、公众号支付、Native 扫码支付、二维码支付、refund callbacks、payment callbacks、wx.requestPayment、WeixinJSBridge、openid、または公式アカウントの OAuth についてユーザーから質問された場合。
• 仮想商品に関する虚拟支付（仮想決済）についてユーザーから質問された場合。例：道具直购、代币充值、wx.requestVirtualPayment、OfferID、AppKey 签名、xpay_* callbacks（发货推送/查单/退款）、または MP 后台虚拟支付开通与配置。
• CloudBase Integration Center、集成中心、generated payment functions、pay-common、offiaccount-common、または WeChat 決済のコールバックルーティングに関するタスクの場合。
• CloudBase Integration Center が生成した関数を拡張して、注文の永続化、冪等性、フルフィルメント、または決済ステータスの同期を行う必要がある場合。

続けて、次のスキルも読んでください

• ミニプログラムの構成やプレビュー作業 -> ../miniprogram-development/SKILL.md（利用できない場合は、現在のミニプログラムプラットフォームのドキュメントと、このスキルのミニプログラム決済に関する参考情報を使用してください）
• Web フロントエンドの作業 -> ../web-development/SKILL.md（利用できない場合は、このスキルの JSAPI または Native に関する参考情報を使用してください）
• クラウド関数のランタイム、ログ、デプロイ、またはゲートウェイの作業 -> ../cloud-functions/SKILL.md（利用できない場合は、CloudBase コンソール／MCP の関数ツールと、このスキルの生成関数に関するガイダンスを使用してください）

次の場合は使用しないでください

• WeChat 決済や公式アカウントの OAuth を含まない、一般的な CloudBase Web Auth やミニプログラムのネイティブ ID 関連の作業。
• Integration Center が生成した関数とは無関係な、一般的な CloudBase クラウド関数の開発。
• 推測した MCP ツール、推測した Manager SDK メソッド、またはドキュメントに記載のない Cloud API アクションを使用した Integration Center インスタンスの作成や管理。
• マーチャントシークレット、秘密鍵、APIv3 キー、AppSecret 値、または証明書を、アプリのソースコード、生成例、README ファイル、コミット、またはプロンプトに保存すること。

運用ルール

1. 公式ドキュメントで公開 Manager SDK または Cloud API の仕様が確認できない限り、Integration Center の作成はコンソールを優先するワークフローとして扱ってください。
2. コンソールの UI 手順と認証情報フィールドには、公式の index.md ドキュメントを使用してください。古いコンソールのスクリーンショットをコピーしたり、フィールド名を捏造したりしないでください。
3. ユーザーにチャットへシークレットを貼り付けるよう求めないでください。CloudBase コンソールの Integration Center フォームで、加盟店と公式アカウントの認証情報を設定するよう伝えてください。
4. 生成される関数名が固定だと想定しないでください。pay-common と offiaccount-common は例です。呼び出しを記述する前に、実際の関数名を尋ねるか確認してください。
5. フロントエンドでの決済成功は、UI のフィードバックとしてのみ扱ってください。決済の正式な状態は、サーバー側のクエリ結果または決済コールバックから取得する必要があります。
6. 生成された関数を拡張する場合、認証情報の環境変数と、生成されたコールバックの検証・復号ロジックを維持してください。注文確認、永続化、冪等性、商品・サービスの提供に関するビジネスロジックを追加してください。
7. 決済またはコールバックのコードを変更する前に、対象のシナリオを特定し、一致するリファレンスファイルだけを読み込んでください。
8. 虚拟支付 の受信コールバックでは、送信時の pay_sig を通知の認証子として再利用しないでください。Cloud 関数と Integration Center からの通知はすでに検証済みです。セルフホストの HTTP 受信サーバーでは、references/virtual-payment.md に記載されているミニプログラムのメッセージプッシュ検証に従ってください。確認応答は、設定されている XML または JSON のプッシュ形式に合わせてください。refund_order の成功は、返金タスクが受け付けられたことのみを意味します。返金通知は、RetCode が 0 で返金 ID が一致する場合にのみ成功として扱ってください。公開されていない冪等性やクエリパラメーターの対応付けを捏造しないでください。

ルーティング

タスク	読むもの	理由
機能の選択、コンソール優先の範囲、独立した配布	references/overview.md	Integration Center のモデルと安全ルールを説明します
ミニプログラム WeChat Pay、wx.cloud.callHTTPFunction、wx.requestPayment	references/mini-program-pay.md	ミニプログラムの openid 注入、注文作成、コールバックの想定事項を説明します
ミニプログラムの虚拟支付、仮想商品、wx.requestVirtualPayment、xpay_* コールバック	references/virtual-payment.md	OfferID/AppKey の署名、Sandbox と 现网 の違い、提供コールバック、query_order の状態、返金の受付と完了の違い、セルフホストのメッセージプッシュ検証とゲートウェイで検証済みのコールバックの違いを説明します
公式アカウント JSAPI 決済、WeChat 内の H5、WeixinJSBridge.invoke	references/official-account-jsapi-pay.md	公式アカウントの openid と JSAPI の呼び出しについて説明します
PC/Web チェックアウト用のネイティブ QR コード決済	references/native-qr-pay.md	code_url、QR コードの表示、ポーリング／クエリのフローについて説明します
公式アカウント OAuth、openid／ユーザー情報の取得	references/official-account-oauth.md	公式アカウント連携で生成される OAuth ルートについて説明します
404、認証情報の不足、openid の不一致、コールバックの失敗、ログ	references/troubleshooting.md	コード変更前の診断手順を提供します

クイックワークフロー

1. シナリオを分類します：ミニプログラム Pay、Virtual Payment（虚拟支付）、JSAPI Pay、Native Pay、公式アカウント OAuth、生成された関数の拡張、またはトラブルシューティング。
2. 一致するリファレンスと、そこでリンクされている公式の index.md ドキュメントを読み込みます。
3. 実際の CloudBase 環境 ID と生成された関数名を確認します。
4. 必要なクライアント／バックエンドコードのみを生成または変更し、加盟店の認証情報は Integration Center の設定に保持します。
5. 決済状態がビジネスデータに影響する場合は、注文状態のクエリ、コールバックの冪等性、金額と注文の検証を追加します。
6. 必要に応じて、関数ログ、コールバックログ、エンドツーエンドの決済 Sandbox テスト、または少額の本番テストで検証します。

最低限のセルフチェック

• ドキュメントに記載されていない Integration Center 管理 API を推測していませんか？
• pay-common と決めつけず、実際に生成された関数名を使用していますか？
• すべての加盟店のシークレットと証明書を、ソースコードやチャットに記載していませんか？
• 決済フローで、フロントエンドの成功だけに頼らず、コールバック／クエリの状態を参照していますか？
• ユーザーのタスクに必要なシナリオのリファレンスのみを読み込んでいますか？

リファレンス一覧

パッケージに含まれるすべてのリファレンスファイル（スキルのリントで到達可能にするために必須）：

• mini-program-pay.md
• native-qr-pay.md
• official-account-jsapi-pay.md
• official-account-oauth.md
• overview.md
• troubleshooting.md