コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける継続課金
対面決済
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

x402 payments非公開プレビュー

マシン間決済に x402 を使用します。

x402 は、インターネット決済のプロトコルです。クライアントが支払い済みリソースをリクエストすると、サーバーは支払いの詳細を含む HTTP 402 レスポンスを返します。クライアントは支払いを行い、オーソリでリクエストを再試行します。Stripe は入金先アドレスを管理し、資金がオンチェーンで確定すると、PaymentIntent を自動的にキャプチャーします。

はじめに

Payment lifecycle

このガイドではサーバーを構築します。サーバーは支払いが必要であることを示し、支払いが成功した後にコンテンツを返します。支払いを完了するために、Stripe およびファシリテーターと連携します。

Create your endpoint

Add payment middleware to your endpoint to require payment.

This example requires 0.01 USD, paid in USDC, per request to /paid.

Node.js
Python
No results
import { paymentMiddleware } from "@x402/hono";
import { x402ResourceServer, HTTPFacilitatorClient } from "@x402/core/server";
import { ExactEvmScheme } from "@x402/evm/exact/server";

app.use(
  paymentMiddleware(
    {
      "GET /paid": {
        accepts: [
          {
            scheme: "exact",
            price: "$0.01",
            network: "eip155:84532",
            payTo: createPayToAddress,
          }
        ],
        description: "Data retrieval endpoint",
        mimeType: "application/json",
      }
    },
    new x402ResourceServer(facilitatorClient).register(
      "eip155:84532",
      new ExactEvmScheme()
    )
  )
)

Create a PaymentIntent

支払いを処理するには、仮想通貨の支払い方法を受け付ける PaymentIntent を作成します。前述の payTo メソッドを使用てください。

Node.js
Python
No results
async function createPayToAddress(context) {
  // If a payment header exists, extract the destination address from it
  if (context.paymentHeader) {
    const decoded = JSON.parse(
      Buffer.from(context.paymentHeader, "base64").toString()
    );
    const toAddress = decoded.payload?.authorization?.to;

    if (toAddress && typeof toAddress === "string") {
      return toAddress;
    }
  }

  // Create a new PaymentIntent to get a fresh crypto deposit address
  const decimals = 6; // USDC has 6 decimals
  const amountInCents = Number(10000) / Math.pow(10, decimals - 2);

  const paymentIntent = await stripe.paymentIntents.create({
    amount: amountInCents,
    currency: "usd",
    payment_method_types: ["crypto"],
    payment_method_data: {
      type: "crypto",
    },
    payment_method_options: {
      crypto: {
        mode: "custom",
      },
    },
    confirm: true,
  });

  const depositDetails = paymentIntent.next_action.crypto_collect_deposit_details;
  const payToAddress = depositDetails.deposit_addresses["base"].address;

  return payToAddress;
}

This function returns a crypto deposit address that the client receives and uses for payment.

Test your endpoint

支払い資格のないクライアントでサーバーにリクエストを行い、402 ステータスコードが返されることを確認します。

Command Line
curl http://localhost:3000/paid

402 ステータスコードが表示されます。

次に、対象となるクライアントでリクエストを作成します。Stripe のpurl を使用して、コマンドラインでテストしてください。

Command Line

ウォレットを接続した場合、サーバーはコンテンツを返し、支払いを確定できます。Stripe ダッシュボードで支払いに移動して取引を確認てください。