# 顧客 Stripe Invoicing で 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 リファレンスに置き換えてください。 請求対象の新しいユーザーまたはビジネスごとに顧客を作成します。新しい顧客を作成するときは、[最小限の顧客プロフィール](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)の作成を実行できます。 > 新しい顧客を作成する前に、顧客がダッシュボードにすでに存在していないことを確認します。同じ顧客に対して複数の顧客のエントリーを作成すると、後で取引履歴を照合するときや保存された支払い方法を調整するときなどに、問題が発生する可能性があります。 #### ダッシュボード 顧客の作成にコードを使用したくない場合や、顧客に 1 回限りの請求書を使用して手動で請求する場合は、[顧客ページ](https://dashboard.stripe.com/customers)で顧客を作成して管理することができます。 > 請求書の作成中に、ダッシュボードで顧客を作成することもできます。 ### 顧客を作成する 新しい顧客を作成するときに、**メールアドレス**、**名前**、**国**などの顧客のアカウント情報や請求先情報を設定できます。顧客の利用言語、通貨、その他の重要な詳細情報も設定できます。 **顧客**ページでは、以下の操作も実行できます。 - 顧客をフィルタリングする。 - 顧客を削除する。 - すべての顧客を表示する。 - 顧客データのリストをエクスポートする。 顧客を作成するには、次の手順を実行します。 1. 顧客が存在しなくなっていることを確認します。 1. **顧客**ページで、**顧客を追加**をクリックするか、**N** を押します。 1. 少なくとも、顧客の**名前**と**アカウントのメールアドレス**を入力してください。 1. ダイアログで**顧客を追加**をクリックします。 ### 顧客を編集する 顧客のプロフィールを編集するには、次の手順を実行します。 1. **顧客**ページで、変更する顧客を見つけ、名前をクリックします。 1. アカウント情報ページで、**アクション** > **情報を編集**を選択します。 1. 顧客プロフィールを変更します。 1. **顧客情報を更新**をクリックします。 ### 顧客を削除する 顧客を削除するには、次の手順を実行します。 1. **顧客**ページで、削除する顧客を見つけます。 1. 顧客の名前の横にあるチェックボックスをクリックしてから、**削除**をクリックします。また、顧客の詳細ページをクリックして、**アクション** > **顧客を削除**を選択することもできます。 #### API 新しい顧客を作成する前に、顧客がすでに存在していないことを確認します。たとえば、[全顧客の一覧表示](https://docs.stripe.com/api/customers/list.md) API にメールアドレスを渡します。 ```curl curl -G https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={EMAIL_ADDRESS} ``` 次の例は、メールアドレスとデフォルトの支払い方法を使用して、新しい顧客を作成する方法を示しています。API に渡すことができる引数の全一覧については、[顧客を作成する](https://docs.stripe.com/api/customers/create.md)をご覧ください。 ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --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` の使用に関する詳細は、[税率](https://docs.stripe.com/billing/taxes/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) アプリを使用して、顧客を一括アップロードします。