メインコンテンツへスキップ

​
サブスクリプション移行とは？

サブスクリプション移行は、既存のサブスクライバーをレガシー決済プロセッサからDodo Paymentsに移行し、すべての顧客データの単一の真実のソースを提供します。移行を行わない場合、これまでに獲得した顧客はレガシーシステムに残り、新しい顧客のみがDodo Paymentsで表示されます。 移行プロセスは、顧客にシームレスな請求体験を保証します。顧客は支払い情報を再入力する必要がなく、サブスクリプションに中断が生じることもありません。
現在、カードトークンの移行のみをサポートしています。Apple Pay、Google Pay、その他のウォレット決済方法は、これらのプロバイダーによって課せられたトークン化の制限により、決済プロセッサ間で移行できません。

​
移行プロセスの概要

サブスクリプション移行プロセスは、以下の3つの主要な部分で構成されています：
  1. 支払い方法の移行 — 現在のプロセッサからの機密カードデータの安全な移行
  2. サブスクライバーデータの移行 — 顧客の詳細、サブスクリプションプラン、請求スケジュールのエクスポート
  3. インポートと検証 — Dodo Paymentsでの支払い方法とサブスクライバーデータの統合
サブスクリプション移行を開始するには、サポートチームに連絡してください。専任のソリューションエンジニアがプロセス全体を案内します。

​
要件

移行を開始する前に、以下の要件を満たしていることを確認してください：
Dodo PaymentsはPCI DSSレベル1に準拠しています。準拠義務を満たすために、他のPCI DSSレベル1準拠の決済プロセッサからのみカードデータを受け取ることができます。現在のプロセッサは以下を提供する必要があります：
  • 現在のPCI準拠証明書（AOC）またはVisaのサービスプロバイダーのグローバルレジストリへのリスト
  • 安全なカードデータエクスポートをサポートしていることの確認
現在のプロセッサと共有するために、準拠証明書（AOC）をご覧ください。
Dodo Paymentsの統合を完了し、すべての新しい顧客がDodo Paymentsのチェックアウトに誘導されることを確認してください。これにより、移行期間中のデータの不整合を防ぎます。
現在のプロセッサからデータエクスポートをリクエストするために必要な承認を持っていることを確認してください。これには通常、以下が必要です：
  • アカウント所有者の確認
  • 機密データアクセスのための書面による承認
  • プロセッサのセキュリティ検証手順の完了

​
ステップバイステップの移行ガイド

1

現在のプロセッサからの支払い方法エクスポートのリクエスト

現在の決済プロセッサのサポートチームに連絡し、顧客カードトークンの完全なエクスポートを正式にリクエストしてください。必要なこと：
  • 身元と承認の確認を提供する
  • Dodo PaymentsのPGP公開鍵を使用してエクスポートを暗号化するように依頼する（以下に提供）
  • 暗号化されたファイルを直接当社の安全なSFTPサーバーに転送するように依頼する
安全な転送は、サーバーからサーバーへSFTPを介して直接行われます。ソリューションエンジニアが現在のプロセッサと共有するためのSFTP資格情報を提供します。
平均して、このプロセスには約2週間かかりますが、タイミングは現在のプロセッサのポリシーや応答時間によって異なります。
2

サブスクライバーデータエクスポートの準備

支払い方法の移行が進行中の間に、レガシーシステムからサブスクライバーデータをエクスポートしてください。ソリューションエンジニアがCSVテンプレートを提供し、必要なフィールドを案内します。

​
必要なサブスクライバーデータ

フィールド説明
customer_idあなたの内部顧客識別子
email顧客のメールアドレス
name顧客のフルネーム
country2文字の国コード（ISO 3166-1 alpha-2）
currency3文字の通貨コード（ISO 4217）
payment_amount最小通貨単位でのサブスクリプション金額
payment_interval請求頻度（月次、年次など）
next_billing_date次回の請求予定日（ISO 8601）
card_token現在のプロセッサからのユニークトークン
card_token フィールドは重要です—インポート中にサブスクライバーのレコードとその支払い方法を一致させるために使用されます。これが支払い方法エクスポートのトークンと正確に一致することを確認してください。

​
サンプルデータ形式

{
  "customers": [
    {
      "customer_id": "cus_abc123",
      "email": "[email protected]",
      "name": "Jane Doe",
      "country": "US",
      "currency": "USD",
      "payment_amount": 2999,
      "payment_interval": "monthly",
      "next_billing_date": "2025-01-15T00:00:00Z",
      "card_token": "tok_xyz789",
      "metadata": {
        "plan": "pro",
        "signup_source": "website"
      }
    }
  ]
}
3

検証とテスト

インポート日までに、当社のチームは：
  • 支払い方法データのファイルの整合性と暗号化を確認する
  • 正しいフォーマットのためにサブスクライバーCSVを検証する
  • サンドボックス環境でテストインポートを実行する
  • データマッピングの問題を特定し解決する
すべてが本番インポートの準備が整ったことを確認する検証レポートを受け取ります。
4

本番インポート

合意されたインポート日に、当社のエンジニアリングチームは：
  1. PCI準拠のカードボールトに支払い方法データをインポートする
  2. サブスクライバーデータをインポートする
  3. カードトークンを使用してサブスクライバーをその支払い方法に一致させる
  4. すべての移行されたサブスクリプションをアクティブ化する
標準的な移行の場合、典型的な処理時間は2-3営業日です。サブスクライバーの数によって異なります。
5

移行後の検証

インポートが完了した後、以下を受け取ります：
  • 包括的な移行レポート
  • 古いサブスクリプションIDを新しいDodo Payments IDにマッピングしたCSV
  • Dodo Paymentsダッシュボードでのすべての移行された顧客へのアクセス
以下をお勧めします：
  • ダッシュボードで移行されたサブスクリプションのサンプルを検証する
  • サンドボックスモードでいくつかのサブスクリプション更新をテストする
  • 新しいIDで内部データベースの参照を更新する
  • 最初の請求サイクルのために並行モニタリングを実行する

​
移行可能なデータ

サブスクリプション移行中に転送できるデータは以下の通りです：
データタイプサポートメモ
クレジット/デビットカード番号✅PGPで暗号化
カードの有効期限✅
カード名義人の名前✅
請求先住所✅
顧客のメールアドレス✅
顧客メタデータ✅カスタムキー-バリューペア
サブスクリプションの詳細✅プラン、金額、間隔
Apple Payトークン❌移行できません
Google Payトークン❌移行できません
その他のウォレットトークン❌移行できません
支払い履歴❌現在のプロセッサからエクスポート
支払い履歴と取引記録は移行できません。このデータを現在のプロセッサからエクスポートして記録として保持することをお勧めします。

​
PGP暗号化

機密カードデータを転送する際の最大のセキュリティのために、すべてのファイルは必ず当社のPGP公開鍵を使用して暗号化する必要があります。これにより、輸送レベルの暗号化を超えた追加の保護層が提供されます。 この鍵を現在の決済プロセッサと共有して、カードデータエクスポートを暗号化してください： 
-----BEGIN PGP PUBLIC KEY BLOCK-----

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
1OSDhXaPYtJnVApUzaCrC5PJCXU=
=nHcw
-----END PGP PUBLIC KEY BLOCK-----

​
タイムラインの期待

フェーズ期間
初期設定と計画1-2日
支払い方法の移行~2週間
サブスクライバーデータの準備3-5日（並行）
検証とテスト2-3日
本番インポート2-3営業日
移行後の検証1-2日
全体の移行には通常3-4週間かかります。支払い方法の移行が進行中の間にサブスクライバーデータの準備を開始することで、全体のタイムラインを短縮できます。

​
始めましょう

Dodo Paymentsにサブスクリプションを移行する準備はできましたか？プロセスを開始するために、当社のチームに連絡してください：

サポートに連絡

移行を開始し、ソリューションエンジニアとつながるためにお問い合わせください。

APIドキュメント

Dodo Paymentsでのサブスクリプションの仕組みを理解するために、APIを探索してください。