メインコンテンツへスキップ
このページで

DEUNAは、DEUNAのサブスクリプションエンジン、商社所有の請求システム、または継続的なバッチアップロードを通じて、継続的な支払いに対応します。 最初に、請求の対象者とタイミングを決定します。 その決定が統合と運用モデルを定義します。

請求の所有者を決定#

請求の所有者は、各金額を計算し、いつ請求するかを決定します。 支払い処理は、その指示を実行します。 2つのシステムが同じ請求を送信しないように、主要な所有者を1つ選択してください。

アプローチ最適な選択請求書発行者請求がDEUNAに到達する方法
DEUNA サブスクリプションエンジンDEUNAがスケジュールする固定料金と計画ベースの料金DEUNA、構成された計画に基づいてエンジンが各スケジュールされた料金を作成
商社サブスクリプションエンジン変動額または既存のサブスクリプションロジックあなたの請求システムあなたのバックエンドがDEUNAの支払いAPIを呼び出す
定期的なバッチアップロード継続的な請求ファイルを準備する既存システムあなたの請求システムまたは既存システムDEUNAに適したDEUNAのVaultトークンを含む合意されたバッチを提供
DEUNA サブスクリプションエンジン計画ベースのスケジュール

金額、通貨、頻度、更新の動作、オプションの初回課金、および再試行ポリシーを設定します。 顧客とサポートされている支払い方法を計画に関連付けます。 その後、DEUNAが料金をスケジュールします。

エンジンと継続的な支払い分類は、必要な商社とストアで有効にする必要があります。 プロセッサのサポート、トークンの移植性、ネットワークトランザクションのリンク、および認証要件は、後続の料金の資格を制限する可能性があります。

商社サブスクリプションエンジンシステムが各支払いスケジュール

既存の請求処理ロジックを維持し、以下の機能を使用してください。 DEUNA 決済 API 各請求に対して。 請求額を計算し、合意を遵守し、コレクションをスケジュールし、重複を防止する責任は、システムにあります。

DEUNAは、後で商社が開始するトランザクションのリンクに使用できる、サポートされているネットワークトランザクション識別子を保持できます。 Vaultトークンは、保存されたカードの資格情報を識別します。 ネットワークトランザクション識別子は、トランザクション履歴を参照します。 これらは顧客の同意を置き換えず、移植性はプロバイダとネットワークによって異なります。

定期的なバッチアップロードファイルベースの請求

既存のプラットフォームがスケジュールされた請求をファイルとして準備する場合に使用します。 DEUNAとの合意には、ファイル形式、安全な配信、トークンの適合性、資格のあるプロセッサ、および各支払い結果の交換が含まれます。

バッチ受信は支払い承認ではなく、承認は決済ではありません。 すべての項目を最終的な支払い結果に照合してください。

共有された継続的な支払いライフサイクル#

上記のすべてのアプローチは、顧客の合意、再利用可能なサポートされている資格、明示的な請求決定、支払い処理、および照合という同じ基盤を必要とします。

フロー図
1Customer agreement2Card capture andsetup3Billing ownercalculates amountand due date4DEUNA processespayment5Merchant reconcilesfinal result
商社または顧客結果またはアウトカムDEUNA
継続的な支払い、CIT、およびMITコア用語
  • 継続的な支払い: 合意に基づいて繰り返し請求される料金。 金額は固定されている場合(例:メンバーシップ)または変動する場合(例:使用量ベースの請求)があります。
  • 顧客主導のトランザクション (CIT): 顧客が積極的に行う支払い、初回支払いを含む。
  • 商社主導のトランザクション (MIT): 以前の合意の下で、顧客が積極的に参加しない、あなたのビジネスが開始する後続のカード支払い。

「Recurring」は、支払いパターンを定義します。「MIT」は、支払いを発行する主体と、その権限を定義します。単にカードを保存するだけでは、後からの支払いが発生しません。

例えば、顧客が毎月の会員費の最初の支払いを「CIT」として支払い、後からの更新を承認することができます。その後の自動更新は「MIT」となります。「カードのトークン化」により、最初の支払いを遅らせることも可能です。

固定および変動の請求請求金額の所有者を指定
シナリオ顧客契約請求決定
固定料金プラン定期的なスケジュールで定義された金額設定されたプランは、金額と請求間隔を提供します。
変動料金利用状況または価格に基づいて計算された金額商人は、各請求の前に金額を計算します。

金額が変更される場合は、どのシステムがそれを計算し、選択したモデルがそのルールをサポートしていることを確認してください。

DEUNA サブスクリプションエンジン#

DEUNAエンジンは、プランと顧客のサブスクリプションを中心に、再発の請求を管理します。

ライフサイクルの概要

フロー図
Activation succeedsPause policy takeseffectResumeCancellation takeseffectTerm completes1Plan available2Subscription pending3Active4Paused5Canceled6Expired or ended
レビューまたは保留中例外または停止

該当するトランジションは、プラン、解約、または一時停止ポリシー、およびアカウント設定によって異なります。 pending サブスクリプションをアクティブとして扱う前に、支払い結果を確認してください。

プラン参照フィールドと請求間隔

プランは、新しいサブスクリプションで使用される、商用およびスケジュール条件を定義します。

構成目的
名前、説明、およびグループ提供を特定し、整理します。
プランコードプランを、システム内の識別子にマッピングします。
金額と通貨各請求サイクルごとに固定金額を定義します。
請求間隔DEUNAが支払いをスケジュールする頻度を選択します。
自動更新サブスクリプションが期間終了後に更新されるかどうかを決定します。
課金開始の遅延最初の支払いを後日実行するようにスケジュールします。
ステータスプランが新しいサブスクリプションに対して利用可能かどうかを決定します。

サポートされている請求間隔は DAILY, WEEKLY, BIWEEKLY, THIRTY_DAYS, SIXTY_DAYS, NINETY_DAYS, MONTHLY, BIMESTRIAL, QUARTERLY, ANNUAL, BIENNIAL, TRIANNUAL, および BIANNUAL.

サブスクリプション参照状態と顧客関係

サブスクリプションは、顧客をプランに接続し、そのライフサイクル、支払い方法、請求日、および処理されたトランザクションを記録します。

州意味
pending作成済みですが、アクティブ化または最初の適用可能な支払いが完了していません。
active必要な支払い完了後にアクティブ化されます。
pausedサブスクリプションが再開されるまで、将来のスケジュールされた支払いは保留されます。
canceled選択されたポリシーに基づいて、解約が完了しています。
expired または ended設定された期間が終了しています。
遅延した最初の支払い特定の1日または日数

プランは、初回決済を即時ではなく、後日実行するように設定できます。以下のいずれかのモードを選択してください:

  • 特定の月の日: 設定されたカレンダーの日付で課金。例えば、10月3日に作成されたサブスクリプションで、最初の課金日は10月10日となります。
  • 獲得からの経過日数: 設定された遅延後に課金します。例えば、10月5日に作成されたサブスクリプションで、7日間の遅延を設定した場合、最初の課金は10月12日に行われます。

カードは、サブスクリプションが作成された時点でトークン化されます。ただし、課金は後から開始されます。このルールは、そのプランから作成されたサブスクリプションに適用されます。

再試行ポリシー試行、タイミング、およびターミナルの状態

購読設定から、再試行動作を構成する 購読設定 管理画面のタブ:

  • 最大試行回数;
  • 再試行間隔と単位(分、時間、または日);
  • 線形または指数関数的なバックオフ;
  • 設定された試行回数が終了した場合に paused または canceled 移行

管理画面のプレビューでは、保存する前に計算された試行スケジュールが表示されます。 復旧の所有権を、商社側の再試行プロセスと連携し、同じ請求が複数回請求されないようにしてください。

サブスクリプション API を使用#

サブスクリプションの操作には、プライベートキーによるバックエンド認証を使用します。 API は、プラン、顧客のサブスクリプション、カード情報の変更、ライフサイクルアクション、および履歴を管理します。

タスクエンドポイント
プランの作成または一覧表示プランの作成 · プランの一覧表示
プランの取得または更新プランの取得 · プランの更新
サブスクリプションの作成または一覧表示サブスクリプションの作成 · サブスクリプションのリスト表示
サブスクリプションの取得または更新サブスクリプションの取得 · サブスクリプションの更新
保存されたカードの変更サブスクリプションのカード情報の更新
支払いの一時停止または再開Приостановить · 再開
サブスクリプションのキャンセルCancel
ライフサイクルイベントの確認サブスクリプション履歴の取得

管理画面で操作#

開きます DEUNA管理画面におけるサブスクリプションユーザーはサブスクリプションモジュールへのアクセス権が必要です。サブスクリプションプランの作成には、「プラン作成」の権限も必要です。

プランの作成管理手順
  1. 開きます サブスクリプション および、選択してください プラン tab.
  2. 選択 「プラン作成」セクションを選択し、.
  3. プラン名、コード、説明、グループ、金額、通貨、頻度、および更新ポリシーを入力
  4. 最初の支払いが後になる場合は、遅延開始を設定
  5. 設定を確認し、「選択」 プランを保存.

保存されたプランがアクティブであり、プランリストに表示されることを確認してから、新しいサブスクリプションを割り当てます。

サブスクリプションと取引の表示フィルタと詳細
  1. 開く サブスクリプション tab.
  2. 顧客のメールアドレス、作成日、プラン、またはステータスでフィルタリング
  3. サブスクリプションを開き、顧客の詳細、関連するプラン、請求日、金額、支払い方法、取引、およびライフサイクル履歴を確認

トランザクション結果(単にサブスクリプションの行が存在するかどうかではなく)を使用して、決済が成功したかどうかを確認します。

一時停止、再開、またはキャンセル即時またはスケジュールされた変更

サブスクリプションを開き、「選択」をクリックし、必要な操作を選択します。 アクション、

ポリシー効果
即時現在の時点での一時停止またはキャンセルを適用
請求期間の終了現在の期間中にサブスクリプションを維持し、その後変更を適用
特定の期日選択した将来の日付に変更をスケジュール

利用可能な場合は、理由を追加して、操作のコンテキストを維持します。 一時停止されたサブスクリプションは、同じ「アクション」メニューから再開できます。 どの操作を行った後も、サブスクリプションの詳細で結果のステータスと有効な日付を確認してください。

失敗した決済を安全に処理#

まず、解決されていない結果と確認された失敗を区別します。 元の決済が完了する可能性がある場合、新しい決済を開始しないでください。

フロー図
Unknown or pendingCustomer actionrequiredConfirmed failureNoEligible providerEligible later attempt1Collection result2Reconcile originalpayment3Return customer tosupported flow4Recovery allowed?5Stop automaticrecovery6Use configuredprovider fallback7Retry under oneowner and policy
結果またはアウトカム商社または顧客例外または停止プロバイダーまたはプロセッサレビューまたは保留中
  • 必要な顧客認証は、サポートされているフローに顧客を戻す必要があります。 自動的な再試行は、これの代わりにはなりません。
  • プロバイダーへのフォールバックには、有効な接続と、そのルートで利用できる認証情報が必要です。
  • 後続のリトライは、顧客契約、プロセッサのルール、および設定されたリトライポリシーに準拠する必要があります。
  • 通信エラーの場合、元の決済を再試行し、文書化された技術的なリトライルールに従ってください。

DEUNAによるカード決済を使用し、 支払いVault 認証情報をトークン化し、カードデータを商社システムから分離します。カード決済の委託は、商社のコンプライアンス責任を軽減しません。

展開前に検証#

非同期の結果については、 ウェブフック を使用し、更新する前に元のリソースを取得してください。

次のステップ#