# 顧客

Stripe Billing で Customer リソースを使用する方法は以下のとおりです。

Connect プラットフォームが [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer) を使用している場合は、Stripe の [ガイド](https://docs.stripe.com/connect/use-accounts-as-customers.md)をご確認の上、コード内の `Customer` およびイベント参照を同等の Accounts v2 API リファレンスに置き換えてください。

*Customer (顧客)* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) リソースは、Stripe の主なエンティティです。これを使用して、*サブスクリプション* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis)および 1 回限りの*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)を顧客に請求するために必要な、すべてのプロファイル、請求、および税務に関する情報を保存します。

## 顧客を管理する

請求するすべての新規ユーザーまたはビジネス向けに顧客を作成します。新しい顧客を作成するときは、[最小限の顧客プロフィール](https://docs.stripe.com/billing/customer.md#minimum-customer-profile)を設定して、有用な請求書を作成し、Smart Retries (督促) を有効にします。顧客を作成して設定したら、それを使用してサブスクリプションを作成し、1 回限りの請求書を発行します。

#### ダッシュボード

顧客の作成にコードを使用したくない場合や、顧客に 1 回限りの請求書を使用して手動で請求する場合は、[顧客ページ](https://dashboard.stripe.com/customers)で顧客を作成して管理することができます。

> 請求書の作成中に、ダッシュボードで顧客を作成することもできます。

### 顧客を作成する

新しい顧客を作成するときに、**メールアドレス**、**名前**、**国**などの顧客のアカウント情報や請求先情報を設定できます。顧客の利用言語、通貨、その他の重要な詳細情報も設定できます。

**顧客**ページでは、以下の操作も実行できます。

- 顧客をフィルタリングする。
- 顧客を削除する。
- すべての顧客を表示する。
- 顧客データのリストをエクスポートする。

顧客を作成するには、次の手順を実行します。

1. 顧客が存在しなくなっていることを確認します。

1. **顧客**ページで、**顧客を追加**をクリックするか、**N** を押します。

1. 少なくとも、顧客の**名前**と**アカウントのメールアドレス**を入力してください。

1. ダイアログで**顧客を追加**をクリックします。

### 顧客を編集する

顧客のプロフィールを編集するには、次の手順を実行します。

1. **顧客**ページで、変更する顧客を見つけ、名前をクリックします。

1. アカウント情報ページで、**アクション** > **情報を編集**を選択します。

1. 顧客プロフィールを変更します。

1. **顧客情報を更新**をクリックします。

### 顧客を削除する

顧客を削除するには、次の手順を実行します。

1. **顧客**ページで、削除する顧客を見つけます。

1. 顧客の名前の横にあるチェックボックスをクリックしてから、**削除**をクリックします。また、顧客の詳細ページをクリックして、**アクション** > **顧客を削除**を選択することもできます。

#### API

顧客に請求する前に、Customer オブジェクトを作成する必要があります。このオブジェクトでは、名前、メールアドレス、および支払い方法を指定できます。詳細は、[導入ガイド](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md)に掲載されていますが、基本的な例は以下のようになります。

```curl
curl https://api.stripe.com/v1/customers \
  -u "<<YOUR_SECRET_KEY>>:" \
  --data-urlencode "email=jenny.rosen@example.com" \
  -d payment_method=pm_card_visa \
  -d "invoice_settings[default_payment_method]=pm_card_visa"
```

パラメーターの一覧については、API で[顧客を作成](https://docs.stripe.com/api/customers/create.md)する方法をご覧ください。

## 使用できるプロパティと用途

顧客リソースには、請求をカスタマイズするために設定できる多くの便利なプロパティがあります。このセクションでは、顧客に保存できるプロパティと、それぞれの効果について説明します。

### 顧客プロフィール

基本的な顧客プロフィールは、請求書や領収書の生成に利用でき、おおまかに言えば、申し込みの簡略な顧客関係管理システム (CRM) として機能します。[アフィリエイトおよび紹介制 Stripe Apps](https://marketplace.stripe.com/categories/affiliate_and_referrals) を使用し、Stripe と紹介や関連プログラムを設定して管理し、顧客情報を取得して Stripe ダッシュボードから手数料調整を自動化することもできます。

#### 最小限の顧客プロフィール

顧客を作成する際には、以下のプロパティを設定します。

- メールアドレス
- 顧客の氏名
- アプリケーションの内部顧客 ID への参照が設定されたメタデータ

Stripe は、[自動請求](https://docs.stripe.com/invoicing/automatic-collection.md)プロセスの一環として、[Email address (メールアドレス)](https://docs.stripe.com/api/customers/object.md#customer_object-email) を使用し、支払いが失敗した場合や、支払いを完了するために追加アクションが必要な場合に顧客に通知することができます。

アプリケーションの内部顧客 ID を[メタデータ](https://docs.stripe.com/api/customers/object.md#customer_object-metadata)属性に格納します。ほとんどの Stripe リソースと同様に、顧客リソースには [Metadata (メタデータ)](https://docs.stripe.com/api/metadata.md) オブジェクトハッシュが含まれ、コンテキストに応じたキーと値の情報を柔軟に格納できます。監査とサポートに利用できるように、内部顧客 ID をキーと値のペアとして顧客リソースに保存します。これにより、内部参照 ID を使用して顧客を検索できます。一方、Stripe の顧客 ID は、アプリケーションの内部顧客モデルと照合して保存することをお勧めします。

#### 請求先住所と配送先住所

請求 (請求書、クレジットノートなど) に使用される[住所](https://docs.stripe.com/api/customers/object.md#customer_object-address)、および (物品の) [配送先](https://docs.stripe.com/api/customers/object.md#customer_object-shipping)住所を設定するには住所プロパティーを使用します。

配送先住所は物品を配送するビジネスに最も深く関係しますが、請求先住所は、税務コンプライアンスの一般的な要件でもある、請求書、クレジットノート、および領収書に表示されるため、こちらも重要とされます。

#### メールと PDF 言語のローカリゼーション

`preferred_locales` プロパティを設定して、Stripe が生成したメールと PDF を現地に合わせた内容にします。このプロパティは、使用言語の順序付きリストを優先順に並べ替えて受け入れます。これらの優先ロケール値は、[RFC-4646](https://tools.ietf.org/html/rfc4646) に基づいています。 たとえば、英語の場合は “en”、カナダフランス語の場合は “fr-CA” となります。詳細については、[請求書のカスタマイズ](https://docs.stripe.com/invoicing/customize.md#customer-language)ページをご覧ください。

#### 顧客ごとの請求書設定

顧客ごとの請求書の内容をカスタマイズする方法については、[請求書のカスタマイズ](https://docs.stripe.com/invoicing/customize.md)ページをご覧ください。このページには、[カスタムフィールド](https://docs.stripe.com/invoicing/customize.md#custom-fields)、[請求書のフッター](https://docs.stripe.com/invoicing/customize.md#footer-field)の内容、および[請求書番号のカスタマイズ](https://docs.stripe.com/invoicing/customize.md#invoice-numbering-schemes)方法が記載されています。

### 支払い

支払いはすべて顧客に関連付けられた[支払い](https://docs.stripe.com/payments.md)詳細から回収され、顧客は以下を含む複数の方法で支払いできます。

- [支払い方法](https://docs.stripe.com/payments/payment-methods.md)
- [顧客のクレジット残高](https://docs.stripe.com/billing/customer.md#customer-balance)

顧客は [single-currency](https://docs.stripe.com/billing/customer.md#currency) であり、通貨の割り当て、請求書の発行、または [set a customer credit balance](https://docs.stripe.com/billing/customer.md#customer-balance) を行った後は、通貨を変更できません。このロックされたステータスは、ダッシュボードの **Currency** ドロップダウンが無効になっていることで確認できます。

多通貨で 1 つのエンティティに請求する必要がある場合は、通貨ごとに新しい顧客を作成します。

### 請求処理

すべての請求書の処理関連のリソースは、請求対象の顧客に関連付けられています。これらのリソースには以下が含まれます。

- [保留中の請求書アイテム](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items)
- [サブスクリプション](https://docs.stripe.com/billing/subscriptions/overview.md)
- [請求書](https://docs.stripe.com/invoicing/overview.md)
- [領収書](https://docs.stripe.com/receipts.md)
- [Invoice setting (請求書設定)](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings)

### 税金情報

税務管轄地域の要件を満たすため、請求書に顧客の納税者番号とその他の情報の記載が必要になる場合があります。顧客の請求書に正しい情報が記載されていることを確認することは、最終的にお客様の責任となります。確認事項には、[納税者番号](https://docs.stripe.com/billing/customer/tax-ids.md)、[非課税ステータス](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt)、[所在地](https://docs.stripe.com/billing/customer.md#addresses)が含まれます。

納税番号を使用することで、請求書に 1 つ以上の納税番号を保存して表示することができます。非課税ステータスは、その法人が課税対象かどうかを示します。デフォルトでは、顧客の `tax_exempt` ステータスは `none` に設定されており、これは課税対象の法人であることを意味します。ただし、`tax_exempt` プロパティを `reverse` に設定して顧客に請求書の税金を支払う責任があると指定したり、ステータスを `exempt` に設定することで、顧客が非課税であることを指定することができます。`tax_exempt` と `reverse` の使用に関する詳細は、[税率](https://docs.stripe.com/billing/taxes/tax-rates.md#tax-exempt-and-reverse-charge)ページをご覧ください。

## 一般的なタスク

このセクションでは、顧客リソースで行う一般的なタスクの一部を説明します。

### サブスクリプションを作成する

新しいサブスクリプションを作成する前に、請求目的のために顧客を作成する必要があります。

1. [顧客を作成](https://docs.stripe.com/billing/customer.md#create)します。
1. [商品](https://docs.stripe.com/products-prices/manage-prices.md#create-product)カタログと[価格](https://docs.stripe.com/products-prices/manage-prices.md#create-price)を定義します。
1. ステップ 1 で作成した顧客とステップ 2 で作成した価格 (または複数の価格) を使用して[サブスクリプションを作成](https://docs.stripe.com/billing/subscriptions/overview.md)します。

サブスクリプションを作成した後でも、請求書が [確定](https://docs.stripe.com/invoicing.md)されるまでは顧客の詳細を更新し続けることができます。どのような変更も次の請求期間で適用されます。このとき、新しい請求書は PDF、メール、オンライン請求書ページを作成・表示するときの顧客の最新ステータスを使って生成されます。詳細については、[サブスクリプションの仕組み](https://docs.stripe.com/billing/subscriptions/overview.md)のページをご覧ください。

### 顧客に 1 回限りの (手動) 請求書を送信する

サブスクリプションの請求書とは異なり、1 回限りの請求書は手動で発行され、自動スケジュールに従いません。このため、セットアップやインストールの手数料、コンサルティング料金、物品の 1 回の注文など、1 回限りの注文や作業の請求に利用できます。

1. [顧客を作成](https://docs.stripe.com/billing/customer.md#create)します。
1. 説明、数量、単価、税率の請求書ラインアイテムを追加し、[新しい下書き請求書を作成](https://docs.stripe.com/invoicing/dashboard.md#create-invoice)します。
1. [請求書の支払い方法を設定](https://docs.stripe.com/invoicing/dashboard.md#create-invoice)します。請求書の支払いを回収するには、登録されている支払い方法に自動的に請求するか、またはメールで請求書を顧客に送信します。
1. 請求書を確定します。

1 回限りの請求書の作成方法と支払いの回収方法の詳細については、[1 回限りの請求書に関するドキュメント](https://docs.stripe.com/invoicing/dashboard.md#create-invoice)をご覧ください。

### 顧客のクレジット残高を保存する

[顧客のクレジット残高](https://docs.stripe.com/billing/customer/balance.md)機能を使用すると、特定の顧客にクレジットとデビットの調整を割り当てることができます。ここで生じた残高は、その顧客の将来の請求書に適用されます。

### 納税者番号を追加および検証する

請求書ドキュメントに顧客の納税者番号を表示することは、一般的な要件です。Stripe では、1 人の顧客に 1 つまたは複数の[納税者番号](https://docs.stripe.com/billing/customer/tax-ids.md)を追加できます。顧客の納税者番号は、請求書およびクレジットノート PDF のヘッダーに表示されます。詳細については、[納税者番号](https://docs.stripe.com/billing/customer/tax-ids.md)をご覧ください。

### 顧客の通貨を設定する

`通貨`プロパティーは 3 文字の [ISO 通貨コード](https://docs.stripe.com/currencies.md)であり、継続請求において顧客に請求する際の通貨を指定します。通貨はダッシュボードの **顧客** > **詳細**ページで**詳細を更新**をクリックすると設定できます。一度設定された通貨は変更できません。請求書、請求項目、あるいは顧客のクレジット残高を作成すると、その顧客の通貨も恒久的に固定されます。