> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Tìm hiểu cách di chuyển các người đăng ký và phương thức thanh toán hiện có của bạn từ nhà cung cấp thanh toán hiện tại sang Dodo Payments.

## 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ọ.

<Warning>
  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.
</Warning>

## 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:

1. **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
2. **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
3. **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

<Note>
  Để 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](mailto:support@dodopayments.com). 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.
</Note>

## 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:

<AccordionGroup>
  <Accordion title="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)](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf) để chia sẻ với bộ xử lý hiện tại của bạn.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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
  </Accordion>
</AccordionGroup>

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

<Steps>
  <Step title="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

    <Info>
      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.
    </Info>

    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.
  </Step>

  <Step title="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      |

    <Warning>
      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.
    </Warning>

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

    ```json theme={null}
    {
      "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"
          }
        }
      ]
    }
    ```
  </Step>

  <Step title="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

    <Check>
      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.
    </Check>
  </Step>

  <Step title="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ẽ:

    1. 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
    2. Nhập dữ liệu người đăng ký của bạn
    3. 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ẻ
    4. Kích hoạt tất cả các đăng ký đã di chuyển

    <Info>
      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ý.
    </Info>
  </Step>

  <Step title="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
  </Step>
</Steps>

## 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 |

<Note>
  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.
</Note>

## 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ẻ:

<Accordion title="Dodo Payments PGP Public Key">
  ```
  -----BEGIN PGP PUBLIC KEY BLOCK-----

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

  ```
</Accordion>

## 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             |

<Tip>
  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.
</Tip>

## 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:

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="mailto:support@dodopayments.com">
    Liên hệ để bắt đầu di chuyển và kết nối với Kỹ sư Giải pháp.
  </Card>

  <Card title="API Documentation" icon="code" href="/api-reference/introduction">
    Khám phá API của chúng tôi để hiểu cách hoạt động của đăng ký trong Dodo Payments.
  </Card>
</CardGroup>
