顧客
Customer (顧客) リソースは、Stripe の主なエンティティです。これを使用して、サブスクリプションおよび 1 回限りのインボイスを顧客に請求するために必要な、すべてのプロファイル、請求、および税務に関する情報を保存します。
顧客を管理する
請求するすべての新規ユーザーまたはビジネス向けに顧客を作成します。新しい顧客を作成するときは、最小限の顧客プロフィールを設定して、有用なインボイスを作成し、Smart Retries (督促) を有効にします。顧客を作成して設定したら、それを使用してサブスクリプションを作成し、1 回限りのインボイスを発行します。
使用できるプロパティとユーザ
顧客リソースには、請求体験をカスタマイズするために設定できる多くの便利なプロパティがあります。このセクションでは、顧客に保存できるプロパティと、それぞれの効果について説明します。
顧客プロフィール
基本的な顧客プロフィールは、インボイスや領収書の生成に利用でき、おおまかに言えば、アプリケーションでの簡略なカスタマリレーションシップ管理システム (CRM) として機能できます。
最小限の顧客プロフィール
顧客を作成する際には、以下のプロパティを設定します。
- メールアドレス
- 顧客の氏名
- アプリケーションの内部顧客 ID への参照が設定されたメタデータ
An email address lets Stripe notify the customer of failed payments or when completing a payment requires further action, as part of the Automatic Collection process.
Store the internal customer ID of your application in the metadata attribute. Like most Stripe resources, the Customer resource includes a Metadata object hash to flexibly store contextual key-value information. To aid in auditing and support, store your internal customer ID as a key-value pair on the Customer resource. This allows you to search for the customer using your internal reference ID. Conversely, we recommend storing Stripe customer IDs against the internal customer model of your application.
請求先住所と配送先住所
Use the address properties to set an address for billing (invoicing, credit notes, and so on), and a shipping address (for physical goods).
配送先住所は物品を配送するビジネスに最も深く関係しますが、請求先住所は、税務コンプライアンスの一般的な要件でもある、インボイス、クレジットノート、および領収書に表示されるため、こちらも重要とされます。
メールと PDF 言語のローカリゼーション
Localize Stripe-generated emails and PDFs by setting the preferred_locales
property. This property accepts an ordered list of preferred languages, sorted by preference. These preferred locale values are based on RFC-4646. Examples include “en” for English, or “fr-CA” for Canadian French. See the Customizing invoices page for more information.
顧客ごとのインボイス設定
For further details on customizing invoice contents on a per-customer basis, see the Customizing invoices page. It explains custom fields, invoice footer content, and how to customize the invoice number.
支払い
All payments are collected from payment details associated with a customer, and a customer can have multiple ways to make a payment, including:
顧客に設定できるのは、単通貨です。このため、通貨の割り当て、顧客へのインボイス送信、顧客のクレジット残高の設定などを行った後は、通貨を変更できなくなります。通貨が変更できない状態になったことは、ダッシュボードで通貨ドロップダウンが無効になることから把握できます。
多通貨で 1 つのエンティティに請求する必要がある場合は、通貨ごとに新しい顧客を作成します。
請求処理
All invoicing-related resources are associated with the customer being billed. These resources include:
税金情報
To meet tax jurisdiction requirements, you might need to include customer tax ID numbers and other information on invoices. It’s ultimately your responsibility to make sure your customer’s invoices contain the correct information. This includes tax IDs, tax exemption status, and addresses.
Tax IDs provide a way to store and render one or more tax ID numbers on invoices. Tax exemption status indicates whether the entity is taxable. By default, a customer’s tax_exempt
status is set to none
, meaning it’s a taxable billing entity. However, you can flag a customer as being responsible for paying the tax on an invoice by setting the tax_exempt
property to reverse
, or flag them as being tax exempt by setting the status to exempt
. You can read more about using tax_exempt
and reverse
on the Tax Rates page.
一般的なタスク
このセクションでは、顧客リソースで行う一般的なタスクの一部を説明します。
サブスクリプションを作成する
新しいサブスクリプションを作成する前に、請求目的のために顧客を作成する必要があります。
- 顧客を作成します。
- Define your product catalog and prices.
- Create a subscription using the customer created in step one and a price (or multiple prices) from step two.
You can continue to update the customer’s details after you create the subscription until an invoice is finalized. Any changes apply to the next billing cycle, when a new invoice is generated using the latest state of the customer when rendering PDFs, emails, and the hosted invoice page. Read the How subscriptions work page for more detailed information.
顧客に 1 回限りの (手動) インボイスを送信する
サブスクリプションのインボイスとは異なり、1 回限りのインボイスは手動で発行され、自動スケジュールに従いません。このため、セットアップやインストールの手数料、コンサルティング料金、物品の 1 回の注文など、1 回限りの注文や作業の請求に利用できます。
- 顧客を作成します。
- Create a new draft invoice by adding invoice line items with a description, quantity, unit price, and tax rate.
- Set the invoice payment method. You can collect payment for an invoice either by automatically charging the payment method on file, or by emailing the invoice to the customer.
- インボイスを確定します。
See the one-off invoices documentation for full details on how to create and collect payment for one-off invoices.
顧客のクレジット残高を保存する
The customer credit balance feature allows you to assign credit and debit adjustments to a specific customer. The resulting balance is applied to future invoices for that customer.
納税者番号を追加および検証する
Displaying a customer’s tax ID on invoice documents is a common requirement. With Stripe, you can add one or multiple tax IDs to a customer. A customer’s tax IDs are displayed in the header of invoice and credit note PDFs. See the Tax IDs page for more details.
顧客にクーポンを追加する
A coupon contains information about a percent-off or amount-off discount. Stripe Billing allows you to associate a coupon with a customer, resulting in a discount for all invoices billed.
インボイスを作成すると (手動でも、サブスクリプションで生成された場合でも)、クーポンが使用され、課税前の金額から割引額が差し引かれることで該当する割引が請求額に適用されます。この情報は、インボイスフッターのサマリーテーブルで確認できます。
顧客の通貨を設定する
The currency
property is a three-letter ISO code for the currency that you charge the customer in for recurring billing purposes. You can set the currency in the Dashboard by navigating to the Customers > Details page and clicking Update details. After you set the currency, you can’t change it. Creating an invoice or credit balance for the customer also permanently sets the customer’s currency.