コンテキストを作成
注文、セッション、証跡、またはエージェントのタスクは、支払い事実とは分けて記述してください。
ウォレットの支配権を持たずに支払いをリクエストします。
標準の Payment Request を作成し、ビジネスコンテキストを添付し、顧客にローカルで確認と署名を行ってもらい、その後は一貫した状態モデルで結果を追跡します。
Official Testnet integration is open for supported flows. Mainnet settlement, commercial pricing, and service-level commitments are not offered.
より明確な境界
あなたのシステムがリクエストし、顧客のウォレットが判断します。
VelarumPay は、加盟店システム、エージェントシステム、ウォレットの署名責任を明確に分離します。
支払いをリクエスト
正確な金額、資産、ネットワーク、受取先、有効期限、冪等性キーを送信してください。
ユーザーが承認
顧客は自分のデバイスで署名する前に、リスクと取引事実を確認します。
状態を確認
統合側は署名権限を得ることなく、決定論的な状態とイベントを読み取ります。
統合経路
ひとつの protocol、複数の接続方法。
アプリケーションに適したインターフェースを選んでください。サポートされているすべての経路は次に集約されます velarum.payment_request.v1.
Platform API と直接統合する。
ペアリング、接続、取引コンテキスト、Payment Requests、状態、イベントには、公開された OpenAPI contract を使用してください。サーバー側サービスは、スコープ、有効期限、正確な金額、冪等性を検証します。
同じ契約に基づく型付きヘルパーを使用してください。
JavaScript SDK は、ペアリング、検証、コンテキスト作成、Payment Request 作成、状態ポーリングを、より小さなクライアント側の表面にまとめます。API と JSON Schema は引き続き唯一の正確な基準です。
エージェントにはリクエスト用ツールを渡し、ウォレットの鍵は渡さない。
MCP サーバーとコネクタは、ペアリング、コンテキスト作成、支払いリクエスト、状態読取りのために、意図的に小さく絞ったツールセットを提供します。承認、署名、鍵のエクスポート、ウォレット確認の回避はできません。
Official Testnet の適用条件
コントロールモデルが重要になる場所から始めてください。
サポート対象の統合には、明確なユーザー、リクエスター、支払い理由、テスト可能な承認フローが必要です。
加盟店チェックアウト
加盟店にユーザー鍵の取り扱いを求めることなく、注文フローからウォレットのペアリングと支払いリクエストを評価します。
信頼できるアプリケーション
カストディ権限を持たずに、ユーザー承認済みの支払いと監査可能な状態を必要とするソフトウェアを接続します。
AIエージェントのワークフロー
ローカルまたはホスト型のエージェントに購入提案をさせつつ、決定論的な検証と人による承認を維持します。
統合で維持すべきこと
明確な事実、限定されたスコープ、観測可能な状態。
優れた統合により、ウォレット利用者はリクエストを確認しやすくなり、貴社チームは結果を診断しやすくなります。
- 正確な10進数の金額文字列と明示的な資産識別
- ネットワーク、受取先、手数料、有効期限、冪等性の管理
- 取引コンテキストを不変の支払い事実から分離
- アプリケーションが実際に必要とする機能に限定されたスコープ
- 接続トークンと決定論的なエラー状態の安全な取り扱い
- サービス内に秘密鍵、シードフレーズ、署名用データを置かない
Official Testnet integration support
Tell us what you want to integrate.
Share your use case, integration surface, intended user approval flow, and test environment. This support request does not grant mainnet or commercial production access.
機微データなしAPI キー、ウォレットアドレス、シードフレーズ、秘密鍵、本番顧客データ、署名用データを含めないでください。
まず契約内容を確認したいですか。
開発者向けサブドメインには、Quickstart、REST surface、protocol schemas、MCP guide が含まれています。