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

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

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

1. 商品を追加ページに移動します。
2. 商品の名前を入力します。
3. 価格に 15 を入力します。
4. 通貨として USD を選択します。
5. 商品を保存をクリックします。

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

payment_behavior パラメーターに default_incomplete の値を指定して、ステータスが incomplete の価格と顧客の Subscription (サブスクリプション) を作成します。サブスクリプションが有効になったときに支払い方法を保存するには、payment_settings.save_default_payment_method=on_subscription パラメーターを設定します。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d payment_behavior=default_incomplete \
  -d "items[0][price]"={{PRICE_ID}} \
  -d "payment_settings[save_default_payment_method]"=on_subscription \
  -d "expand[0]"="latest_invoice.payments" \
  -d "expand[1]"="latest_invoice.confirmation_secret"

レスポンスには、サブスクリプションの最初の請求書)が含まれます。これにはインボイスの支払いが含まれます。これには、Stripe がこのインボイスに対して生成したデフォルトの PaymentIntent と、PaymentIntent オブジェクト全体を渡す代わりにクライアント側で支払いプロセスを安全に完了するために使用できる Confirmation Secret が含まれます。latest_invoice.confirmation_secret.client_secret をフロントエンドに返して、支払いを完了します。

支払いの確定に使用する必要がある PaymentIntent ID を latest_invoice.payments から取得します。

サブスクリプションレスポンスの PaymentIntent ID を使用し、PaymentIntents (支払いインテント) で支払いを確定します。

PaymentIntent ID を URL パスに追加し、payment_method_types パラメーターの値を cashapp に設定します。

curl https://api.stripe.com/v1/payment_intents/:id/confirm \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_data[type]"=cashapp \
  --data-urlencode return_url="https://www.stripe.com" \
  -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 \
  -d "mandate_data[customer_acceptance][accepted_at]"=1660000000

PaymentIntent のレスポンスには requires_action ステータスが含まれるため、ユーザーが PaymentIntent を完了するには別のアクションを実行する必要があります。PaymentIntent レスポンスの next_action.cashapp_handle_redirect_or_display_qr_code オブジェクトを使用して、Stripe がオンラインで提供する、QR コードのページにユーザーをリダイレクトするか、QR コードを直接表示します。ユーザーを認証するには、リダイレクトと取引の認証の手順を使用します。認証後、Cash App モバイルアプリケーションは、モバイルデバイスの return_url にユーザーをリダイレクトし、PaymentIntent のステータスが succeeded に移行します。

支払いが成功すると、サブスクリプションが有効になり、使われた支払い方法がデフォルトの支払い方法として保存されます。