初級3 分で読める
更新履歴
デプロイ済み
クリエイタースタジオとアカウント支援
クリエイターは加盟店登録なしで公開支援ページを作成し、オンチェーン自動スキャン対応のマルチチェーンウォレット決済を受け取り、クリエイタースタジオで記録を管理できるようになりました。
変更内容
- アカウント専用の公開支援ページでは、自己紹介のカスタマイズ、プラットフォームバッジ（GitHub、X、Instagram）の表示、再利用可能な支援リンクの共有が可能です。
- 支援セッションでは、直接送金および Web3 ウォレット接続決済に対応し、リアルタイムの USD 換算とオンチェーンの自動着金確認を提供します。
- クリエイタースタジオでは、受取ウォレットの管理、支援者のメッセージと電子レシート、着金統計データをダッシュボード内で確認できます。
デプロイ済み
アカウント通知と配信復旧
支払いとサブスクリプションの通知は、アプリ内とアカウントメールでの配信中も追跡可能な記録として保持され、再試行時には通知が有効か再確認されます。
変更内容
- 支払いとサブスクリプションのイベントは、アプリ内に永続的な記録を作成し、アカウントメールにも通知を配信します。通知履歴では処理中の配信状態を確認できます。
- アカウントメールの失敗には段階的なバックオフを適用し、最大5回まで試行します。自動または手動の再試行前に、PolyPay はサブスクリプションまたは監視アドレスの現在の状態を再確認し、古くなった通知を送信せずキャンセルします。
- システム通知はウォレット監視の通知枠を消費しません。ウォレット監視の配信制限とアドレス状態のルールは別途ドキュメントに記載されています。
デプロイ済み
ウォレット監視の通知期間とアドレスのインポート
ウォレット監視の通知対象を最近のオンチェーン活動に限定し、監視アドレスが無効になると再試行を停止します。秘密鍵を求めずに、マーチャントの受取ウォレットをインポートできます。
変更内容
- 通知は、オンチェーン時刻が過去72時間以内の取引にのみ送信されます。古い取引は履歴に残りますが、アプリ内、外部チャンネル、Webhook の通知は作成されません。
- 監視アドレスを無効化、削除、または請求により一時停止すると、キューにあるチャンネル再試行と手動再送がブロックされます。送信済みのメッセージは取り消されません。
- 監視アドレスの追加フローでは、選択したマーチャントと受取ウォレットから受取ウォレットをインポートできます。PolyPay は公開アドレスだけを使用し、秘密鍵を求めません。
デプロイ済み
チャネル招待による Pro 体験
新規ユーザーは登録時に有効なチャネルコードを入力するか招待リンクを使うことで、最初のマーチャントに決済 Pro プランを3暦月利用できます。無料で自動更新されず、取引手数料、ネットワーク手数料、従量料金は免除されません。
変更内容
- 登録ページで PP- チャネルコードまたは ?ref=CODE 付きの登録リンクを使えます。登録前にオファーを確認し、有効なコードならチャネルと体験条件を表示します。
- メール登録と新規 OAuth 登録では、最初のマーチャントに権利をトランザクション内で一度だけ付与します。既存アカウントは利用できず、チャネル体験と友達紹介の残高報酬は併用できません。
- 体験の対象は決済 Pro サブスクリプション料金だけです。料金は0で自動更新は無効になり、3暦月後は既存の有料プラン手続きを選ばない限り無料プランに戻ります。
デプロイ済み
ウォレット監視と通知テンプレート
PolyPay で、公開ブロックチェーンアドレスの収支を監視し、ウォレット通知を個別に管理して、独立したウォレット監視 Webhook を設定できるようになりました。
変更内容
- ウォレット監視に公開アドレスを追加し、収支を専用ページで確認できます。監視対象のアドレスは受取ウォレットとは別に扱われ、PolyPay が秘密鍵を求めることはありません。
- 通知設定で、ウォレットの入金・出金テンプレートをチャンネルと言語ごとに管理できます。有効な監視アドレスはプランが対応する人向け通知チャンネルを使い、アカウントの通知枠を消費するのは配信成功時だけです。
- ウォレット監視専用の Webhook を設定できます。イベントとアドレスの範囲、HMAC-SHA256 署名、再試行状態、バージョン付き JSON ペイロードを個別に管理し、変更後は署名付きテストに合格するまで無効のままです。
デプロイ済み
JavaScript SDK 2.0 でチェックアウト作成をサーバー側へ移行
JavaScript SDK 2.0 では、ブラウザでの注文作成と署名付きチェックアウト URL の生成を廃止しました。ブラウザは、信頼できるマーチャントサーバーが作成した Hosted Checkout URL のみを開きます。
変更内容
- マーチャントサーバーで API キーを使って Hosted Checkout を作成し、ブラウザには不透明な checkout_url だけを返します。API キー、金額、コールバック URL、署名情報をブラウザ統合に含めないでください。
- PolyPayCheckout.redirect() と openModal() はサーバーで作成した URL を受け取ります。リダイレクトやポップアップの終了は支払い証明にならないため、検証済み Webhook または認証済みのサーバー側注文照会で確認してください。
- ブラウザの Public Key による注文作成、Session Token、ブラウザ向け注文・ステータス API、署名付きチェックアウト URL ビルダーを削除しました。サーバー側の x402 サポートは @polypay/sdk/x402 で引き続き利用できます。
デプロイ済み
マーチャントのアーカイブと復元
利用していないマーチャントを履歴を失わずにアーカイブし、後からアカウント設定で復元できるようになりました。
変更内容
- マーチャント管理で確認後、現在のマーチャントをアーカイブできます。通常の切り替えリストから非表示になり、業務機能が停止し、サブスクリプションの自動更新も無効になります。
- アーカイブしても過去の注文とサブスクリプションは保持され、アカウント残高や出金には影響しません。
- アーカイブ済みのマーチャントはアカウント設定で確認、復元できます。サブスクリプションの自動更新が必要な場合は、復元後に手動で再度有効にしてください。
デプロイ済み
AI エージェントが読み取れるドキュメント
PolyPay ドキュメントに、コーディングエージェントやその他の自動化ツール向けの公開された機械可読ディスカバリー機能が追加されました。
変更内容
- 公開ドキュメントの簡潔な案内として llms.txt を追加しました。
- 機械可読な API ディスカバリーのため、RFC 9727 準拠の API カタログを追加しました。
- 認証済みダッシュボード、チェックアウトセッション、非公開 API は、エージェント向け公開範囲の対象外としました。