dAppsでCoinbase Payを使用するにはどうすればよいですか? (Web3統合)

Coinbase Pay統合のセットアップ

1. 開発者は、Coinbase 開発者ポータルを通じて dApp を Coinbase に登録し、API 資格情報とサンドボックス アクセスを取得する必要があります。

2. dApp には、React、Vue、バニラ JS スタックなどの JavaScript 環境をサポートする Coinbase Pay SDK の統合が必要です。

3. Coinbase Wallet または Coinbase Pay の署名フローをサポートするその他の EVM 互換ウォレットを検出するには、ウォレット接続ロジックを更新する必要があります。

4. 承認後にマーチャント ID が割り当てられ、Coinbase エコシステム内でのトランザクション ルーティング、料金設定、決済設定が可能になります。

5. テストネットとメインネットのエンドポイントの環境変数は、開発中に誤って実稼働デプロイメントが行われないように個別に構成する必要があります。

Web3 フロントエンド経由での支払いの開始

1. ユーザーがチェックアウト時に Coinbase Pay を選択すると、フロントエンドがwindow.CoinbasePay.initiatePayment()をトリガーし、金額、資産、ネットワーク、コールバック URL などのパラメーターを渡します。

2. SDK は、ユーザーの地理位置情報に基づいて、リアルタイムの為替レート、推定ガス料金、サポートされている法定通貨の入口を表示する埋め込みモーダルをレンダリングします。

3. ユーザーは、dApp に秘密キーを公開することなく、OAuth2 リダイレクトまたはディープリンクされたモバイル アプリの承認を介して、Coinbase アカウントを使用して認証します。

4. 確認後、Coinbase Pay はオフチェーンでトランザクションに署名し、リレー インフラストラクチャ経由でブロードキャストし、フロントエンドからノード RPC の複雑さを抽象化します。

5. dApp は、オンチェーンで確認されると、固有の支払い ID と、ステータス、ブロック ハッシュ、決済タイムスタンプを含む Webhook イベント ペイロードを受け取ります。

トランザクションのライフサイクル イベントの処理

1. 開発者は、Coinbase サーバーから HTTPS 経由で送信されるpayment.created 、 payment.confirmed 、およびpayment.failedイベントを処理する Webhook リスナーを実装します。

2. 各 Webhook には検証用の SHA-256 署名ヘッダーが含まれており、ペイロードが Coinbase の検証済みドメインからのみ発信されていることを保証します。

3. dApp は、ターゲット ネットワーク上で少なくとも 1 つのブロックチェーン確認による支払いを受け取った後にのみ、内部注文状態を更新します。

4. ウォレットの残高不足やネットワークの混雑などの一時的な問題が原因で支払いが失敗した場合は、ユーザーの再入力を必要とせずに自動再試行がトリガーされます。

5. 決済調整は CSV エクスポートまたは直接 API プルを通じて毎日行われ、オンチェーンの領収書と Coinbase の内部台帳エントリが照合されます。

セキュリティとコンプライアンスの考慮事項

1. ユーザー識別子やトランザクションメタデータを含むすべての機密データは、転送中は TLS 1.3 を使用して暗号化され、保存中は Coinbase の主要インフラストラクチャによって管理される AES-256 暗号化を使用して暗号化されます。

2. dApps は、法定通貨の導入時点で Coinbase によって強制される KYC/AML ポリシーに準拠する必要があります。エンドユーザーは、初回購入を完了する前に本人確認を受けます。

3. SDK は、任意のスマート コントラクト呼び出しの挿入を禁止し、対話を事前承認されたトークン転送と、dApp の登録されたコントラクト アドレスに範囲を限定する ERC-20 承認に制限します。

4. 支払い開始エンドポイントの悪用を防ぐために、レート制限と IP ベースのスロットルが販売者 ID ごとに適用されます。

5. すべての支払いリクエストの監査ログは 90 日間保存され、フォレンジック分析のために Coinbase 開発者ダッシュボード経由でアクセスできます。

よくある質問

Q: Coinbase Pay は Solana や Bitcoin などの非 EVM チェーンをサポートしていますか? A: 現在の実装では、Coinbase Pay は Ethereum、Polygon、Base、Arbitrum、および Optimism のみをサポートしています。 Solana と Bitcoin の統合は、署名スキームの非互換性とネイティブ トークン標準の整合性の欠如のため、引き続き利用できません。

Q: ユーザーは法定通貨に変換せずに直接ステーブルコインで支払うことはできますか? A: はい。ユーザーはチェックアウト時にUSDC、DAI、またはUSDTを支払い資産として選択でき、これらのトークンがCoinbase Wallet残高に存在する場合、法定通貨のオンランプを完全にバイパスできます。

Q: Coinbase Pay UI の外観をカスタマイズする方法はありますか? A: いいえ。埋め込まれたモーダルは、Coinbase ブランドのスタイルと応答性の高いレイアウトを使用します。 iframe コンテナのカスタム CSS オーバーライドまたは DOM 操作は、サンドボックス属性とコンテンツ セキュリティ ポリシー ヘッダーによってブロックされます。

Q: ユーザーがプロセスの途中で支払いフローをキャンセルした場合はどうなりますか? A: dApp は、 payment.canceled Webhook イベントを受け取ります。資金は引き落とされず、オンチェーンアクティビティは発生せず、開発者が明示的にコーディングしない限り、セッションはフォールバックロジックをトリガーせずに終了します。