Di chuyển đăng ký sang Dodo Payments - Dodo Payments Documentation

Di chuyển đăng ký là gì?

Di chuyển đăng ký chuyển các người đăng ký hiện có của bạn từ nhà cung cấp thanh toán cũ sang Dodo Payments, cung cấp cho bạn một nguồn thông tin duy nhất cho tất cả dữ liệu khách hàng của bạn. Nếu không có di chuyển, các khách hàng bạn đã thu hút cho đến nay sẽ vẫn ở trong hệ thống cũ của bạn, và chỉ có các khách hàng mới sẽ được hiển thị trong Dodo Payments. Quá trình di chuyển đảm bảo trải nghiệm thanh toán liền mạch cho khách hàng của bạn—họ sẽ không cần phải nhập lại thông tin thanh toán của mình hoặc gặp bất kỳ gián đoạn nào trong các đăng ký của họ.

Hiện tại, chúng tôi chỉ hỗ trợ di chuyển cho token thẻ. Apple Pay, Google Pay và các phương thức thanh toán ví khác không thể chuyển giữa các bộ xử lý thanh toán do hạn chế mã hóa token do các nhà cung cấp này đặt ra.

Tổng quan về quy trình di chuyển

Quy trình di chuyển đăng ký bao gồm ba phần chính:

Chuyển phương thức thanh toán — Chuyển giao an toàn dữ liệu thẻ nhạy cảm từ nhà cung cấp hiện tại của bạn
Chuyển dữ liệu người đăng ký — Xuất thông tin khách hàng, kế hoạch đăng ký và lịch thanh toán
Nhập và xác thực — Hợp nhất các phương thức thanh toán và dữ liệu người đăng ký trong Dodo Payments

Để bắt đầu quá trình di chuyển đăng ký, hãy liên hệ với nhóm hỗ trợ của chúng tôi. Họ sẽ kết nối bạn với một Kỹ sư Giải pháp chuyên trách, người sẽ hướng dẫn bạn trong suốt quá trình.

Yêu cầu

Trước khi bắt đầu di chuyển, hãy đảm bảo bạn đáp ứng các yêu cầu sau:

PCI DSS compliance verification

Dodo Payments tuân thủ PCI DSS Cấp độ 1. Để đáp ứng các nghĩa vụ tuân thủ, chúng tôi chỉ có thể nhận dữ liệu thẻ từ một bộ xử lý thanh toán khác cũng tuân thủ PCI DSS Cấp độ 1.Nhà cung cấp hiện tại của bạn phải cung cấp:

Giấy chứng nhận tuân thủ PCI hiện tại (AOC), hoặc danh sách của họ trên Danh bạ Toàn cầu của Visa về các Nhà cung cấp Dịch vụ
Xác nhận rằng họ hỗ trợ xuất dữ liệu thẻ an toàn

Xem Chứng nhận Tuân thủ (AOC) để chia sẻ với bộ xử lý hiện tại của bạn.

Dodo Payments integration

Hoàn thành tích hợp Dodo Payments của bạn và đảm bảo tất cả khách hàng mới được điều hướng đến trang thanh toán Dodo Payments trước khi bắt đầu quá trình di chuyển. Điều này ngăn ngừa sự không nhất quán dữ liệu trong giai đoạn chuyển đổi.

Data access authorization

Đảm bảo bạn có quyền cần thiết để yêu cầu xuất dữ liệu từ bộ xử lý hiện tại. Điều này thường yêu cầu:

Xác minh chủ tài khoản
Ủy quyền bằng văn bản cho việc truy cập dữ liệu nhạy cảm
Hoàn tất các bước xác minh bảo mật của bộ xử lý của bạn

Hướng dẫn di chuyển từng bước

Request payment method export from your current processor

Liên hệ với đội hỗ trợ của bộ xử lý thanh toán hiện tại và gửi yêu cầu chính thức để xuất toàn bộ token thẻ của khách hàng.Bạn sẽ cần:

Cung cấp xác minh danh tính và ủy quyền của bạn
Yêu cầu họ mã hóa xuất khẩu bằng khóa công khai PGP của Dodo Payments (được cung cấp bên dưới)
Yêu cầu họ chuyển tệp đã mã hóa trực tiếp đến máy chủ SFTP an toàn của chúng tôi

Việc chuyển giao được bảo mật được thực hiện trực tiếp từ máy chủ này sang máy chủ khác thông qua SFTP. Kỹ sư Giải pháp của bạn sẽ cung cấp thông tin xác thực SFTP để chia sẻ với bộ xử lý hiện tại.

Trung bình, quá trình này mất khoảng 2 tuần, mặc dù thời gian có thể thay đổi tùy theo chính sách và thời gian phản hồi của bộ xử lý hiện tại.

Prepare subscriber data export

Trong khi quá trình chuyển phương thức thanh toán đang diễn ra, xuất dữ liệu người đăng ký từ hệ thống cũ của bạn. Kỹ sư Giải pháp sẽ cung cấp mẫu CSV và hướng dẫn bạn các trường cần thiết.

Dữ liệu người đăng ký cần thiết

Field	Description
`customer_id`	Bộ định danh khách hàng nội bộ của bạn
`email`	Địa chỉ email của khách hàng
`name`	Họ và tên đầy đủ của khách hàng
`country`	Mã quốc gia hai chữ cái (ISO 3166-1 alpha-2)
`currency`	Mã tiền tệ ba chữ cái (ISO 4217)
`payment_amount`	Số tiền đăng ký theo đơn vị tiền tệ nhỏ nhất
`payment_interval`	Tần suất thanh toán (hàng tháng, hàng năm, v.v.)
`next_billing_date`	Ngày thanh toán kế tiếp dự kiến (ISO 8601)
`card_token`	Token duy nhất từ bộ xử lý hiện tại của bạn

Trường card_token là then chốt—nó được dùng để đối chiếu các hồ sơ người đăng ký với phương thức thanh toán của họ trong quá trình nhập. Đảm bảo mục này khớp chính xác với token trong tệp xuất phương thức thanh toán.

Định dạng dữ liệu mẫu

{
  "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"
      }
    }
  ]
}

Validation and testing

Trước ngày nhập khẩu, đội ngũ của chúng tôi sẽ:

Xác minh tính toàn vẹn và mã hóa của dữ liệu phương thức thanh toán
Xác thực CSV người đăng ký của bạn để đảm bảo định dạng đúng
Thực hiện một lần nhập thử nghiệm trong môi trường sandbox của chúng tôi
Xác định và giải quyết bất kỳ vấn đề ánh xạ dữ liệu nào

Bạn sẽ nhận được báo cáo xác thực xác nhận mọi thứ đã sẵn sàng cho việc nhập khẩu sản xuất.

Production import

Vào ngày nhập khẩu đã thỏa thuận, đội ngũ kỹ sư của chúng tôi sẽ:

Nhập dữ liệu phương thức thanh toán vào Kho thẻ tuân thủ PCI của chúng tôi
Nhập dữ liệu người đăng ký của bạn
Khớp người đăng ký với các phương thức thanh toán của họ bằng cách sử dụng các mã thẻ
Kích hoạt tất cả các đăng ký đã di chuyển

Thời gian xử lý điển hình là 2-3 ngày làm việc cho các bản di chuyển tiêu chuẩn, tùy thuộc vào số lượng người đăng ký.

Post-migration verification

Sau khi hoàn thành nhập khẩu, bạn sẽ nhận được:

Một báo cáo di chuyển toàn diện
Một CSV ánh xạ các ID đăng ký cũ của bạn sang các ID Dodo Payments mới
Quyền truy cập vào tất cả khách hàng đã di chuyển trong bảng điều khiển Dodo Payments của bạn

Chúng tôi khuyến nghị:

Xác minh một mẫu các đăng ký đã di chuyển trong bảng điều khiển của bạn
Kiểm tra một số lần gia hạn đăng ký trong chế độ thử nghiệm (sandbox)
Cập nhật các tham chiếu trong cơ sở dữ liệu nội bộ bằng ID mới
Triển khai giám sát song song cho chu kỳ thanh toán đầu tiên

Dữ liệu có thể di chuyển

Các dữ liệu sau có thể được chuyển trong quá trình di chuyển đăng ký:

Loại dữ liệu	Hỗ trợ	Ghi chú
Số thẻ tín dụng/ghi nợ	✅	Được mã hóa qua PGP
Ngày hết hạn thẻ	✅
Tên chủ thẻ	✅
Địa chỉ thanh toán	✅
Địa chỉ email của khách hàng	✅
Siêu dữ liệu khách hàng	✅	Các cặp khóa-giá tùy chỉnh
Chi tiết đăng ký	✅	Kế hoạch, số tiền, khoảng thời gian
Mã Apple Pay	❌	Không thể chuyển giao
Mã Google Pay	❌	Không thể chuyển giao
Mã ví khác	❌	Không thể chuyển giao
Lịch sử thanh toán	❌	Xuất từ nhà cung cấp hiện tại của bạn

Lịch sử thanh toán và hồ sơ giao dịch không thể được di chuyển. Chúng tôi khuyên bạn nên xuất dữ liệu này từ bộ xử lý hiện tại để lưu trữ trước khi hoàn tất chuyển đổi.

Mã hóa PGP

Để đảm bảo an toàn tối đa khi chuyển giao dữ liệu thẻ nhạy cảm, tất cả các tệp phải được mã hóa bằng khóa công khai PGP của chúng tôi. Điều này cung cấp một lớp bảo vệ bổ sung ngoài mã hóa cấp vận chuyển. Chia sẻ khóa này với nhà cung cấp thanh toán hiện tại của bạn để mã hóa xuất khẩu dữ liệu thẻ:

Dodo Payments PGP Public Key

Kỳ vọng về thời gian

Giai đoạn	Thời gian
Thiết lập và lập kế hoạch ban đầu	1-2 ngày
Chuyển phương thức thanh toán	~2 tuần
Chuẩn bị dữ liệu người đăng ký	3-5 ngày (song song)
Xác thực và kiểm tra	2-3 ngày
Nhập sản xuất	2-3 ngày làm việc
Xác minh sau di chuyển	1-2 ngày

Tổng thời gian di chuyển thường mất 3-4 tuần từ đầu đến cuối. Bắt đầu chuẩn bị dữ liệu người đăng ký trong khi quá trình chuyển phương thức thanh toán đang diễn ra giúp giảm thiểu tổng thời gian.

Bắt đầu

Sẵn sàng di chuyển các đăng ký của bạn sang Dodo Payments? Liên hệ với đội ngũ của chúng tôi để bắt đầu quy trình:

Contact Support

Liên hệ để bắt đầu di chuyển và kết nối với Kỹ sư Giải pháp.

API Documentation

Khám phá API của chúng tôi để hiểu cách hoạt động của đăng ký trong Dodo Payments.

​Di chuyển đăng ký là gì?

​Tổng quan về quy trình di chuyển

​Yêu cầu

​Hướng dẫn di chuyển từng bước

​Dữ liệu người đăng ký cần thiết

​Định dạng dữ liệu mẫu

​Dữ liệu có thể di chuyển

​Mã hóa PGP

​Kỳ vọng về thời gian

​Bắt đầu

Contact Support

API Documentation

Di chuyển đăng ký là gì?

Tổng quan về quy trình di chuyển

Yêu cầu

Hướng dẫn di chuyển từng bước

Dữ liệu người đăng ký cần thiết

Định dạng dữ liệu mẫu

Dữ liệu có thể di chuyển

Mã hóa PGP

Kỳ vọng về thời gian

Bắt đầu