Naver Pay によるサブスクリプションを設定する非公開プレビュー

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

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

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

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

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

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d confirm=true \
  --data-urlencode return_url="https://www.stripe.com" \
  -d usage=off_session \
  -d customer=cus_ODQluYFNl44ODI \
  -d "payment_method_data[type]"=naver_pay \
  -d "payment_method_types[]"=naver_pay \
  -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 が含まれています。これは、同意書の承認を得るために買い手を Naver Pay にリダイレクトする際に、クライアント側で Stripe.js に渡す必要がある一意のキーです。

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

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d default_payment_method={{PAYMENT_METHOD_ID}} \
  -d off_session=true

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

サブスクリプションレスポンスの PaymentIntent ID を使用し、PaymentIntents (支払いインテント) で支払いを確定します。その後、PaymentIntent ID を URL パスに追加して、payment_method_types パラメーターの値を naver_pay に設定します。

curl https://api.stripe.com/v1/payment_intents/:id/confirm \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --data-urlencode return_url="https://www.stripe.com" \
  -d "payment_method_data[]"=type \
  -d "payment_method_data[]"=naver_pay

PaymentIntent のレスポンスにはステータス requires_action が含まれます。これは、PaymentIntent を完了するには、顧客が Naver Pay から選択した支払い方法で支払いを完了する必要があることを示します。支払いが成功すると、サブスクリプションは有効になり、その支払い方法がデフォルトの支払い方法として保存されます。