こんにちは、現役沖縄フリーランスエンジニアのmah（MaLanka）です。
このブログでは、
僕がIT未経験から約1年でフリーランスエンジニアになるまでの過程、
ノウハウなどを書いていきます。
今回は、
- 【Stripe】サブスクリプション決済成功時や返金時、カード支払い失敗時にユーザにメールを自動送信する
についてです。
【Stripe】サブスクリプション決済成功時や返金時、カード支払い失敗時にユーザにメールを自動送信する
やりたいこと
サブスクリプションでの決済が成功した時、
返金が成功した時、
カード支払いが失敗した時に、
それぞれ領収書やエラーの通知メールを自動で送信してほしい。
サブスクリプション決済成功時や返金時に、ユーザに自動でメールを送信する
ダッシュボード > 設定 > メール > 顧客のメール
から設定可能です。
https://dashboard.stripe.com/settings/emails
メール文言の言語も設定可能です。
カード支払い失敗時に、ユーザに自動でメールを送信
ダッシュボード > 設定 > 定期支払いおよびメール > 失敗した支払いの管理
から設定可能です。
https://dashboard.stripe.com/settings/billing/automatic
ドキュメント
https://stripe.com/docs/receipts
https://stripe.com/docs/receipts#receipts-with-billing
Stripeは、顧客が請求書を支払うとき、またはサブスクリプションの支払いを行うときに領収書を作成します。
サブスクリプションと請求書の支払いの領収書は、支払いに広告申込情報、割引、税金が含まれるように明細化されています。
領収書を自動的に送信するには、顧客のemailが設定されており、支払いが成功した場合に顧客に電子メールを送信するオプションが電子メールの領収書設定で有効になっていることを確認します。
Receipts with Billing Stripe creates receipts when a customer pays an invoice, or makes any subscription payment. Receipts for subscription and invoice payments are itemized to include line items, discounts, and taxes for the in the payment.
To automatically send receipts, ensure that the customer’s email is set and the option email customers for successful payments is enabled in your email receipt settings. After payment, the Hosted Invoice Page includes a link to a receipt that a customer can download for their own records. Stripe can also email your customers when subscription charges fail. Ensure that the option Send emails when payments fail is enabled in your Automatic collection settings.
補足
APIで支払い（Stripe::Charge）を作成する場合は、
パラメータ: receipt_email
を渡すことで領収書をメール送信してくれるようです。
https://stripe.com/docs/receipts#receipts-for-stripe-connect
The Charge object | Stripe API Reference
その他参考
http://settlement-term.w4c.work/status/346
本番環境 ・何れも決済成功時にメール自動送信可 ・但し、リクエスト時に「receipt_email」パラメータが必要
テスト環境 ・何れも決済成功後にメール手動送信可
