顧客
Stripe Invoicing で Customer リソースを使用する方法をご紹介します。
請求対象の新しいユーザーまたはビジネスごとに顧客を作成します。新しい顧客を作成するときは、最小限の顧客プロフィールを設定して、有用な請求書を生成し、Smart Retries を有効にします (Invoicing Plus ユーザーの場合) 。顧客を設定すると、1 回限りの請求書の発行や、サブスクリプションの作成を実行できます。
注意
新しい顧客を作成する前に、顧客がダッシュボードにすでに存在していないことを確認します。同じ顧客に対して複数の顧客のエントリーを作成すると、後で取引履歴を照合するときや保存された支払い方法を調整するときなどに、問題が発生する可能性があります。
顧客プロフィール
基本的な顧客プロフィールは、請求書や領収書の生成に使用したり、お客様のアプリケーションの簡略なカスタマリレーションシップ管理システム (CRM) として使用できます。最小限の顧客プロフィールを作成するには、以下のプロパティーを設定します。
- メールアドレス。
- 顧客の名前。
- アプリケーションの内部顧客 ID への参照が設定されたメタデータ。
Stripe は顧客のメールアドレスを使用して、支払い失敗を顧客に通知します。また、支払いを完了するために追加アクションが必要な場合にも、メールアドレスを使用して顧客に通知します。
アプリケーションの内部顧客 ID を metadata 属性に格納します。他のほとんどの Stripe リソースと同様に、Customer リソースには Metadata (メタデータ) オブジェクトハッシュが含まれ、コンテキストに応じたキーと値の情報を柔軟に格納できます。監査とサポートに利用できるように、内部顧客 ID をキーと値のペアとして Customer リソースに保存します。これにより、内部参照 ID を使用して顧客を検索できます。アプリケーションの内部顧客モデルと対照させて Stripe 顧客 ID を保存することをお勧めします。
請求先住所と配送先住所
address 属性を使用して、請求書やクレジットノートの請求先住所を設定します。物品の配送には、配送先住所を追加します。
注
請求書、クレジットノート、および領収書には請求先住所が表示されます。これは、税務コンプライアンスの一般的な要件です。
メールと PDF 言語のローカリゼーション
顧客を作成するときに、言語ドロップダウンを使用して、利用言語を追加します。また、顧客の詳細ページで、または請求書の作成時に顧客の利用言語を追加または編集することもできます。Stripe は選択された言語を使用して、請求書のメールや PDF、領収書のメールや PDF、クレジットノートの PDF をローカライズします。
API を介して言語を更新するには、preferred_locales パラメーターを使用します。このパラメーターは、利用言語の順序付きリストを優先順に並べ替えて受け入れます。これらの優先ロケール値は、RFC-4646 に従います。たとえば、英語の場合は en、カナダフランス語の場合は fr-CA となります。詳細については、顧客の利用言語をご覧ください。
顧客のプロパティー
次の表は、その他の顧客プロパティーを示しています。
| プロパティー | 説明 |
|---|---|
| 支払いのプロパティー | Stripe は、顧客に関連付けられた支払いの詳細を使用して、支払いを回収します。顧客が支払う際は、支払い方法 API、顧客のクレジット残高などの複数の方法を使用できます。顧客に設定できるのは、単通貨です。このため、通貨の割り当て、顧客への請求書送信、顧客のクレジット残高の設定などを行った後に通貨を変更することはできません。通貨が変更できない状態になったことは、ダッシュボードで通貨ドロップダウンが無効になることから確認できます。複数の通貨で 1 つの法人に請求する必要がある場合は、通貨ごとに新しい顧客を作成します。 |
| Invoicing のプロパティー | 請求書の処理関連のリソースはすべて、請求対象の顧客に関連付けられています。 |
| 税金のプロパティー | 税務管轄地域の要件を満たすため、請求書に顧客の納税者番号とその他の情報の記載が必要になる場合があります。納税者番号、非課税ステータス、所在地などの情報が、顧客の請求書に正しく記載されていることを確認するのは、お客様の責任となります。納税者番号を使用することで、請求書に 1 つ以上の納税者番号を保存して表示することができます。非課税ステータスは、その法人が課税対象かどうかを示します。デフォルトでは、顧客の tax_ ステータスは none に設定され、課税対象の法人であることを意味します。ただし、請求書の税金を支払う必要がある顧客に対しては、tax_ パラメーターを reverse に設定できます。また、ステータスを exempt に設定することで、顧客が非課税であると指定することもできます。tax_ と reverse の使用に関する詳細は、税率をご覧ください。 |
一般的なタスク
ここでは、Customer リソースで実行できる一般的なタスクの一部をご紹介します。
顧客に請求書を送信する: 顧客を作成したら、顧客に請求書を送信できます。
顧客のクレジット残高を保存する: 顧客のクレジット残高機能を使用すると、特定の顧客にクレジットとデビットの調整を割り当て、その残高を顧客の以降の請求書に充当できます。
納税者番号を追加および検証する: 請求書に顧客の納税者番号を表示することは、一般的な要件です。Stripe では、1 人の顧客に複数の納税者番号を追加できます。顧客の納税者番号は、請求書およびクレジットノート PDF のヘッダーに表示されます。詳細については、顧客の納税者番号をご覧ください。
顧客にクーポンを追加する: クーポンには、割引率または割引額の情報が含まれます。Stripe Invoicing では顧客にクーポンを関連付けることができます。クーポンは課税前の請求書の金額に割引を適用します。
顧客の通貨を設定する: ダッシュボードで顧客ページに移動し、顧客を選択して、詳細の隣にある編集をクリックして、請求書で顧客に請求するデフォルト通貨を設定できます。同じ顧客へのデフォルト通貨と異なる通貨を使用した請求の詳細については、多通貨の顧客ページをご覧ください。
顧客を一括で作成する: Productivity Stripe アプリ アプリを使用して、顧客を一括アップロードします。