サブスクリプションと定期支払い
継続的な請求の所有者を決定し、DEUNAのサブスクリプションエンジンを実装し、計画、料金、再試行、およびライフサイクル変更を安全に管理します。
このページで
DEUNAは、DEUNAのサブスクリプションエンジン、商社所有の請求システム、または継続的なバッチアップロードを通じて、継続的な支払いに対応します。 最初に、請求の対象者とタイミングを決定します。 その決定が統合と運用モデルを定義します。
請求の所有者を決定#
請求の所有者は、各金額を計算し、いつ請求するかを決定します。 支払い処理は、その指示を実行します。 2つのシステムが同じ請求を送信しないように、主要な所有者を1つ選択してください。
| アプローチ | 最適な選択 | 請求書発行者 | 請求がDEUNAに到達する方法 |
|---|---|---|---|
| DEUNA サブスクリプションエンジン | DEUNAがスケジュールする固定料金と計画ベースの料金 | DEUNA、構成された計画に基づいて | エンジンが各スケジュールされた料金を作成 |
| 商社サブスクリプションエンジン | 変動額または既存のサブスクリプションロジック | あなたの請求システム | あなたのバックエンドがDEUNAの支払いAPIを呼び出す |
| 定期的なバッチアップロード | 継続的な請求ファイルを準備する既存システム | あなたの請求システムまたは既存システム | DEUNAに適したDEUNAのVaultトークンを含む合意されたバッチを提供 |
DEUNA サブスクリプションエンジン
金額、通貨、頻度、更新の動作、オプションの初回課金、および再試行ポリシーを設定します。 顧客とサポートされている支払い方法を計画に関連付けます。 その後、DEUNAが料金をスケジュールします。
エンジンと継続的な支払い分類は、必要な商社とストアで有効にする必要があります。 プロセッサのサポート、トークンの移植性、ネットワークトランザクションのリンク、および認証要件は、後続の料金の資格を制限する可能性があります。
商社サブスクリプションエンジン
既存の請求処理ロジックを維持し、以下の機能を使用してください。 DEUNA 決済 API 各請求に対して。 請求額を計算し、合意を遵守し、コレクションをスケジュールし、重複を防止する責任は、システムにあります。
DEUNAは、後で商社が開始するトランザクションのリンクに使用できる、サポートされているネットワークトランザクション識別子を保持できます。 Vaultトークンは、保存されたカードの資格情報を識別します。 ネットワークトランザクション識別子は、トランザクション履歴を参照します。 これらは顧客の同意を置き換えず、移植性はプロバイダとネットワークによって異なります。
定期的なバッチアップロード
既存のプラットフォームがスケジュールされた請求をファイルとして準備する場合に使用します。 DEUNAとの合意には、ファイル形式、安全な配信、トークンの適合性、資格のあるプロセッサ、および各支払い結果の交換が含まれます。
バッチ受信は支払い承認ではなく、承認は決済ではありません。 すべての項目を最終的な支払い結果に照合してください。
共有された継続的な支払いライフサイクル#
上記のすべてのアプローチは、顧客の合意、再利用可能なサポートされている資格、明示的な請求決定、支払い処理、および照合という同じ基盤を必要とします。
継続的な支払い、CIT、およびMIT
- 継続的な支払い: 合意に基づいて繰り返し請求される料金。 金額は固定されている場合(例:メンバーシップ)または変動する場合(例:使用量ベースの請求)があります。
- 顧客主導のトランザクション (CIT): 顧客が積極的に行う支払い、初回支払いを含む。
- 商社主導のトランザクション (MIT): 以前の合意の下で、顧客が積極的に参加しない、あなたのビジネスが開始する後続のカード支払い。
「Recurring」は、支払いパターンを定義します。「MIT」は、支払いを発行する主体と、その権限を定義します。単にカードを保存するだけでは、後からの支払いが発生しません。
例えば、顧客が毎月の会員費の最初の支払いを「CIT」として支払い、後からの更新を承認することができます。その後の自動更新は「MIT」となります。「カードのトークン化」により、最初の支払いを遅らせることも可能です。
同意と認証
合意書、顧客認証が必要な場合は、事業内容と金額、支払い頻度、またはトリガー、および解約条件を明確に記載した契約書を作成し、必要な場合は顧客認証を行います。
第二の支払いサービス指令(PSD2)の下で、該当する「MIT」は、強力な顧客認証(SCA)を必要としない場合がありますが、これは再発の支払いに対する一般的な免除ではありません。リモートでの設定には、該当する条件下でのSCAが必要です。詳細は、 EBA の MIT ガイドライン および、必要に応じて設定 3D Secure (3DS) 認識
固定および変動の請求
| シナリオ | 顧客契約 | 請求決定 |
|---|---|---|
| 固定料金プラン | 定期的なスケジュールで定義された金額 | 設定されたプランは、金額と請求間隔を提供します。 |
| 変動料金 | 利用状況または価格に基づいて計算された金額 | 商人は、各請求の前に金額を計算します。 |
金額が変更される場合は、どのシステムがそれを計算し、選択したモデルがそのルールをサポートしていることを確認してください。
DEUNA サブスクリプションエンジン#
DEUNAエンジンは、プランと顧客のサブスクリプションを中心に、再発の請求を管理します。
ライフサイクルの概要
該当するトランジションは、プラン、解約、または一時停止ポリシー、およびアカウント設定によって異なります。 pending サブスクリプションをアクティブとして扱う前に、支払い結果を確認してください。
プラン参照
プランは、新しいサブスクリプションで使用される、商用およびスケジュール条件を定義します。
| 構成 | 目的 |
|---|---|
| 名前、説明、およびグループ | 提供を特定し、整理します。 |
| プランコード | プランを、システム内の識別子にマッピングします。 |
| 金額と通貨 | 各請求サイクルごとに固定金額を定義します。 |
| 請求間隔 | DEUNAが支払いをスケジュールする頻度を選択します。 |
| 自動更新 | サブスクリプションが期間終了後に更新されるかどうかを決定します。 |
| 課金開始の遅延 | 最初の支払いを後日実行するようにスケジュールします。 |
| ステータス | プランが新しいサブスクリプションに対して利用可能かどうかを決定します。 |
サポートされている請求間隔は DAILY, WEEKLY, BIWEEKLY, THIRTY_DAYS, SIXTY_DAYS, NINETY_DAYS, MONTHLY, BIMESTRIAL, QUARTERLY, ANNUAL, BIENNIAL, TRIANNUAL, および BIANNUAL.
サブスクリプション参照
サブスクリプションは、顧客をプランに接続し、そのライフサイクル、支払い方法、請求日、および処理されたトランザクションを記録します。
| 州 | 意味 |
|---|---|
pending | 作成済みですが、アクティブ化または最初の適用可能な支払いが完了していません。 |
active | 必要な支払い完了後にアクティブ化されます。 |
paused | サブスクリプションが再開されるまで、将来のスケジュールされた支払いは保留されます。 |
canceled | 選択されたポリシーに基づいて、解約が完了しています。 |
expired または ended | 設定された期間が終了しています。 |
遅延した最初の支払い
プランは、初回決済を即時ではなく、後日実行するように設定できます。以下のいずれかのモードを選択してください:
- 特定の月の日: 設定されたカレンダーの日付で課金。例えば、10月3日に作成されたサブスクリプションで、最初の課金日は10月10日となります。
- 獲得からの経過日数: 設定された遅延後に課金します。例えば、10月5日に作成されたサブスクリプションで、7日間の遅延を設定した場合、最初の課金は10月12日に行われます。
カードは、サブスクリプションが作成された時点でトークン化されます。ただし、課金は後から開始されます。このルールは、そのプランから作成されたサブスクリプションに適用されます。
再試行ポリシー
購読設定から、再試行動作を構成する 購読設定 管理画面のタブ:
- 最大試行回数;
- 再試行間隔と単位(分、時間、または日);
- 線形または指数関数的なバックオフ;
- 設定された試行回数が終了した場合に
pausedまたはcanceled移行
管理画面のプレビューでは、保存する前に計算された試行スケジュールが表示されます。 復旧の所有権を、商社側の再試行プロセスと連携し、同じ請求が複数回請求されないようにしてください。
サブスクリプション API を使用#
サブスクリプションの操作には、プライベートキーによるバックエンド認証を使用します。 API は、プラン、顧客のサブスクリプション、カード情報の変更、ライフサイクルアクション、および履歴を管理します。
| タスク | エンドポイント |
|---|---|
| プランの作成または一覧表示 | プランの作成 · プランの一覧表示 |
| プランの取得または更新 | プランの取得 · プランの更新 |
| サブスクリプションの作成または一覧表示 | サブスクリプションの作成 · サブスクリプションのリスト表示 |
| サブスクリプションの取得または更新 | サブスクリプションの取得 · サブスクリプションの更新 |
| 保存されたカードの変更 | サブスクリプションのカード情報の更新 |
| 支払いの一時停止または再開 | Приостановить · 再開 |
| サブスクリプションのキャンセル | Cancel |
| ライフサイクルイベントの確認 | サブスクリプション履歴の取得 |
管理画面で操作#
開きます DEUNA管理画面におけるサブスクリプションユーザーはサブスクリプションモジュールへのアクセス権が必要です。サブスクリプションプランの作成には、「プラン作成」の権限も必要です。
プランの作成
- 開きます サブスクリプション および、選択してください プラン tab.
- 選択 「プラン作成」セクションを選択し、.
- プラン名、コード、説明、グループ、金額、通貨、頻度、および更新ポリシーを入力
- 最初の支払いが後になる場合は、遅延開始を設定
- 設定を確認し、「選択」 プランを保存.
保存されたプランがアクティブであり、プランリストに表示されることを確認してから、新しいサブスクリプションを割り当てます。
サブスクリプションと取引の表示
- 開く サブスクリプション tab.
- 顧客のメールアドレス、作成日、プラン、またはステータスでフィルタリング
- サブスクリプションを開き、顧客の詳細、関連するプラン、請求日、金額、支払い方法、取引、およびライフサイクル履歴を確認
トランザクション結果(単にサブスクリプションの行が存在するかどうかではなく)を使用して、決済が成功したかどうかを確認します。
一時停止、再開、またはキャンセル
サブスクリプションを開き、「選択」をクリックし、必要な操作を選択します。 アクション、
| ポリシー | 効果 |
|---|---|
| 即時 | 現在の時点での一時停止またはキャンセルを適用 |
| 請求期間の終了 | 現在の期間中にサブスクリプションを維持し、その後変更を適用 |
| 特定の期日 | 選択した将来の日付に変更をスケジュール |
利用可能な場合は、理由を追加して、操作のコンテキストを維持します。 一時停止されたサブスクリプションは、同じ「アクション」メニューから再開できます。 どの操作を行った後も、サブスクリプションの詳細で結果のステータスと有効な日付を確認してください。
失敗した決済を安全に処理#
まず、解決されていない結果と確認された失敗を区別します。 元の決済が完了する可能性がある場合、新しい決済を開始しないでください。
- 必要な顧客認証は、サポートされているフローに顧客を戻す必要があります。 自動的な再試行は、これの代わりにはなりません。
- プロバイダーへのフォールバックには、有効な接続と、そのルートで利用できる認証情報が必要です。
- 後続のリトライは、顧客契約、プロセッサのルール、および設定されたリトライポリシーに準拠する必要があります。
- 通信エラーの場合、元の決済を再試行し、文書化された技術的なリトライルールに従ってください。
DEUNAによるカード決済を使用し、 支払いVault 認証情報をトークン化し、カードデータを商社システムから分離します。カード決済の委託は、商社のコンプライアンス責任を軽減しません。
展開前に検証#
非同期の結果については、 ウェブフック を使用し、更新する前に元のリソースを取得してください。