連携はAI にお任せ。

あなたは私の開発者です。blockwallets を使って、私のウェブサイトで暗号資産決済を受け付けられるようにしてください(お客様は USDT、USDC、BTC ほか 14 種類の通貨で支払い、私には米ドルで計上されます)。

## 私について
- 私のサイトの構成:わかりません。まず私のプロジェクトを見て、何で作られているかを教えてから、作業を始めてください。
- 希望する受け取り方:チェックアウト時に請求を作成してお客様を blockwallets の決済ページへリダイレクトし、入金されたら blockwallets が私のサーバーを呼び出すので、私は注文を支払済みにして発送します。
- 私はプログラマーではありません。各ステップで、どのファイルを変更したか、私が何をする必要があるか(たとえば環境変数をどこに置くか)を教えてください。一度に大きく変更しないでください。
- プロジェクトのルートにある AGENTS.md に blockwallets の連携ルールがあります。まずそれを読み、詳細は https://blockwallets.io/llms-full.txt を読んでください。

## まずドキュメントを読み、API を記憶で推測しないでください
- 連携ドキュメント全文(Markdown):https://blockwallets.io/llms-full.txt
- 連携ルールとよくある間違い:https://blockwallets.io/agents.md
- すでに Cryptomus、NOWPayments、Coinbase Commerce を使っているサイトなら、書き直さずに対応する互換 API へ切り替えてください:https://blockwallets.io/docs/migrate.md?lang=en
- リンクを開けない場合は、そう伝えてください。内容を貼り付けます。

## 要点(連携でよく間違える箇所)
1. すべてのエンドポイントは https://blockwallets.io への POST + JSON です。ヘッダー:merchant = merchant UUID、sign = md5(base64(リクエストボディ) + API key)。送信する JSON 文字列そのものに署名し、署名後に再シリアライズしないでください。
2. POST /v1/payment で請求を作成します。必須:amount(小数点以下 2 桁までの文字列、例:"42.00")、currency("USD")、order_id(私の注文番号:英字、数字、- と _、100 文字以内)。さらに url_callback(Webhook の URL)と url_success(支払い後にお客様が戻る先)も渡します。お客様を result.url へリダイレクトします。
3. 同じ order_id で再度呼び出すと同じ請求が返るため、再試行は安全で、2件目の請求が作られることはありません。
4. Webhook の署名は必ず検証してください。Webhook の JSON を解析して sign フィールドを取り除き、残りを PHP の json_encode と同じ方法で再エンコードします(コンパクト、非 ASCII はそのまま、/ は \/ にエスケープ)。そのうえで md5(base64(エンコード結果) + API key) が sign と一致しなければなりません。/ のエスケープ忘れが最もよくある間違いです。
5. 注文を支払済みにするのは、status が paid または paid_over のときだけで、payment_amount_usd を使います。同じ Webhook が複数回届くことがあるため、uuid + status で重複を排除してください。処理が済んだら 2xx のステータスで応答します。
6. merchant ID と API key は環境変数(例:BW_MERCHANT、BW_API_KEY)に保存し、コードに直接書いたりコミットしたりしないでください。先に、管理画面の「開発者 › 連携とキー」ページの「サイトのドメイン」に、Webhook URL のドメインを追加します。
7. まず Test の認証情報(テストネット、本物のお金は動きません)ですべて動くようにしてください。Live への切り替えは、私が確認してからにします。

## 完了したら、各項目を確認して結果を教えてください
- [ ] Test の認証情報でテスト用の請求を作成し、決済ページのリンク(result.url)を取得する
- [ ] 決済ページを開き、「決済をシミュレート」→ 全額 をクリックする
- [ ] 私のサーバーが status が paid の Webhook を受け取り、署名の検証が通る
- [ ] 対応する注文が支払済みになる
- [ ] 同じ Webhook が再度届いても(管理画面の「開発者 › Webhook ログ」から再送するか、POST /v1/payment/resend)、二重に発送されない

いずれかの項目が失敗したら、ほかの変更を加える前に、どこで止まっているかと正確なエラーメッセージを教えてください。