메인 콘텐츠로 건너뛰기

​
구독 마이그레이션이란?

구독 마이그레이션은 기존 구독자를 레거시 결제 프로세서에서 Dodo Payments로 전송하여 모든 고객 데이터에 대한 단일 진실 출처를 제공합니다. 마이그레이션이 없으면 현재까지 확보한 고객은 레거시 시스템에 남아 있으며, 새로운 고객만 Dodo Payments에서 확인할 수 있습니다. 마이그레이션 프로세스는 고객에게 원활한 청구 경험을 보장합니다. 고객은 결제 세부 정보를 다시 입력할 필요가 없으며 구독에 대한 중단을 경험하지 않습니다.
현재 우리는 카드 토큰 마이그레이션만 지원합니다. Apple Pay, Google Pay 및 기타 지갑 결제 수단은 이러한 공급자가 부과한 토큰화 제한으로 인해 결제 프로세서 간에 이전할 수 없습니다.

​
마이그레이션 프로세스 개요

구독 마이그레이션 프로세스는 세 가지 주요 부분으로 구성됩니다:
  1. 결제 방법 전송 — 현재 프로세서에서 민감한 카드 데이터의 안전한 전송
  2. 구독자 데이터 전송 — 고객 세부 정보, 구독 계획 및 청구 일정의 내보내기
  3. 가져오기 및 검증 — Dodo Payments에서 결제 방법 및 구독자 데이터 통합
구독 마이그레이션을 시작하려면 지원팀에 문의하세요. 전담 솔루션 엔지니어가 전체 과정을 안내해 드립니다.

​
요구 사항

마이그레이션을 시작하기 전에 다음 요구 사항을 충족하는지 확인하세요:
DoDo Payments는 PCI DSS 레벨 1 준수 업체입니다. 준수 의무를 충족하기 위해, 우리는 다른 PCI DSS 레벨 1 준수 결제 프로세서로부터만 카드 데이터를 수신할 수 있습니다.현재 프로세서는 다음을 제공해야 합니다:
  • 현재 PCI 준수 인증서(AOC) 또는 Visa의 서비스 제공업체 글로벌 레지스트리 목록
  • 안전한 카드 데이터 내보내기를 지원한다는 확인
현재 프로세서와 공유할 수 있도록 준수 확인서(AOC)를 확인하세요.
도도 페이먼츠 통합을 완료하고 마이그레이션을 시작하기 전에 모든 신규 고객이 도도 페이먼츠 결제 페이지로 이동되도록 하세요. 이렇게 하면 전환 기간 동안 데이터 불일치를 방지할 수 있습니다.
현재 프로세서에 데이터 내보내기 요청 권한이 있는지 확인하세요. 일반적으로 다음이 필요합니다:
  • 계정 소유자 확인
  • 민감한 데이터 접근에 대한 서면 승인
  • 프로세서의 보안 검증 절차 완료

​
단계별 마이그레이션 가이드

1

Request payment method export from your current processor

현재 결제 프로세서의 지원팀과 연락하여 고객 카드 토큰 전체 내보내기를 공식 요청하세요.다음이 필요합니다:
  • 신원 및 권한 확인 제공
  • Dodo Payments의 PGP 공개 키를 사용하여 내보내기를 암호화해 달라고 요청 (아래 제공됨)
  • 암호화된 파일을 우리의 안전한 SFTP 서버로 직접 전송해 달라고 요청
보안 전송은 서버 간 SFTP를 통해 직접 이루어집니다. 솔루션 엔지니어가 현재 프로세서와 공유할 SFTP 자격 증명을 제공할 것입니다.
평균적으로 이 과정은 약 2주가 소요되며, 실제 기간은 현재 프로세서의 정책 및 응답 시간에 따라 달라집니다.
2

Prepare subscriber data export

결제 수단 이전이 진행되는 동안 이전 시스템에서 가입자 데이터를 내보내세요. 솔루션 엔지니어가 CSV 템플릿과 필수 필드를 안내해 드립니다.

​
필요한 구독자 데이터

필드설명
customer_id귀사의 내부 고객 식별자
email고객의 이메일 주소
name고객의 전체 이름
country두 글자 국가 코드 (ISO 3166-1 alpha-2)
currency세 글자 통화 코드 (ISO 4217)
payment_amount최소 통화 단위로 표현한 구독 금액
payment_interval청구 주기 (월별, 연간 등)
next_billing_date다음 예정 청구일 (ISO 8601)
card_token현재 프로세서의 고유 토큰
card_token 필드는 매우 중요합니다—가져오기 동안 가입자 기록을 결제 수단과 일치시키는 데 사용됩니다. 이 필드가 결제 수단 내보내기의 토큰과 정확히 일치하는지 확인하세요.

​
샘플 데이터 형식

{
  "customers": [
    {
      "customer_id": "cus_abc123",
      "email": "jane.doe@example.com",
      "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

Validation and testing

가져오기 날짜 이전에, 우리 팀은 다음을 수행할 것입니다:
  • 결제 방법 데이터의 파일 무결성과 암호화를 확인합니다.
  • 구독자 CSV의 올바른 형식을 검증합니다.
  • 샌드박스 환경에서 테스트 가져오기를 실행합니다.
  • 데이터 매핑 문제를 식별하고 해결합니다.
프로덕션 가져올 준비가 모두 완료되었음을 확인하는 검증 보고서를 받게 됩니다.
4

Production import

약정된 가져오기 날짜에 엔지니어 팀이 다음을 수행합니다:
  1. PCI 준수 카드 금고에 결제 방법 데이터를 가져옵니다.
  2. 구독자 데이터를 가져옵니다.
  3. 카드 토큰을 사용하여 구독자를 결제 방법과 일치시킵니다.
  4. 모든 마이그레이션된 구독을 활성화합니다.
표준 마이그레이션의 일반 처리 시간은 구독자 수에 따라 달라지며 2~3 영업일입니다.
5

Post-migration verification

가져오기가 완료되면 다음을 받게 됩니다:
  • 포괄적인 마이그레이션 보고서
  • 이전 구독 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로 구독을 마이그레이션할 준비가 되셨나요? 프로세스를 시작하려면 우리 팀에 문의하세요:

Contact Support

마이그레이션을 시작하고 솔루션 엔지니어와 연결하려면 문의하세요.

API Documentation

도도 페이먼츠에서 구독이 어떻게 작동하는지 이해하려면 API를 살펴보세요.