/api/v1/subscription/manage から取得し、顧客をそこへ送ります。Waffo がお客様の顧客に送るメールからも
リンクできます。顧客へのサブスクリプションメール を参照してください。
どのサブスクリプションの管理リンクを取得できますか？
有効なサブスクリプションとして実際に存在したことのあるもの — すでに終了したものを含みます。A0028 はどういう意味ですか？
A0028 — Subscription is still in progress or has failed and management url is
not available
サブスクリプションが一度も有効にならなかったことを意味します。顧客が確認を完了していない、まだマンデートを承認していない、
または有効化される前にサブスクリプションが終了した、のいずれかです。管理するものがないため、リンクは発行されません。
これは権限や設定のエラーではなく、ステータスが変わらない限り再試行しても解決しません。代わりに行うこと：
IN_PROGRESS/AUTHORIZATION_REQUIRED— 顧客はまだ承認を完了していません。管理リンクではなく、作成レスポンスのsubscriptionAction.webUrlへ送ってください。CLOSE— サブスクリプションは終了しており、復活できません。新しく作成してください。
キャンセル済みや期限切れのサブスクリプションでもページを開けますか？
はい。それは意図的な設計です。顧客はプランと課金履歴を引き続き確認できます。キャンセル後に顧客が求めるのは、 たいていまさにそれです。 そこでできないのは操作です。ACTIVE でないサブスクリプションでは決済手段の変更は拒否され、キャンセルするものも残っていません。
そのため、終了したサブスクリプションのページは読み取り専用の記録であり、再購読の入口ではありません。戻ってきた顧客が
プランを再開したい場合は、/api/v1/subscription/create による新しいサブスクリプションになります。
リンクはどのくらい有効ですか？ 新しいリンクは古いリンクを無効にしますか？
/api/v1/subscription/manage を呼び出すごとに、新しい独立したリンクが発行されます。各リンクには独自の有効期限があり、
レスポンスがそれを伝えます。
設計時に考慮すべき結果：
- 新しいリンクを発行しても、以前のリンクは無効になりません。 数分差で発行された 2 つのリンクは、それぞれの
expiredAtが 過ぎるまで両方とも機能します。すでに送ったリンクを取り消すためにmanageを再度呼び出すことに頼らないでください。 expiredAtを読み取ってください。有効期間をハードコードしないでください。 この期間は短く、契約ではなく設定です。 リンクは受け渡しであり、ブックマークではありません。保存しておいて後でメールするのではなく、顧客がクリックする瞬間に 発行してください。manageを繰り返し呼び出しても問題ありません。サブスクリプションへの副作用はありません。
Waffo のメールを、Waffo のページではなく自社の管理ページに向けることはできますか？
はい。Waffo の顧客向けメール内の管理リンクが Waffo のホスト型ページを指すか、お客様が指定した URL を指すかは アカウントごとの設定です。
これが
subscriptionManagementUrl の用途であり、このフィールドがアプリのディープリンクではなく、顧客がデスクトップブラウザーで
開けるものを指すべき理由です。設定の切り替えはセルフサービスのトグルではなく、Waffo の担当者への依頼になります。
メールから管理リンクを完全に取り除く設定はありません。Waffo のメールで顧客をどこにも誘導したくない場合、取れる手段はメール自体を
オフにして自社からメールを送ることです。顧客へのサブスクリプションメール を
参照してください。
顧客はページで実際に何を見て、何ができますか？
見る — プランとその課金履歴を、加盟店向け照会 API が返すより詳細に：
する — 3 つのこと：
決済手段のルールと、追加すると 0 金額の注文が作成される理由は
サブスクリプションの再試行と決済手段 にあります。
決済手段の管理を、自社のバックエンドから行うことはできますか？
いいえ。サブスクリプションの決済手段を追加、置換、並べ替え、削除する加盟店向けエンドポイントはありません。公開されている サブスクリプション API はcreate、inquiry、cancel、manage、change、change/inquiry、update であり、
いずれも紐づく決済手段の一覧には触れません。
自社プロダクトからできること：
/api/v1/subscription/inquiryから紐づく決済手段とcanChangePaymentMethodフラグを読み取り、独自のビューを表示する。- 実際の変更を行うために、顧客をホスト型ページへ送る。
- 異なる
paymentInfoでプラン変更を行い、チェックアウトで再承認させることで、顧客を別の決済手段へ移す。 サブスクリプションのプラン変更 を参照してください。
ページでのキャンセルは即時ですか、それとも期間終了時ですか？
即時です。 顧客が確認すると、サブスクリプションはUSER_CANCELLED に移り、以降の課金期間は開かれません。
ページには期間終了時のオプションはなく、/api/v1/subscription/cancel も即時です。
これははっきり述べておく価値があります。加盟店自身のプロダクトルールとの最もよくある不一致だからです。Waffo がキャンセルするのは
課金であり、利用権ではありません。「支払済み期間が終わるまでサービスを維持する」というポリシーであれば、お客様側で実装します。
- サブスクリプションのステータス通知を監視します。
- キャンセル時、顧客がすでに支払った期間の終了までアクセスを維持します。その日付は、キャンセル前の
nextPaymentDateTime、 または課金履歴上の現在の期間の終了日から分かります。 - その時点でアクセスを取り消します。
startTime を持つプラン変更です。これは古いプランを現在の期間の終了まで
稼働させてから廃止します。本当の要件が「サイクル終了時にダウングレードする」ことであれば、キャンセルではなくこれが
そのための仕組みです。
顧客がページでキャンセルすると、どのステータス変更と Webhook を受け取りますか？
サブスクリプションはUSER_CANCELLED に移り、そのステータスを持つサブスクリプションステータス通知を受信します。
「ホスト型ページでキャンセルされた」という別のイベントはありません。
自社レコードではなく、その Webhook をトリガーとして扱ってください。このキャンセルを開始したのはお客様ではないため、
通知を処理するまでお客様側はサブスクリプションがまだ有効だと認識しています。USER_CANCELLED と MERCHANT_CANCELLED の違いが、
顧客起点の離脱とお客様が実行したものを見分ける方法です。
すでに回収されたお金はキャンセルによって変わりません。現在の期間分を顧客に返したい場合は、その期間の課金を返金してください。
返金 を参照してください。
ページはどこまでブランディングできますか？
ページは、サブスクリプションに設定されたチェックアウトの外観とロゴ — チェックアウトで使用しているのと同じcashierAppearance とブランド設定 — を引き継ぎます。そのため、顧客がブランドのないページに着地するのではなく、
色、タイポグラフィ、ロゴが反映されます。
設定できないもの：
したがって、「顧客がここでキャンセルできてはならない」という要件がある場合、答えはページを設定することではありません。
顧客をそこへ送らないこと、そして Waffo のメールを自社の管理 URL に向けることです。
ページはどの言語で表示されますか？
Waffo がサブスクリプションのチェックアウトとメールに使用するのと同じ解決方法です。- サブスクリプションにチェックアウト言語を設定していれば、その言語。
- そうでなければ、サブスクリプションの課金通貨から導出。
- フォールバックとして英語。