継続支払い

顧客が定期的に支払うビジネスモデルがある場合、通常はサブスクリプションを提供できます。Stripe は、サブスクリプションを作成して管理する方法をいくつか提供しています。

Organizations を使用している場合は、すべてのアカウントのサブスクリプションをリスト表示できます。このリストは、アカウントごとにフィルタリングすることも可能です。ただし、サブスクリプションは、アカウントのサブスクリプションページからのみ作成・分析できます。

ダッシュボードでサブスクリプションを作成する

サブスクリプションを作成するには、以下のようにします。

1. Stripe ダッシュボードで、サブスクリプションページに移動します。

2. +サブスクリプションを作成するをクリックします。

3. 顧客を検索または追加します。

4. 価格と商品の情報を入力します。複数の商品を追加できます。

5. サブスクリプションの開始日と終了日を設定します。

6. 請求サイクルの開始日を設定します。これにより、次回のインボイスが生成されるタイミングを定義します。設定によっては、保存されている登録済みの決済手段も請求サイクルの日付に自動的に請求される場合があります。請求サイクルの日付の詳細をご覧ください。

7. (推奨) メールリマインダーと通知を設定するを登録者に適用します。

8. (オプション) デフォルトの税金処理、クーポン、無料トライアル、またはメタデータを追加します。

9. (オプション) ダッシュボードで 売上回収機能を有効にすると、サブスクリプションにおける支払いの失敗を減らしたり、回収したりするのに役立ちます。失敗した支払いの自動再試行、カスタムの自動化機能の構築、顧客メールの設定などを行うことができます。

Payment Links でサブスクリプションを作成する

Payment Links を使用してサブスクリプションを作成するには、決済用のリンクの作成時に Sell a subscription (サブスクリプションを販売) を選択します。次に、リンクを顧客と共有します。決済用のリンクの作成と共有の詳細をご覧ください。

Checkout を使用してサブスクリプションを作成する

Checkoutを決済 UI として使用している場合は、Checkout Sessions API でサブスクリプションを作成します。一般的なシステムでは、アプリケーションのバックエンドを呼び出して Checkout セッションを作成するボタンをサイトに追加します。詳細については、サブスクリプション実装ガイドをご覧ください。

支払いが成功すると、サブスクリプションは有効になり、Checkout Session (Checkout セッション) オブジェクトには Customer オブジェクトと Subscription オブジェクトへの参照が組み込まれます。

この API を使用してサブスクリプションを作成するには、mode=subscription を渡します。

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

# The price ID passed from the front end.
#   price_id = params['priceId']
price_id = '{{PRICE_ID}}'

session = Stripe::Checkout::Session.create({
  success_url: 'https://example.com/success.html?session_id={CHECKOUT_SESSION_ID}',
  cancel_url: 'https://example.com/canceled.html',
  mode: 'subscription',
  line_items: [{
    # For usage-based billing, don't pass quantity
    quantity: 1,
    price: price_id,
  }],
  subscription_data: {
    billing_mode: { type: 'flexible' }
  }
})

# Redirect to the URL returned on the session
#   redirect session.url, 303

Elements でサブスクリプションを作成する

Elements を決済 UI として使用している場合は、Subscriptions API でサブスクリプションを作成します。

選択した価格 ID と顧客レコードの ID をバックエンドに渡します。次に、バックエンドで、payment_behavior=default_incomplete を使用し、ステータス incomplete を指定してサブスクリプションを作成します。これで、サブスクリプションの最初の PaymentIntent から client_secret がフロントエンドに返され、支払いを完了します。Elements を使用してサブスクリプションの実装を構築する方法をご確認ください。

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

post '/create-subscription' do
  content_type 'application/json'
  data = JSON.parse(request.body.read)
  customer_id = cookies[:customer]
  price_id = data['priceId']

  # Create the subscription. Note we're expanding the Subscription's
  # latest invoice and that invoice's confirmation_secret
  # so we can pass it to the front end to confirm the payment
  subscription = Stripe::Subscription.create(
    customer: customer_id,
    items: [{
      price: price_id,
    }],
    payment_behavior: 'default_incomplete',
    payment_settings: {save_default_payment_method: 'on_subscription'},
    billing_mode: {type: 'flexible'},
    expand: ['latest_invoice.confirmation_secret']
  )

  { subscriptionId: subscription.id, clientSecret: subscription.latest_invoice.confirmation_secret.client_secret }.to_json
end

この時点でサブスクリプションは inactive であり、支払いを待っています。次のレスポンスの例では、保存が「必要な」最小限のフィールドが強調表示されています。アプリケーションが頻繁にアクセスするフィールドも保存することをお勧めします。

{
  "id": "sub_JgRjFjhKbtD2qz",
  "object": "subscription",
  "application_fee_percent": null,
  "automatic_tax": {
    "disabled_reason": null,
    "enabled": false,
    "liability": "null"
  },
  "billing_cycle_anchor": 1623873347,

Subscriptions API を使用してサブスクリプションを作成する

Subscriptions API を使用して、継続的な価格の基本的なサブスクリプションを作成します。エンドツーエンドのサブスクリプションの実装を構築する方法を確認するか、実践的なクイックスタートを使用してください。

以下は、最初の支払いに 1 回限りの購入 (サービス手数料など) も含まれるサブスクリプションを作成する方法です。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"={{RECURRING_PRICE_ID}} \
  -d "add_invoice_items[0][price]"={{ONE_TIME_PRICE_ID}}

Subscription Schedules API を使用してサブスクリプションを作成する

サブスクリプションのシナリオが複雑な場合は、Subscription Schedules API を使用します。サブスクリプションスケジュールとそれぞれのユースケースをご紹介します。

以下は、継続的なサブスクリプションを作成する方法です。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_Gk0uVzT2M4xOKD \
  -d "items[0][price]"=price_F52b2UdntfQsfR \
  -d "expand[0]"="latest_invoice.payments" \
  -d "expand[1]"="latest_invoice.confirmation_secret" \
  -d off_session=true

保存されている顧客の決済情報で請求して、継続支払いを設定します。PaymentIntent または SetupIntent を使用して、決済の詳細をキャプチャーします。次に、これらのオブジェクトに関連付けられている client secret を使用して、顧客に後で請求します。この方法は、サブスクリプションを使用しない場合や、自社のサブスクリプションロジックを実装している場合に適しています。これらの手順では、支払い方法の情報を収集して請求するために必要な作業のみを行います。支払いの詳細を保存して再利用するには、全体的な実装の詳細に関するガイドをご覧ください。

• **PaymentIntents を使用して、決済フロー内で支払い情報をキャプチャーします。**即時の購入については顧客への請求をオンセッションで行いますが、請求は後で行います。このフローは、一連の継続支払いの最初の支払いを顧客に請求する場合や、サブスクリプションサービスの 1 回限りの設定手数料を請求する場合に適しています。
• **SetupIntents を使用して、決済フローの外部で支払い情報をキャプチャーします。**顧客から詳細を収集して、SetupIntent に保存します。このフローは、後で請求する予定の顧客のアカウント登録時に支払い情報をキャプチャーする場合や、無料のトライアルを設定する場合に適しています。

請求書を使用して、継続支払いを処理できます。たとえば、Powdur 社では毎月、造園管理サービスを利用しています。毎月、造園業者は Powdur 社に請求書を送信して、Powdur に登録されている支払い方法に自動的に請求します。

以下のセクションでは、継続支払いの請求書を使用するためのオプションについて説明します。

ダッシュボードで請求書を作成する

請求書を作成して送信するには、次の手順を実行してください。

1. ダッシュボードで請求書ページに移動し、請求書を作成をクリックして請求書エディターを開きます。請求書エディターを終了するたびに、Stripe は下書きを保存します (請求書の下書きを削除するには、請求書ページで請求書の横にあるオーバーフローメニュー () をクリックします)。

2. 既存の顧客を選択するか、新しい顧客を追加をクリックします。新規顧客の場合は、名前を入力する必要があります。オプションで、メールアドレスなどの詳細情報を追加できます。

3. (オプション) アイテムセクションのオーバーフローメニュー () をクリックし、アイテムのオプションダイアログを開きます。請求書で使用する通貨と税金の表示オプションを選択します。

4. 単一の項目を作成するには、単一の項目を追加を選択します。将来に備えて商品を保存するには、新しい商品を作成を選択します。

5. 新しいアイテムまたは商品の数量と価格を入力します。

6. (オプション) 税率、クーポン、提供日を追加するには、各アイテムのアイテムのオプションをクリックします。ダッシュボードを使用して税率やクーポンを作成することもできます。

7. (オプション) メモボックスを使用して、顧客への追加情報を入力します。請求書のメモを編集するには、詳細ページのメモを編集をクリックします。

8. 請求書の送付オプションを次の中から選択します。

   • 登録されている決済手段に自動的に請求する:請求金額が、登録されている顧客の決済手段で直ちに請求されます。

   • 請求書または支払いページのリンクを手動で送信する:請求書の確定後に顧客に送信する、決済用リンクを提供します。

   • 請求書をリンク付きでメールで送信する:Stripe が決済ページへのリンクと請求書 PDF をメールで送信できるようにします

   • 請求書をリンクなしでメールで送信する:Stripe が請求書 PDF のみを送信するようにします。

9. (オプション) この請求書を将来の日付で自動的に確定するように設定するには、送信日を設定を選択します。または、前のステップで選択した内容に応じて、支払い日を期日指定または確定日を期日指定することもできます。

10. (オプション) 詳細設定を展開して、カスタムフィールドを追加します。詳細については、正味価格と税金をご覧ください。詳細設定を展開して、カスタムフィールドを追加します。

11. 請求書を審査をクリックし、メールアドレスを追加するか、編集を続行するかを決定します。請求書を送信します。

API を使用して請求書を作成する

Invoices API を使用して、請求書を作成できます。商品、価格、顧客は、値が請求書と請求書アイテムに使用されるため、請求書の作成前に作成しておく必要があります。Invoicing API を実装するすべての手順に関するガイドをご確認ください。また、コード作成の実践的な手順についてはクイックスタートをご覧ください。

API を使用して請求書を作成するには、以下の手順を実行します。

collection_method 属性を send_invoice に設定します。Stripe がインボイスを期日経過とマークできるようにするために、days_until_due パラメーターを追加する必要があります。インボイスを送るときに、インボイスおよび支払い手順がメールで顧客に送信されます。

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d collection_method=send_invoice \
  -d days_until_due=30

次に、顧客 id、商品 price、請求書 ID invoice を指定して請求書アイテムを作成します。

請求書アイテムの最大数は 250 です。

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "pricing[price]"=
{{PRICE_ID}} \
  -d invoice=
{{INVOICE_ID}}

auto_advance を false に設定した場合、インボイスは、確定する前であればいつでも修正できます。インボイスの下書きを確定するには、ダッシュボードを使用するか、インボイスを顧客に送信するか、またはインボイスに対する支払いを行います。また、以下のようにFinalize (確定) API を使用することもできます。

curl -X POST https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/finalize \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

継続的な請求書をスケジュールする

継続請求書を設定する場合は、サブスクリプションを作成します。

支払いの回収方法を選択できます。

• 顧客に請求書を送信します。期日や受付可能な支払い方法などの回収条件を設定できます。
• 保存済みの支払い方法に自動的に請求します。顧客が支払い方法を保存している場合、Stripe は自動的にその手段に請求します。

ダッシュボードではサブスクリプションエディターで支払いの回収を設定します。API では collection_method パラメーターで支払いの回収を設定します。

また、未払いの継続請求書に関するリマインドメールを顧客に送信するように、Stripe を設定することもできます。

Stripe はサブスクリプションの 請求サイクル ごとに請求書を自動生成します。サブスクリプションの請求書のライフサイクル の詳細をご確認ください。

分割払いプランを使用すると、顧客は、設定された期間の支払いを、全額を支払い終えるまで分割して支払うことができます。たとえば、The Pacific が新しい印刷機を購入する際、古い印刷機を他の出版会社に販売します。小規模の出版会社は、全額を最初に支払う資金的な余裕がないことが多いため、分割払いを使用します。

ほとんどの印刷機について、The Pacific は月あたり 1,000 ドルを請求するため、再利用可能な価格が作成されます。

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d unit_amount=100000 \
  -d currency=usd \
  -d product=prod_Hh99apo1OViyGW \
  -d "recurring[interval]"=month

印刷機の型、モデル、使用年数に応じて、The Pacific が請求する金額は異なります。この例では、1 カ月当たり 1,000 ドルを 6 カ月間請求し、合計 6,000 ドルを請求します。

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6

iterations の数に価格の期間を乗じて顧客に対する請求回数 (この例では 6 回の月次支払い) が決定されます。end_behavior は、最後の繰り返し終了後にサブスクリプションがどのようになるかを決定します。分割払いプランでは、サブスクリプションは必要なくなるため、end_behavior は cancel に設定されます。

まれに、The Pacific が請求する金額が通常の 1,000 ドル/月よりも少ない場合があります。この場合、price_data を使用して 1 回限りの使用の価格を作成します。この例では、500 ドルの価格を作成し、6 カ月間、毎月請求します。

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price_data][currency]"=usd \
  -d "phases[0][items][0][price_data][product]"=prod_Hh99apo1OViyGW \
  -d "phases[0][items][0][price_data][recurring][interval]"=month \
  -d "phases[0][items][0][price_data][unit_amount]"=50000 \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6

Stripe は、後払いの決済手段を複数サポートしています。これらの決済手段では、顧客は時間の経過に合わせて分割払いを行うことができます。お客様には、すぐに全額が支払われます。顧客は、その場では支払いを行わなかったり、購入総額の一部しか支払いません。後払いの決済手段は、小売業者が購入完了率を高めたり、カート内の購入額を増やしたり、クレジットカードを持っていない新規顧客にリーチするのに役立ちます。

後払いの支払い方法についてもっと知る

ビジネスがメキシコを拠点としている場合は、カード支払いの分割払いまたは meses sin intereses を顧客に提供できます。この方法を使用する場合は、標準的なクレジットカード取引の手数料にさらに手数料が加算されます。

Stripe がオンラインで提供する決済ページ (Stripe Checkout)、構築済みの UI コンポーネント (Stripe Elements)、Invoicing API、Payment Links を使用して、ノーコードで分割払いを受け付けます。

一部のコネクターとプラグインも分割払いに対応しています。

meses sin interes の要件

Meses sin intereses を使用できる取引とカードには制限があります。これらのルールをご自身で実装する必要はありません。支払い方法を設定すると、Meses sin intereses の対象となるかどうかが自動的に判断されます。

• Stripe はメキシコのアカウントでのみ分割払いをサポートしています。
• 支払い方法は、メキシコで発行されたクレジットカードである必要があります。
• カードは消費者向けカードである必要があります。分割払いは、法人向けカードには対応していません。
• カードは、サポート対象のカード発行会社のいずれかが発行したものである必要があります。
• 通貨の値は、MXN (ペソ) である必要があります。
• 支払い総額は、最低取引金額以上である必要があります。Stripe は、選択されたプランの月数に基づいて最低取引金額を指定します。ダッシュボードで、有効にする分割払いプランを指定し、カスタムの分割払いの設定を行うことでカスタムの最低取引金額と最高取引金額を定義できます。

1. Stripe ダッシュボードのカスタマーポータルの設定ページで顧客のポータルリンクを有効にします。
2. 同じページで、カスタマーポータルの設定オプションを実行します。コードを記述することなくカスタマーポータルを設定します。すべての設定オプションの詳細をご確認ください。
3. ポータルリンクを顧客と共有します。
4. オプション ブランディングをカスタマイズし、prefilled_email URL パラメーターをポータルリンクに追加してメールアドレスを事前入力します。

1. Stripe ダッシュボードで、決済用のリンクを作成します。
2. 商品またはサブスクリプションを選択します。
3. 継続的な寄付を表す継続支払いの商品を見つけるか、追加します。
4. 詳細設定で、行動喚起オプションを寄付に切り替えます。
5. リンクを作成して共有します。リンクを直接共有するか、サイトのボタンとして埋め込むか、QR コードを生成することができます。
6. ダッシュボードの支払いの概要で、決済用のリンクに関連付けられている支払いを追跡します。

決済用のリンクの作成と共有の詳細をご確認ください。