コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments
決済ページを構築
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
決済にとどまらない機能

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

配送料金を請求する

顧客向けにさまざまな配送料金を作成します。

配送料を使用すると、通常配送、エクスプレス配送、翌日配送など、さまざまな配送オプションを表示して、配達日の目安をより正確に提示できます。さまざまな Stripe プロダクトを使用して配送料を顧客に請求します。配送料を作成する前に、請求先住所と配送先住所を収集する方法を確認してください。

注

配送料は、注文全体に対する一定額のみ設定できます。注文の品目数に応じて配送料を調整することはできません。

配送料を作成する
ダッシュボード
サーバー側

注

配送料は、注文全体に対する一定額のみ設定できます。注文の品目数に応じて配送料を調整することはできません。

ダッシュボードを使用して配送料を追加するには、次の操作を実行します。

  1. 配送料を作成をクリックします。
  2. 金額、説明と、必要に応じて配達予定日を入力します。
  3. 保存をクリックし、配送料 ID (shr_123456) をコピーします。

配送料の詳細を入力する

配送料金を更新する

ダッシュボードで配送料金を更新することはできません。ダッシュボードボードで配送料金を更新するには、配送料金をアーカイブしてから、新しい配送料金を作成する必要があります。

配送料金をアーカイブする

配送料金をアーカイブするには

  1. 配送料金タブで、該当する配送料金を選択します。
  2. オーバーフローメニュー () をクリックし、アーカイブを選択します。

配送料金のアーカイブを解除するには、オーバーフローメニュー をクリックし、配送料金のアーカイブ解除を選択します。

Checkout セッションを作成する
サーバー側

配送料を含む Checkout セッションを作成するには、生成された配送料 ID を shipping_options パラメーターに渡します。Checkout セッションと同時に配送料を作成する場合は、shipping_rate_data パラメーターと shipping_options を使用します。配送オプションに対応しているのは、支払いモードの Checkout セッションのみです。

次のコードサンプルでは、Checkout セッションに 2 つの配送オプションを追加します。

  • 送料無料、配達予定日は 5 〜 7 営業日。
  • 翌日配送の航空便、費用は 15.00 USD、配達予定日はちょうど 1 営業日。

この例では、顧客が便利になるように、決済ページで shipping_options 配列の最初のオプションが事前に選択されています。ただし、顧客はどちらのオプションも選択できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d "shipping_address_collection[allowed_countries][1]"=CA \
  -d "shipping_options[0][shipping_rate_data][type]"=fixed_amount \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]"=0 \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]"=usd \
  -d "shipping_options[0][shipping_rate_data][display_name]"="Free shipping" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]"=5 \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]"=7 \
  -d "shipping_options[1][shipping_rate_data][type]"=fixed_amount \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][amount]"=1500 \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][currency]"=usd \
  -d "shipping_options[1][shipping_rate_data][display_name]"="Next day air" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][value]"=1 \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][value]"=1 \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

成功すると、決済ページに配送セレクターが表示されます。

決済ページに配送セレクターが表示される

決済ページに配送セレクターが表示される

オプション完了した取引を処理する

支払いが成功したら、shipping_cost の amount_total 属性で配送料を取得できます。shipping_cost の shipping_rate 属性を使用して、選択した配送料を取得することもできます。shipping_cost プロパティにアクセスするには、完了した Checkout セッションを処理するイベントハンドラーを作成する必要があります。ハンドラーをテストするには、Stripe CLI をインストールし、stripe listen --forward-to localhost:4242/webhook を使用してイベントをローカルサーバーに転送します。次のコードサンプルでは、ハンドラーによってユーザーが shipping_property にアクセスできます。

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# 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"


require 'sinatra'

# You can find your endpoint's secret in your webhook settings
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)
  selected_shipping_rate = Stripe::ShippingRate.retrieve(checkout_session.shipping_cost.shipping_rate)
  shipping_total = checkout_session.shipping_cost.amount_total

  # TODO: Remove error and implement...
  raise NotImplementedError.new(<<~MSG)
    Given the Checkout Session "#{checkout_session.id}" load your internal order from the database then implement your own fulfillment logic.
  MSG
end

オプション配送予定を定義する

配送料は、複数の配達予定日の組み合わせを使用して設定できます。次の表は、平易な英語での配送予定日と、それに対応する delivery_estimate.minimum と delivery_estimate.maximum の値の例を示しています。

配達予定日最短最長
1 日
{
  unit: 'day',
  value: 1,
}

{
  unit: 'day',
  value: 1,
}
1 営業日
{
  unit: 'business_day',
  value: 1,
}

{
  unit: 'business_day',
  value: 1,
}
2 営業日以上
{
  unit: 'business_day',
  value: 2,
}

null
3 日 ～ 7 日
{
  unit: 'day',
  value: 3,
}

{
  unit: 'day',
  value: 7,
}
4 時間 ～ 8 時間
{
  unit: 'hour',
  value: 4,
}

{
  unit: 'hour',
  value: 8,
}
4 時間 ～ 2 営業日
{
  unit: 'hour',
  value: 4,
}


{
  unit: 'business_day',
  value: 2,
}

オプション配送料金に対して課税する

Stripe Tax を使用すると、配送料に tax_code と tax_behavior を設定することで、配送料に対する税金を自動的に計算できます。Stripe Tax は配送料が課税対象かどうかを自動的に判断し (課税対象は州や国によって異なるため)、課税対象の場合は正しい税率を適用します。

shipping_rate_data を指定するか、配送料金の作成を使用して配送料金を作成する際に、配送料金に tax_behavior と tax_code パラメーターを追加できます。

常に正しい税率で課税されるように、tax_code を Shipping (txcd_92010001) に設定することをお勧めします。配送料金に対して課税しない場合は、配送料金の tax_code を Nontaxable (txcd_00000000) に設定することもできます。

この例では、tax_behavior を exclusive に設定します (アメリカではこれが一般的な設定となります)。税金処理で詳細をご覧ください。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d "shipping_address_collection[allowed_countries][1]"=CA \
  -d "shipping_options[0][shipping_rate_data][type]"=fixed_amount \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]"=0 \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]"=usd \
  -d "shipping_options[0][shipping_rate_data][display_name]"="Free shipping" \
  -d "shipping_options[0][shipping_rate_data][tax_behavior]"=exclusive \
  -d "shipping_options[0][shipping_rate_data][tax_code]"=txcd_92010001 \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]"=5 \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]"=7 \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][tax_behavior]"=exclusive \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

顧客は決済ページで、配送料金に対して計算された税額が算入された消費税の合計を確認できます。

決済ページで、配送料金に対する税額が計算される

決済ページで、配送料金に対する税額が計算される

このページはお役に立ちましたか。
はいいいえ