以前からご要望いただいていた、Customer Portalの請求書対応がついにローンチしました。

Customer Portalで新しくできるようになったこと

今回のアップデートで対応した機能は、以下の２つです。

請求書の履歴表示
メールで送信した請求書の支払い操作

請求書の履歴表示

これまでCustomer Portalでは、Billing（定期課金）のサブスクリプションで発生した請求履歴のみ表示していました。

今回のアップデートからは、同じ顧客に対して発行された請求書であれば、Customer Portal内でまとめて確認することができます。

サブスクリプションと同様に、領収書・請求書のダウンロードも可能です。

メールで送信した請求書の支払い操作

請求書を発行する際、登録済みの支払い方法へ自動的に請求するだけでなく、顧客に支払いリンクをメールで送信することができます。

この支払いリンクについても、Customer Portalから直接アクセスすることができます。

支払いが完了していない（オープン状態）の請求書がある場合、[インボイスの履歴]に[未完了]として項目が表示されます。

リンクをクリックすると、請求書と支払いフォームが表示されるページに移動します。

「商品データのない支払い」については、Customer Portalに表示されません

PaymentIntentやDashboardから直接支払いを実行した場合など、商品・料金データを利用せずに支払いを行なった場合については、従来通りCustomer Portalの履歴には表示されません。

そのため、Customer Portalで領収書や請求書の表示・ダウンロードを行いたい場合は、BillingとInvoicingを利用する必要がありますのでご注意ください。

納税番号の入力にも対応しています

今回のアップデート内容ではありませんが、Customer Portal上で請求先情報を編集する際に、納税番号の登録・更新も可能です。

Dashboardの設定画面からオン・オフの切り替えができますので、EUなどの海外向けにビジネスを展開されている方はぜひこちらもお試しください。

Customer PortalのURLを発行する方法（Node.js）

Customer PortalのURLを発行するには、サーバー側のプログラムにて、顧客のIDを利用して一時URLを発行する必要があります。

const stripe = new Stripe('sk_test_xxxxxx',{
  apiVersion: '2020-08-27'
})

const session = await stripe.billingPortal.sessions.create({
  customer: customerId
})
console.log(session.url)
// -> 'https://billing.stripe.com/session/test_xxxxx'

参考URL

具体的な設定方法や、Node.js以外での実装方法などについては、ドキュメントをご確認ください。

Docs - カスタマーポータルの組み込み
API Docs - Create a portal session

[PR] Stripe開発者向け情報をQiitaにて配信中！

2021年12月よりQiitaにて、Stripe開発者のためのブログ記事更新を開始しました。

[Stripe Updates]：開発者向けStripeアップデート紹介・解説
ユースケース別のStripe製品や実装サンプルの紹介
Stripeと外部サービス・OSSとの連携方法やTipsの紹介
初心者向けのチュートリアル(予定)

など、Stripeを利用してオンラインビジネスを始める方法について随時更新してまいります。

-> Stripe Organizationsをフォローして最新情報をQiitaで受け取る