コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける継続課金
対面決済
決済手段
決済手段を追加
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

メモ

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

既存の銀行口座を移行する

既存の銀行口座を Payment Intents API または Checkout Sessions API に移行する方法をご紹介します。

Stripe is removing support for ACH Direct Debit using legacy integrations.

If you create legacy ACH Direct Debit payments, you must migrate to the Payment Intents API or Checkout Sessions API.

If you previously collected customer payment details with Stripe using the Tokens API, you can continue using the saved BankAccount as a PaymentMethod.

You can only use customer bank accounts with the Payment Intents API or Checkout Sessions API after you meet the following requirements:

  • Checkout Sessions API: 顧客の銀行口座が確認されました。

  • Payment Intents API: 顧客の銀行口座が確認されており、その銀行口座に対して有効な同意書が存在します。

Payment Intents または Checkout Sessions を使用するに当たり、認証済みの銀行口座を再認証する必要はありません。

Checkout Sessions を使用する

Checkout で以前に保存および確認された銀行口座を表示するには、以下を行う必要があります。

  • customer パラメーターを指定して Checkout セッションを作成する
  • フィルターを ['unspecified', 'always'] に設定する
  • payment_method_types に us_bank_account を指定

これらの要件が満たされると、Checkout は自動的にその顧客に関連付けられたすべての保存済みかつ確認済みの銀行口座を検出して表示するため、支払い情報を再度収集する必要がなくなります。

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 mode=payment \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "payment_method_types[0]"=us_bank_account \
  -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]"=1099 \
  -d "line_items[0][quantity]"=1 \
  -d "saved_payment_method_options[allow_redisplay_filters][0]"=unspecified \
  -d "saved_payment_method_options[allow_redisplay_filters][1]"=always \
  --data-urlencode return_url="YOUR_DOMAIN/complete?session_id={CHECKOUT_SESSION_ID}"

customer にメールアドレスが紐付いている場合、セッションに顧客のメールアドレスが事前入力され、変更することはできません。メールアドレスの有無を確認し、それに応じてメール入力欄を表示する必要があります。

const {checkout} = useCheckout();
const currentEmail = checkout.email;

if (currentEmail) {
  return <input value={currentEmail} readOnly />;
}

PaymentMethod として BankAccount を取得する

Payment Methods API を通じて、保存されている BankAccounts を取得できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_methods/
{{BANK_ACCOUNT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

BankAccount を PaymentMethod として使用する場合、新しいオブジェクトは作成されません。Payment Methods API は、基となる同じオブジェクトの異なるビューを提供するだけです。

{
  "id": "ba_1IsleZ2eZvKYlo2CI3To1g72",
  "object": "payment_method",
  "billing_details": {
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "email": null,
    "name": "Jenny Rosen",
    "phone": null
  },
  "us_bank_account": {
    "last4": "6789",
    "routing_number": "110000000",
    "fingerprint": "1JWtPxqbdX5Gamtc",
    "account_holder_type": "individual",
    "bank_name": "STRIPE TEST BANK",
  },
  "created": 123456789,
  "customer": "cus_CY5bH92D99f4mn",
  "livemode": false,
  "metadata": {},
  "type": "us_bank_account"
}

請求書

委任状の取得後に Invoicing を利用して継続するには、顧客のデフォルトの決済方法を更新するか、default_payment_method パラメーターを設定する必要があります。

顧客の初期設定の決済方法を更新するには:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[default_payment_method]"=
"{{BANK_ACCOUNT_ID}}"

決済方法として銀行口座を指定して請求書を作成するには、以下のようにします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d default_payment_method=
"{{BANK_ACCOUNT_ID}}"

サブスクリプション

委任状の取得後に Subscriptions を利用して継続するには、顧客のデフォルトの決済方法を更新するか、default_payment_method パラメーターを設定する必要があります。

顧客の初期設定の決済方法を更新するには:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[default_payment_method]"=
"{{BANK_ACCOUNT_ID}}"

決済方法として銀行口座を指定してサブスクリプションを作成する方法は以下の通りです。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d default_payment_method=
"{{BANK_ACCOUNT_ID}}"
 \
  -d "items[0][price]"=price_1MowQULkdIwHu7ixraBm864M

Identify Legacy ACH Payments

On a Charge object, the payment_method_details.type property is ach_debit for the legacy integration and us_bank_account for the newer integration.

A legacy ACH payment is created when a legacy BankAccount is the payment source. This happens when:

このページの内容