コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

顧客としてアカウントを使用する

顧客として設定されたアカウントから決済を受け付けます。

Accounts v2 では、Account オブジェクトに customer 設定を割り当てることで、Customer オブジェクトと同様に Account オブジェクトを使用することができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-11-17.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "individual": {
            "given_name": "Jenny Rosen"
        }
    },
    "configuration": {
        "customer": {
            "capabilities": {
                "automatic_indirect_tax": {
                    "requested": true
                }
            }
        }
    },
    "include": [
        "configuration.customer",
        "identity"
    ]
  }'

Accounts v2 を有効にすると、Checkout などの Stripe がホストする連携機能が customer 設定を使用して Account を作成します。コード内の Customer 参照を更新して、顧客設定の Account を参照することをお勧めします。

目的v1 リファレンスv2 リファレンス
顧客リファレンスcustomercustomer_account
顧客 IDcus_xxxxxacct_xxxxx
請求先住所の設定address
配送先住所の設定shippingconfiguration.customer.shipping

顧客として Account を指定

Subscriptions や SetupIntents といった API リクエストでは、顧客を指定する必要があります。これらのリクエストは、customer または customer_account のパラメーターを受け入れます。以下のサンプルは、Accounts v2 オブジェクトを customer_account として渡すことで顧客を指定するサブスクリプションの例です。

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
:" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d customer_account=acct_xxxxx \
  -d "items[0][price]"=price_CBb6IXqvTLXp3f \
  -d "items[0][quantity]"=5

Customers v1 の連携機能における参照アカウント

customer_account を指定するリクエストは customer と customer_account の両プロパティを、対応する形式の値で返します。これにより既存の Billing および Payments の連携機能との互換性が維持されます。

Example response
{
  "id": "sub_1Mow234",
  .
  .
  .
  "customer": "cus_xxxxx",
  "customer_account": "acct_xxxxx"
}

また、/v1/customers エンドポイントを使用して、顧客が設定した Account の取得または更新ができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/customers/acct_1234 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Accounts v2 Webhook

Accounts v2 の Webhook はシンイベントを送信します。

アクションv1 イベントv2 イベント
顧客が作成されましたcustomer.createdAccounts v2 は、アカウントの作成と顧客設定を示す個別のイベントを送信します。
  • v2.core.account.created
  • v2.core.account[configuration.customer].updated
請求書先住所が更新されましたcustomer.updatedv2.core.account[identity].updated
サブスクリプションアクションcustomer.subscription.[action]なし。v1 イベントを使用する
Customer deletedcustomer.deletedv2.core.account.closed

顧客請求書プロパティ

データ値顧客 v1 プロパティAccounts v2 プロパティ
顧客保管クレジットinvoice_credit_balanceなし。/v1/customers パスで Accounts v2 ID を参照する方法を参照
顧客請求書プレフィックスinvoice_prefixconfiguration.customer.billing.invoice.prefix
カスタム設定invoice_settings.custom_fieldsconfiguration.customer.billing.invoice.custom_fields
デフォルトの決済手段invoice_settings.default_payment_methodconfiguration.customer.billing.default_payment_method
請求書のフッターinvoice_settings.footerconfiguration.customer.billing.invoice.footer
請求書レンダリングオプションinvoice_settings.rendering_optionsconfiguration.customer.billing.invoice.rendering.template

v1/customers パスパラメーターで Accounts v2 ID を参照する

Accounts v2 には、すべての顧客機能にエンドポイントがあるわけではありません。Accounts v2 オブジェクトに対して次のアクションを実行するには、v1/customers エンドポイントを使用し、パスパラメーターとして Account ID (acct_xxxxx) を渡します。

ユースケースアカウント ID を使用した v1 エンドポイント
現金残高の管理
  • v1/customers/acct_xxxxx/cash_balances
  • v1/customers/acct_xxxxx/cash_balances/:id
現金残高取引を管理する
  • GET v1/customers/acct_xxxxx/cash_balance_transactions
  • GET v1/customers/acct_xxxxx/cash_balance_transactions/:id
  • POST v1/test_helpers/customers/acct_xxxxx/fund_cash_balance
  • POST v1/customers/acct_xxxxx/funding_instructions
  • GET v1/customers/acct_xxxxx/funding_instructions

請求書のクレジット残高の管理

Accounts v2 の場合、アカウントの直近に確定された請求書の ending_balance は、v1 の顧客の invoice_credit_balance に相当します。

  • POST v1/customers/acct_xxxxx/balance_transactions
  • POST v1/customers/acct_xxxxx/balance_transactions/:id
  • GET v1/customers/acct_xxxxx/balance_transactions/:id
  • GET v1/customers/acct_xxxxx/balance_transactions