サブスクリプションと定期支払い
このページで
DEUNA は、独自のサブスクリプションエンジン、既存の請求システム、または定期的なバッチアップロードを通じて定期支払いをサポートします。このページでは、定期支払いの概念について説明し、適切なアプローチを選択するのに役立ち、DEUNA のサブスクリプションエンジンの仕組みを説明し、管理画面でのプランとサブスクリプションの管理方法を示し、展開前に検証する必要があるものをリストします。
主要な概念#
定期支払い、MIT、CIT
定期支払い 顧客との合意に基づいて、料金を繰り返し回収します。料金は一定の場合もあります（例：月額メンバーシップ）、または利用状況に基づいて変動する場合もあります（例：電気料金）。自動回収により、顧客は手動で各支払いを完了することなく、将来の請求を支払うことができます。
A 商社による取引 (MIT) これは、顧客の積極的な参加なしで、事前に合意したカード決済です。 顧客による取引 (CIT) これは、顧客が積極的に行う支払いであり、保存されたカードを使用する場合も含まれます。
「定期支払い」とは、繰り返し回収することを指します。「MIT」とは、支払いを発行する主体と、その権限を指します。「自動的なカードによる定期回収」は、MIT の一般的な使用例ですが、これらの用語は互換性がないわけではありません。単にカードを保存するだけでは、将来の回収を許可するものではありません。
たとえば、顧客が仮説上の10ドル/月の会員に登録します。 登録時に実際に10ドルを支払い、自動的な月額更新に同意します。 この登録時の支払いは、CIT（継続的な支払い）です。 次の月、貴社は顧客が操作することなく、合意された更新料金を回収します。 この支払いは、MIT（間欠的な支払い）です。 また、登録時に最初の課金を遅らせるために、カードを保存することも可能です。
サブスクリプション、請求、および支払い処理
- サブスクリプション: 顧客と製品またはサービスプランとの間の継続的な合意であり、価格とキャンセル条件が含まれます。
- 定期支払い: その合意の下で回収される料金。
- 請求ロジック: どの料金をいつ回収するかを決定します。
- 支払い処理: 支払いプロバイダーを通じて、この指示を実行します。
DEUNA を通じての支払い処理の選択は、すべてのサブスクリプション管理責任を DEUNA に移転するものではありません。顧客のポリシー、税金、請求書、およびサービス提供は、個別に統合しない限り、あなたの責任です。
設定から後続の回収まで
このページに記載されている設定と回収フローは、定期的なカード決済に焦点を当てています。
- 同意: 貴社の情報を特定し、金額または計算、回収頻度、またはトリガー、およびキャンセル条件を説明する同意を得ます。
- カード設定: 顧客の認証が必要な場合、カードを捕捉し、トークン化します。設定には、即時支払いまたは、後で最初の請求を行うためのカードの保存が含まれます。
- 請求決定: 請求の所有者が、合意の下で各回収の金額と期日を決定します。
- 処理中: DEUNA が支払いを行います。
- 調整: 各結果を記録に照合します。
このライフサイクルは概念的なものです。選択したアプローチによって、どのシステムが後続の回収をスケジュールまたは送信するかが決まります。
支払いシナリオを特定#
| シナリオ | 顧客が同意する内容 | 請求開始のトリガー |
|---|---|---|
| 固定料金プラン | 月額 10 ドル | 請求日 |
| 変動料金 | 1 か月あたり 40 ドル、次月あたり 60 ドルの水道光熱費、これは事前に開示された利用状況と料金に基づいています。 | 合意されたスケジュールに基づいて請求が期日を迎える |
変動料金の場合、請求額を計算するシステムを特定し、選択したアプローチがこれらの請求ルールをサポートしていることを確認してください。 どちらのシナリオも、事前に合意し、サポートされている支払い設定が必要です。
DEUNAのソリューションを選択#
請求の決定権がある場所と、システムが請求指示をどのように提供するかに基づいて選択してください。
| アプローチ | 最適な選択 | 請求書発行者 | 請求が DEUNA にどのように伝達されるか |
|---|---|---|---|
| DEUNA サブスクリプションエンジン | DEUNA に、定期的な請求をスケジュールしてもらいたい | DEUNA エンジンは、設定された条件に基づいて | エンジンがスケジュールされた請求をトリガー |
| 商社サブスクリプションエンジン | すでに請求額を計算し、スケジュールしている | 現在ご利用のエンジン | システムが DEUNA の支払い API を呼び出す |
| 定期的なバッチアップロード | 既存のシステムで請求ファイルを作成 | 既存のシステム | 適切な DEUNA Vault トークンを使用してバッチを送信 |
DEUNA サブスクリプションエンジン
請求金額、通貨、頻度、自動更新、および再試行ルールを設定します。顧客と支払い方法をサブスクリプションに関連付け、エンジンが課金スケジュールと処理できるようにします。詳細は、 DEUNA サブスクリプションエンジンの仕組み および 管理画面からプランとサブスクリプションを管理 サポートされている設定（先払いを含む）
エンジンと、再帰型支払い分類は、必要な商社およびストアで有効になっている必要があります。プロセッサのサポート、トークンポータビリティ、ネットワークトランザクションのリンク、および認証要件は、後で使用される接続の有効性を制限する可能性があります。
商社サブスクリプションエンジン
既存の請求処理ロジックを維持し、以下の機能を使用してください。 DEUNA 決済 API 請求用 DEUNA は、MIT および PSD2 フローを含む、オンラインプロセッサによる承認、および支払い処理、および必要な初期 3DS のルーティング、およびサポートされているクロスプロバイダーの再試行を提供します。 支払い戦略を設定
DEUNAは、後続のMIT連携のために、ネットワーク取引識別子（NTID）も保存します。Vaultトークンは保存されたカードの認証情報を識別し、NTIDはネットワーク取引履歴を参照します。これらは顧客の同意を代替せず、サポートされている連携はプロバイダーとネットワークによって異なります。
定期的なバッチアップロード
サポートされている接続に対して。
統合前に、DEUNA と、形式、配信、トークンの適合性、プロセッサ、および支払いごとの結果の交換について合意してください。
DEUNA サブスクリプションエンジンの仕組み#
次の サブスクリプション API 顧客が提供するプランのサブスクリプションを管理します。サブスクリプションとプランの状態を制御し、請求、アクティブ化、キャンセル、および期限切れを正しく実行できるようにします。
サブスクリプションモジュール（管理画面）からプランとサブスクリプションを作成および管理することもできます。詳細は、 管理画面からプランとサブスクリプションを管理 ステップごとのガイドを参照してください。
データモデル
| Object | 説明 | 以下の内容を含む |
|---|---|---|
| プラン | 顧客に提供する製品またはサービス | 一意のコード、名前、説明、グループ名、金額、通貨、請求間隔、自動更新、オプションの先払い、ステータス |
| サブスクリプション | 顧客とプランの関係 | 一意の ID、ステータス、作成、アクティブ化、キャンセル、および期限切れの日付 |
| 課金サイクル | プランの課金期間 | サポートされている課金間隔のいずれか（下記参照） |
課金開始の遅延
プランは、サブスクリプション作成後、特定の月の日付またはサブスクリプション作成から一定日数後に最初の課金を定義できます。 1つの遅延課金モードのみをプランごとに設定できます。
- 即時課金は行われません
- 課金は、APIを介して追加の呼び出しなしに、プラン設定に基づいて自動的にスケジュールされます。
- Редактирование плана не поддерживается, и отложенный старт не может быть изменен после того, как план имеет активные подписки.
詳細は 遅延課金でプランを作成 を参照してください。
サポートされている課金間隔
| Value | 頻度 |
|---|---|
DAILY | 毎日 |
WEEKLY | 毎週 |
BIWEEKLY | 2週間ごと |
THIRTY_DAYS | 30日ごと |
SIXTY_DAYS | 60日ごと |
NINETY_DAYS | 90日ごと |
MONTHLY | 毎月 |
BIMESTRIAL | 2ヶ月ごと |
QUARTERLY | 3ヶ月ごと |
ANNUAL | 毎年 |
BIENNIAL | 2年間ごと |
TRIANNUAL | 1年に3回 |
BIANNUAL | 1年に2回 |
プランの状態
| 州 | 説明 |
|---|---|
active | プランはアクティブで、新しいサブスクリプションの作成に使用できます。 |
pending | プラン作成は試みられたが、内部システムのエラーにより完了しませんでした。 |
サブスクリプションの状態
| 州 | 説明 |
|---|---|
pending | サブスクリプションは作成されましたが、課金はまだ行われていません。 課金が成功または失敗するまで、この状態が維持されます。 |
active | 支払い完了し、サブスクリプションが検証されました。 |
canceled | 顧客または商社が、サブスクリプションの有効期限前に明示的にサブスクリプションをキャンセルしました。 |
expired | サブスクリプションは、有効期限または終了によって終了しました。 |
APIを使用してサブスクリプションを管理
サブスクリプションの作成
以下の サブスクリプションの作成 endpoint.
サブスクリプションのリスト表示
以下の サブスクリプションのリストを取得 すべての顧客のサブスクリプションを受信するエンドポイント
サブスクリプションまたは支払いカードの更新
顧客がカードを更新した場合、次の操作を実行できます。
- コール サブスクリプションを更新 サブスクリプションを更新するために。
- 未払い請求書の再試行。
安全なカードキャプチャを通じて、生のカードデータをシステムから分離します。
サブスクリプションのキャンセル
キャンセルはステータスを canceled以下の項目を指定できます：
- 現在の課金サイクル末のキャンセルに変更します。
- 更新サイクル末のキャンセル。 例えば、1年間の月額サブスクリプションは、その年が終了したときにキャンセルされます。
term_end: サイクル終了を指示し、返金を生成します。bill_date: 次のサイクル開始 (作成後24時間) を示し、払い戻しを生成します。term_end) を生成し、払い戻しを生成します。
対応する管理側の手順については、 管理画面でサブスクリプションをキャンセル.
自動再試行
サブスクリプションエンジンには、サブスクリプションの課金またはアクティブ化中に発生する可能性のある一時的な障害（支払いプロセッサとの通信の問題など）を処理するための再試行メカニズムが組み込まれています。 これにより、手動による介入なしに、支払いとアクティブ化が確実に完了します。
- 自動再試行サブスクリプションの課金または有効化に失敗した場合、システムは一定時間後に再試行します。
- 指数関数的バックオフ: 試行回数を増やすことで、システムへの負荷を軽減します。
- 試行回数制限: 試行回数が設定された最大数（例えば、6回）に達すると、システムはサブスクリプションを一時停止またはキャンセル（お客様の設定に基づいて）します。
- 通知: 試行が失敗した場合、システムは顧客または管理者に対してサブスクリプションの状態とエラーに関する通知を送信できます。
| 試行 | 待機時間 |
|---|---|
| 1 | — |
| 2 | 5分 |
| 3 | 60分 |
| 4 | 5時間 |
| 5 | 12時間 |
| 6 | 24時間 |
管理画面からプランとサブスクリプションを管理#
プランは、サブスクリプションの課金条件を定義します。これには、価格、頻度、更新の種類、およびオプションで、課金開始日の遅延が含まれます。プランと顧客のサブスクリプションの両方を、管理モジュールから管理します。 サブスクリプション Admin のモジュール
計画のフィールド
| 機能 | 説明 |
|---|---|
| プラン名 | 商用名称（プレミアムプラン） |
| プランの説明 | オプションのテキスト。プランに含まれる内容の詳細（「プレミアムコンテンツへの無制限アクセス」など） |
| グループ名 | 類似のプランを整理するための内部グループ（プレミアム、ベーシック、年間など）。 |
| プランコード | システム内で一意に識別されるプランのID（PLAN-001）。 |
| プラン金額 | 毎請求サイクルに課金される金額。 |
| 通貨 | プランの課金通貨を決定します。 |
| 頻度 | 請求頻度（毎週、毎月、毎年、2ヶ月ごとなど）。詳細は サポートされている課金間隔. |
| 自動更新 | 関連するサブスクリプションが期間満了時に自動的に更新されるかどうかを定義します。 |
| 課金開始の遅延 | 最初の課金が発生するタイミングを定義できます。 |
| Estado | 有効: 新しいサブスクリプションに割り当て可能 保留中: このプランは新規のサブスクリプションには適用できません。 |
遅延課金でプランを作成
- サイドバーメニューで、 サブスクリプション.
- サブスクリプションのページで、 プラン.
- クリック 「プラン作成」セクションを選択し、.
- プランの一般的なフィールド（名前、説明、金額、通貨、頻度、更新）を完了してください。
- 「 課金開始の遅延 「プラン作成」機能を使用し、 「請求開始日を設定」 toggle.
- 以下のいずれかの方法で、請求開始日を設定してください。
-
特定の月の日に：課金は発生します 同じ日に 毎月、契約開始時に関わらず。
例：10日を選択した場合、ユーザーが3日に契約した場合、最初の課金は10日に発生します。
-
プランの取得日からX日後：課金は発生します サブスクリプション作成から X日経過後。
例：7日を選択した場合、サブスクリプションの開始日は10月5日となり、サブスクリプションの有効期間は10月12日からとなります。
-
- 変更を保存するには、「プランを保存」ボタンをクリックしてください。 プランを保存.
このプランで作成されたすべてのサブスクリプションに、遅延開始が記録され適用されます。
サブスクリプションを一覧表示
アクセス サブスクリプション モジュール内のタブから。
| フィールド | 説明 |
|---|---|
| Subscription ID | サブスクリプションの一意な識別子。 |
| 顧客のメールアドレス | サブスクリプションに関連付けられたメールアドレス。 |
| プラン名 | ユーザーがサブスクライブしているアクティブなプラン |
| 1回あたりの金額 | サブスクリプションの定期課金される金額。 |
| Подписка: Начало | Дата начала подписки. |
| Дата последнего платежа | 最後の決済試行日。 |
| Estado | Текущий статус: Active, Cancelled, Expired, Pending. |
Вы можете фильтровать подписки по электронной почте клиента, 作成日、または названию плана.
Детали подписки
Нажмите на любую подписку в списке, чтобы получить доступ к ее подробному представлению.
| セクション | 説明 |
|---|---|
| 顧客データ | Основные сведения: имя, электронная почта, ID клиента. |
| Детали подписки | Текущий статус, ключевые даты, связанный план, сумма и частота выставления счетов. |
| 取引 | サブスクリプションに対する処理された料金の一覧。トランザクションID、日付、金額、プロセッサ、および支払いステータスを含みます。 |
管理画面でサブスクリプションをキャンセル
- 」に移動します。 サブスクリプション サイドバーメニューのセクション。
- 「 サブスクリプション В поле поиска введите электронную почту или ID клиента.
- Нажмите на значок действия
···を選択して、 Просмотр подписки. - 詳細ビューで、 アクション и выберите Cancel.
- モーダルが表示され、選択する キャンセルポリシー～
| キャンセルポリシー | 説明 |
|---|---|
| Немедленный отказ | Немедленно прекращает подписку. |
| Отказ в конце периода выставления счетов | Подписка остается активной до окончания текущего цикла. Автоматически прекращается в конце периода. |
| Отказ в определенную дату | Позволяет вручную указать дату отказа. До этой даты подписка остается активной. |
- Если вы выберете опцию "Определенная дата", выберите день на календаре.
- (Необязательно) Добавьте причину отказа для сохранения информации.
- クリック キャンセル確認 для выполнения действия.
Приостановка подписки
- В деталях подписки нажмите на アクション и выберите Приостановить.
- Появится модальное окно, в котором вы можете выбрать Политику приостановки～
| Политику приостановки | 説明 |
|---|---|
| Приостановить немедленно | Немедленно приостанавливает подписку. Дальнейшие сборы не генерируются до повторного включения. |
| Приостановить в конце периода выставления счетов | Подписка остается активной до конца текущего цикла, затем автоматически приостанавливается. |
| Приостановить в определенную дату | サブスクリプションを将来の日付に設定して一時停止します。 その日まで、サブスクリプションは有効な状態です。 |
- Если вы выберете опцию "Определенная дата", выберите день на календаре.
- (Необязательно) Введите причину приостановки если вы хотите сохранить контекст.
- クリック Подтвердить приостановку для применения действия.
Преимущества автоматизированных платежей#
Оптимизация времени повторных попыток на основе поведения
AI-управляемые повторные попытки DEUNA, основанные на исторических данных о поведении продавцов и клиентов, выбирают оптимальное время для попыток восстановления. В отличие от фиксированного расписания повторных попыток, это может быть время, когда состояние, требующее восстановления, изменилось. Например, последующая попытка может быть успешной после пополнения недостаточного баланса.
Цель состоит в том, чтобы восстановить выручку и снизить отказ от подписки из-за неудачных платежей. Утверждение не гарантируется. Убедитесь, что доступны функции восстановления и ограничения провайдера или сети для выбранного вами подхода.
Устойчивость за счет нескольких провайдеров
Маршрутизация через настроенных подходящих провайдеров снижает зависимость от одного соединения для обработки платежей. デフォルト処理 puede utilizar un segundo procesador en una cascada de respaldo. La elegibilidad depende del fallo, las reglas del proveedor y la idoneidad del token para la ruta alternativa. Cambiar de proveedores no restablece un saldo insuficiente.
Если попытка сбора не привела к успеху, сначала необходимо отличить неразрешенный результат от результата, который допускает восстановление:
Каждый путь восстановления зависит от соглашения, правил провайдера и поддерживаемой конфигурации:
- Используйте поддерживаемый поток клиента только в том случае, если это разрешено. Требуется аутентификация клиента, чтобы вернуть клиента в поддерживаемый поток; автоматические повторные попытки не могут заменить это.
- Провайдерный резерв требует настроенного подходящего провайдера.
- Поздняя повторная попытка должна быть допустимой и происходить в указанное время.
- 技術的な再試行は、元の決済に関する文書化されたルールに従います。
システムとDEUNAの間で所有権の回復を調整し、独立したプロセスが同じ請求を2回収集しないようにします。
システム内のより機密性の低いカードデータ
DEUNAのカードキャプチャと 支払いVault を使用して、認証情報をトークン化し、生のカードデータをシステムから分離します。これにより、PCI DSS（Payment Card Industry Data Security Standard）の下で適用される制御を軽減できます。アウトソーシングは、プロバイダーの監視とコンプライアンスの検証を含む、商人の責任を維持します。詳細は、 PCI SSCのアウトソーシングガイダンス.
導入の準備#
請求の所有者、同意フロー、サポートされているプロバイダー、トークンの適合性、および回復ポリシーを確認します。カードが無効になった場合は、安全なカードキャプチャを通じて顧客に交換するように依頼してください。
不確実な結果の場合、新しいコレクションを開始する前に、元の決済を調整します。詳細は、 冪等なリクエストに関するガイダンス 通信障害後の技術的な再試行に関するガイドライン ウェブフック （該当する場合）を使用して、記録を更新します。
キャンセル処理
キャンセルリクエストとその有効時間を区別します。即時、期間の終了、または構成されたポリシーで指定された日付。
- その時点以降、または課金権限が取り消された場合、または期限切れの場合に、新しい送信を停止します。
- 影響を受ける未送信のコレクションをスケジュールシステムから削除します。
- 送信された決済を調整します。キャンセルが決済プロセスを停止することはありません。適用されるポリシーに基づいて、キャンセルまたは払い戻しを確認してください。
展開前に検証
サポートされているサンドボックスケースを使用します。展開前に、利用できないケースについてDEUNAと調整します。
- 設定同意、適切なトークン、および必要な認証の完了を確認します。
- コレクション請求額が同意に一致し、各結果が記録と一致することを確認します。
- 回復有効な回復と認証が必要な結果を実行します。合意されたポリシーと顧客アクションフローを確認します。
- 不確実な結果別のコレクションの試行の前に、調整を確認します。
- キャンセル有効期限ポリシー、取り消された同意、影響を受けるキューのコレクションの削除、および送信された決済の調整を確認します。
次のステップ#
- DEUNA サブスクリプションエンジン設定を 管理画面 から構成し、 サブスクリプション API.
- 商社サブスクリプションエンジンを統合します。 DEUNA 決済 API および、必要に応じて設定 DEUNA は、MIT および PSD2 フローを含む、オンラインプロセッサによる承認、および支払い処理、および必要な初期 3DS のルーティング、およびサポートされているクロスプロバイダーの再試行を提供します。.
- 定期的なバッチアップロードDEUNAとのコレクションと結果の交換について合意してから統合を構築します。