コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
対面決済
決済手段
決済手段を追加
決済シナリオ
決済以外の機能

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

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

Stripe ではまもなく Charges API での ACH Direct Debit のサポートを終了いたします。Charges API を用いた直接の API 連携、請求書機能、サブスクリプション機能を使って ACH Direct Debit 決済を作成する場合、Payment Intents API または Checkout Sessions API に移行する必要があります。サポートが終了する前に、Stripe から詳細をメールでお知らせいたします。

過去に Tokens API を使って Stripe で顧客の支払い情報を収集した場合、その保存された BankAccount を PaymentMethod として引き続きお使いいただけます。Payment Intents API または Checkout Sessions API で顧客の銀行口座を利用できるのは、以下の要件を満たした場合のみです。

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

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

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

Checkout Sessions を使用する

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

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

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

Ruby
Python
Node.js
PHP
Java
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'


session = Stripe::Checkout::Session.create({
  mode: 'payment',
  ui_mode: 'custom',
  customer: '{{CUSTOMER_ID}}',
  payment_method_types: ['us_bank_account'],
  line_items: [{
    price_data: {
      currency: 'usd',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 1099,
    },
    quantity: 1,
  }],
  saved_payment_method_options: {
    allow_redisplay_filters: ['unspecified', 'always'],
  },
  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
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_methods/ba_1IsleZ2eZvKYlo2CI3To1g72 \
  -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