# 顧客

Stripe Invoicing で Customer オブジェクトを使用する方法を学びます。

請求対象の新しいユーザーまたはビジネスごとに顧客を作成します。新しい顧客を作成するときは、[最小限の顧客プロフィール](https://docs.stripe.com/invoicing/customer.md#customer-profile)を設定して、有用な請求書を生成し、Smart Retries を有効にします ([Invoicing Plus](https://stripe.com/invoicing/pricing) ユーザーの場合) 。顧客を設定すると、1 回限りの請求書の発行や、*サブスクリプション* (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)の作成を実行できます。

> #### Accounts v2 API を使用した顧客の表現
> 
> 代わりに、顧客を表すために顧客設定済みの `Account` オブジェクトを使用することもできます。`Accounts` を使用すると、Stripe の各プロダクト間で顧客を統一的に管理できます。
> 
> Accounts v2 API は Connect ユーザー向けに正式提供されており、その他の Stripe ユーザー向けには公開プレビューとして提供されています。`Customer` オブジェクトを使用する代わりに、[顧客を顧客設定済みの Account オブジェクトとしてモデル化する方法](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)について、詳細をご確認ください。

#### ダッシュボード

顧客を作成する前に、ダッシュボードの[顧客リスト](https://dashboard.stripe.com/customers)を確認して、同じ顧客が重複して存在しないかどうかを確かめてください。同一顧客に複数のレコードが存在すると、取引履歴の照合や保存済み決済手段の管理など、後々問題が発生する可能性があります。

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

### 顧客を作成する

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

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

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

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

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

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

### 顧客を編集する

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

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

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

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

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

### 顧客を削除する

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

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

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

#### API

新しい顧客を作成する前に、顧客がすでに存在していないことを確認します。たとえば、[全顧客の一覧表示](https://docs.stripe.com/api/customers/list.md) API にメールアドレスを渡します。

```curl
curl -G https://api.stripe.com/v1/customers \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d email={EMAIL_ADDRESS}
```

次の例は、メールアドレスとデフォルトの支払い方法を使用して、新しい顧客を作成する方法を示しています。API に渡すことができる引数の全一覧については、[顧客を作成する](https://docs.stripe.com/api/customers/create.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"
```

## 顧客プロフィール

基本的な顧客プロフィールは、請求書や領収書の生成に使用したり、お客様のアプリケーションの簡略なカスタマリレーションシップ管理システム (CRM) として使用できます。最小限の顧客プロフィールを作成するには、以下のプロパティーを設定します。

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

Stripe は顧客の[メールアドレス](https://docs.stripe.com/api/customers/object.md#customer_object-email)を使用して、支払い失敗を顧客に通知します。また、支払いを完了するために追加アクションが必要な場合にも、メールアドレスを使用して顧客に通知します。

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

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

[address 属性](https://docs.stripe.com/api/customers/object.md#customer_object-address)を使用して、請求書やクレジットノートの請求先住所を設定します。物品の配送には、[配送先](https://docs.stripe.com/api/customers/object.md#customer_object-shipping)住所を追加します。

> 請求書、クレジットノート、および領収書には請求先住所が表示されます。これは、税務コンプライアンスの一般的な要件です。

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

顧客を作成するときに、**言語**ドロップダウンを使用して、利用言語を追加します。また、**顧客の詳細**ページで、または請求書の作成時に顧客の利用言語を追加または編集することもできます。Stripe は選択された言語を使用して、請求書のメールや PDF、領収書のメールや PDF、クレジットノートの PDF をローカライズします。

API を介して言語を更新するには、[preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) パラメーターを使用します。このパラメーターは、利用言語の順序付きリストを優先順に並べ替えて受け入れます。これらの優先ロケール値は、[RFC-4646](https://tools.ietf.org/html/rfc4646) に従います。たとえば、英語の場合は en、カナダフランス語の場合は fr-CA となります。詳細については、[顧客の利用言語](https://docs.stripe.com/invoicing/customize.md#customer-language)をご覧ください。

## 顧客のプロパティー

次の表は、その他の顧客プロパティーを示しています。

| プロパティー | 説明 |
| --- | --- |
| 支払いのプロパティー | Stripe は、顧客に関連付けられた[支払い](https://docs.stripe.com/payments.md)の詳細を使用して、支払いを回収します。顧客が支払う際は、[支払い方法 API](https://docs.stripe.com/payments/payment-methods.md)、[顧客のクレジット残高](https://docs.stripe.com/invoicing/customer/balance.md)などの複数の方法を使用できます。顧客に設定できるのは、単通貨です。このため、通貨の割り当て、顧客への請求書送信、顧客のクレジット残高の設定などを行った後に通貨を変更することはできません。通貨が変更できない状態になったことは、ダッシュボードで**通貨**ドロップダウンが無効になることから確認できます。複数の通貨で 1 つの法人に請求する必要がある場合は、通貨ごとに新しい顧客を作成します。 |
| Invoicing のプロパティー | [請求書の処理関連のリソース](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings)はすべて、請求対象の顧客に関連付けられています。 |
| 税金のプロパティー | 税務管轄区域の要件を満たすために、請求書に顧客の納税者番号やその他の税関連情報を含める必要がある場合があります。顧客の請求書に、[納税者番号](https://docs.stripe.com/invoicing/customer/tax-ids.md)、[免税ステータス](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt)、[住所](https://docs.stripe.com/invoicing/customer.md#addresses)など、正しい情報がすべて含まれていることを確認するのは、お客様の責任です。納税者番号は、請求書に 1 つ以上の納税者番号を保存して表示するための手段です。免税ステータスは、その事業体が課税対象かどうかを示します。デフォルトでは、顧客の `tax_exempt` ステータスは `none` に設定されており、課税対象の請求エンティティであることを意味します。ただし、請求書の税を支払う必要がある顧客については、`tax_exempt` パラメーターを `reverse` に設定できます。ステータスを `exempt` に設定すると、顧客を免税として指定することもできます。`tax_exempt` と `reverse` の使用方法の詳細については、[Tax Rates](https://docs.stripe.com/tax/tax-rates.md#tax-exempt-and-reverse-charge) をご覧ください。 |

## 一般的なタスク

ここでは、`Customer` リソースで実行できる一般的なタスクの一部をご紹介します。

- **顧客に請求書を送信する**: 顧客を作成したら、顧客に[請求書を送信](https://docs.stripe.com/invoicing/dashboard.md#create-invoice)できます。

- **顧客のクレジット残高を保存する**: 顧客のクレジット残高機能を使用すると、特定の顧客にクレジットとデビットの調整を割り当て、その残高を顧客の以降の請求書に充当できます。

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

- **顧客の通貨を設定する**: ダッシュボードで**顧客**ページに移動し、顧客を選択して、**詳細**の隣にある**編集**をクリックして、請求書で顧客に請求するデフォルト通貨を設定できます。同じ顧客へのデフォルト通貨と異なる通貨を使用した請求の詳細については、[多通貨の顧客](https://docs.stripe.com/invoicing/multi-currency-customers.md)ページをご覧ください。

- **顧客を一括で作成する:** [Productivity Stripe アプリ](https://marketplace.stripe.com/categories/productivity) アプリを使用して、顧客を一括アップロードします。