コンテンツにスキップ
アカウントを作成またはサインイン
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"

If successful, the shipping selector appears in your checkout flow:

The shipping selector in the checkout flow

The shipping selector in the checkout flow

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

支払いが成功したら、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"

Your customer can see the calculated tax amount for the shipping rate factored into the total sales tax in your checkout flow:

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

Calculated tax amount for the shipping rate in the checkout flow

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