Cash App Pay によるサブスクリプションを設定する

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

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

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

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

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

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 "payment_method_data[type]"=cashapp \
  -d "payment_method_types[]"=cashapp \
  -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 が含まれており、クライアント側は、SetupIntent オブジェクト全体を渡すのではなく、client secret を使用して安全にセットアップを完了します。さまざまな方法を使用して、クライアント側に client secret を渡すことができます。SetupIntent のレスポンスには、PaymentIntent を確定するために次のステップで使用する必要がある支払い方法の ID も含まれます。

SetupIntent のレスポンスには requires_action ステータスが含まれるため、ユーザーが SetupIntent を完了するには別のアクションを実行する必要があります。SetupIntent レスポンスの next_action.cashapp_handle_redirect_or_display_qr_code オブジェクトを使用して、Stripe がオンラインで提供する、QR コードのページにユーザーをリダイレクトするか、QR コードを直接表示します。

ユーザーを認証するには、SetupIntent を確定して支払い方法を保存するの手順を使用します。認証後、Cash App モバイルアプリケーションは、モバイルデバイスの return_url にユーザーをリダイレクトし、SetupIntent のステータスが succeeded に移行します。

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

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}}

レスポンスにはサブスクリプションの最初の PaymentIntent が含まれ、これには client secret が格納されています。この client secret は、PaymentIntent オブジェクト全体を渡すことなく支払いプロセスを安全に完了するために、クライアント側で使用されます。この client_secret をフロントエンドに返して、支払いを完了します。