コンテンツにスキップ
アカウントを作成またはサインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

PayTo でサブスクリプション支払いを受け付ける

PayTo を使用したサブスクリプションの作成と支払いの方法をご紹介します。

このガイドを使用して、支払い方法として PayTo を使用する サブスクリプション を設定します。

2 つの API コールを使用してサブスクリプションを作成し、確定します。最初の API コール では Setup Intents API を使用して、支払い方法として PayTo を設定します。2 つ目の API コール では、顧客、商品、支払い方法の情報を Subscriptions API に送信して、サブスクリプションを作成し、1 回のコールで支払いを確定します。

商品と価格を作成する
ダッシュボード

Products (商品) は、販売しているアイテムまたはサービスを表します。Prices (価格) は、商品の価格と請求頻度を定義します。これには、商品の価格、受け付ける通貨、および 1 回限りの支払いか継続支払いかが含まれます。商品と価格が数個のみの場合は、ダッシュボードでそれらを作成および管理します。

このガイドでは、例としてストックフォトサービスを使用し、15 AUD の月次サブスクリプションを顧客に請求します。これをモデル化するには、次のようにします。

  1. 商品ページに移動し、商品を作成をクリックします。
  2. 商品の名前を入力します。オプションで説明を追加して、商品の画像をアップロードできます。
  3. 商品税コードを選択します。商品税コードの詳細をご確認ください。
  4. 継続を選択します。次に、価格に**15を入力し、通貨として**を選択します。
  5. 価格に税金を含めるかどうかを選択します。税金設定のデフォルト値を使用するか、値を手動で設定できます。この例では、自動を選択します。
  6. 請求期間で月次を選択します。
  7. その他の料金体系オプションをクリックします。次に、この例の料金体系モデルとして定額を選択します。定額料金とその他の料金体系モデルの詳細をご確認ください。
  8. 将来的に特定の価格を整理、クエリ、更新するために、内部価格の説明と検索キー 追加します。
  9. 次へをクリックします。次に、商品を追加をクリックします。

商品と価格を作成したら、価格 ID を記録しておき、後続のステップで使用できるようにします。ID は料金体系ページで price_G0FvDp6vZvdwRZ のように表示されます。

SetupIntent を作成する
サーバー側

今後の支払いに備えて顧客の支払い方法を保存するために、SetupIntent を作成します。SetupIntent はこの設定プロセスのステップを追跡します。

payment_method_options に amount を設定して、同意書の金額を制限します。これは、金額が指定されていない 同意書は常に拒否される からです。

Command Line
cURL
No results
curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d confirm=true \
  --data-urlencode return_url="https://www.stripe.com" \
  -d usage=off_session \
  -d customer=cus_ODQluYFNl44ODI \
  -d "payment_method_data[type]"=payto \
  -d "payment_method_types[]"=payto \
  -d "payment_method_options[payto][mandate_options][amount]"=1500 \
  -d "mandate_data[customer_acceptance][type]"=online \
  -d "mandate_data[customer_acceptance][online][ip_address]"="127.0.0.0" \
  -d "mandate_data[customer_acceptance][online][user_agent]"=device

SetupIntent オブジェクトには client_secret が含まれています。これは一意のキーで、買い手を PayTo にリダイレクトして同意書を承認するために、クライアント側で Stripe.js に渡す必要があります。

サブスクリプションを作成する
サーバー側

価格と顧客を含むサブスクリプションを作成します。default_payment_method パラメーターの値を SetupIntent から返された PaymentMethod ID に設定します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d default_payment_method={{PAYMENT_METHOD_ID}} \
  -d off_session=true

サブスクリプションを作成すると、事前設定されたデフォルトの支払い方法があるため、顧客に自動的に請求されます。支払いが成功すると、Stripe ダッシュボードのステータスが 有効 に変わります。すでに設定済みの価格によって以降の請求額が決まります。

実装内容をテストする

以下のさまざまなテスト用 PayID と銀行口座情報を使用して、テスト API キーで PayTo の実装内容をテストします。各セットによって、本番環境でシステムが直面する各種シナリオが再現されています。

PayID説明
{any_prefix}+succeed@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に processing に移行し、さらに 5 秒後に succeeded に移行します。同意書は active 状態になります。
{any_prefix}+decline@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に requires_payment_method に移行します。Stripe は payment_method_provider_decline エラーコードと invalid_authorization 拒否コードを返します。同意書は inactive 状態になります。
{any_prefix}+expire@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に requires_payment_method に移行します。Stripe は payment_method_provider_decline エラーコードと generic_decline 拒否コードを返します。同意書は inactive 状態になります。
{any_prefix}+insufficient_funds@{any_domain}PaymentIntent のステータスは、10 秒後に requires_action から processing に移行し、さらに 5 秒後に requires_payment_method に移行します。Stripe は、 payment_method_provider_decline エラーコードと insufficient_funds 拒否コードを返します。同意書のステータスは inactive になります。
{any_prefix}+revoke@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に processing に移行し、さらに 5 秒後に succeeded に移行します。同意書は active 状態で開始し、1 分後に inactive 状態に移行します。
{any_prefix}+agreement_type_not_supported@{any_domain}PaymentIntent のステータスは、10 秒後に requires_action から requires_payment_method に移行します。Stripe は、payment_method_provider_decline エラーコードを返します。同意書のステータスは inactive になります。
このページはお役に立ちましたか。
はいいいえ