Skip to main content
Hướng dẫn này chuẩn bị tài khoản Stripe của bạn cho Bring Your Own Processor (BYOP): bạn yêu cầu Stripe cấp quyền truy cập raw card data API, sau đó lấy secret key và webhook signing secret mà Dodo Payments cần. Nếu cần trợ giúp, liên hệ với chúng tôi.

Bật quyền truy cập Raw Card Data

Để định tuyến các khoản thanh toán thông qua tài khoản Stripe của bạn, Dodo Payments thay mặt bạn gửi thông tin thẻ đến Stripe thông qua raw card data APIs của Stripe. Theo mặc định, tài khoản Stripe không thể gửi số thẻ thô (PAN) đến các API của mình. Stripe chỉ bật quyền truy cập này sau khi xác nhận rằng các hệ thống xử lý raw card data tuân thủ PCI DSS. Với BYOP, hệ thống xử lý card data là Dodo Payments, đơn vị tuân thủ PCI DSS Level 1, vì vậy bạn chứng minh việc tuân thủ bằng chứng nhận của Dodo Payments thay vì chứng nhận của riêng bạn. Bạn chỉ cần yêu cầu quyền truy cập này một lần cho mỗi tài khoản. Khi bạn yêu cầu quyền truy cập, Stripe yêu cầu mô tả ngắn về cách dữ liệu thẻ được xử lý. Nêu rõ rằng Dodo Payments, nhà cung cấp dịch vụ thanh toán tuân thủ PCI DSS Level 1 của bạn, xử lý dữ liệu thẻ thô và hệ thống của bạn không bao giờ lưu trữ hoặc tiếp xúc với số thẻ thô. Vì bạn hoàn toàn ủy thác việc xử lý thẻ cho Dodo Payments, bạn không cần SAQ D riêng nếu đủ điều kiện cho SAQ A. Gửi SAQ A của riêng bạn, liệt kê Dodo Payments là nhà cung cấp dịch vụ bên thứ ba trong Phần 2f, đồng thời đính kèm Dodo Payments Attestation of Compliance (AOC) làm bằng chứng hỗ trợ:

Dodo Payments PCI DSS Attestation of Compliance (AOC)

Tải xuống AOC hiện tại của Dodo Payments và gửi cho Stripe khi bạn yêu cầu quyền truy cập raw card data.
Test mode không yêu cầu tài liệu. Nếu bạn chỉ cần raw card data APIs để kiểm thử và không thể sử dụng các thẻ kiểm thử đã được Stripe tạo token trước, hãy yêu cầu bộ phận hỗ trợ Stripe bật các API này để bạn có thể xây dựng và kiểm tra thiết lập BYOP của mình. Live mode vẫn yêu cầu SAQ A và Dodo Payments AOC.
Để yêu cầu quyền truy cập, hãy làm theo hướng dẫn của Stripe và gửi Dodo Payments AOC khi Stripe yêu cầu tài liệu PCI:

Enabling access to raw card data APIs

Hướng dẫn của Stripe về cách yêu cầu quyền truy cập raw card data API trên tài khoản của bạn.

Bạn sẽ cần gì

Sau khi Stripe xác nhận quyền truy cập raw card data, hãy kết nối Stripe trong Settings → BYOP. Bạn cần hai giá trị từ Stripe Dashboard:
Stripe giữ riêng thông tin xác thực của sandbox (test) và live mode. Sử dụng Stripe sandbox cho test mode của Dodo Payments và Stripe live mode cho live mode của Dodo Payments.

Bước 1: Lấy Secret Key của bạn

1

Open API Keys

Trong Stripe Dashboard, mở trang API keys. Chuyển đổi giữa sandbox và live mode để khớp với mode Dodo Payments mà bạn đang cấu hình.
2

Copy Your Secret Key

Sao chép Secret key. Khóa này bắt đầu bằng sk_test_ trong sandbox và sk_live_ trong live mode. Sử dụng secret key tiêu chuẩn: restricted keys (rk_...) không được hỗ trợ. Trong live mode, Stripe chỉ hiển thị secret key mà bạn tạo một lần, vì vậy hãy sao chép khóa trước khi đóng hộp thoại.Dán khóa vào trường Secret Key trong Dodo Payments.

Bước 2: Thiết lập Webhook và Signing Secret

Khi bạn lưu kết nối Stripe, Dodo Payments sẽ tạo URL Webhook Endpoint. Thêm URL này vào Stripe dưới dạng webhook endpoint, sau đó sao chép signing secret của endpoint.
1

Create an Event Destination

Trong Stripe Dashboard, mở tab Webhooks trong Workbench và chọn Create an event destination. Chọn Your account, sau đó chọn tất cả sự kiện. Dodo Payments cần endpoint nhận mọi loại sự kiện.
2

Add the Endpoint URL

Chọn Webhook endpoint làm loại đích. Trong Endpoint URL, dán URL Webhook Endpoint mà Dodo Payments đã tạo. Stripe chỉ chấp nhận các URL HTTPS có thể truy cập công khai.
3

Reveal the Signing Secret

Trên trang cài đặt của endpoint, chọn Reveal secret để xem Signing secret. Secret này bắt đầu bằng whsec_. Mỗi endpoint có secret riêng, vì vậy endpoint sandbox và live có các secret khác nhau.
4

Paste the Signing Secret into Dodo

Trong Settings → BYOP, dán signing secret vào trường Webhook Signing Secret, sau đó chọn Save & continue để hoàn tất kết nối.

Set up BYOP

Làm theo toàn bộ quy trình thiết lập Bring Your Own Processor.
Cho đến khi bạn lưu signing secret, kết nối Stripe sẽ hiển thị là Incomplete trong Edit Configuration thuộc Settings → BYOP. Sau khi bạn lưu, kết nối sẽ hiển thị là Connected.

Câu hỏi thường gặp

Không, nếu bạn đủ điều kiện cho SAQ A. Dodo Payments xử lý dữ liệu thẻ thô thay mặt bạn và tuân thủ PCI DSS Level 1, vì vậy bạn gửi SAQ A của riêng mình, liệt kê Dodo Payments trong Phần 2f, cùng với Dodo Payments Attestation of Compliance (AOC), thay vì hoàn thành SAQ D hoặc một cuộc kiểm toán riêng.
Việc gửi số thẻ thô đến một API khiến hệ thống gửi nằm trong phạm vi PCI DSS. Stripe yêu cầu bằng chứng về việc tuân thủ PCI trước khi bật raw card data APIs, nhằm bảo đảm dữ liệu chủ thẻ luôn được bảo vệ. Dodo Payments tuân thủ PCI DSS Level 1, vì vậy bạn cung cấp Dodo Payments AOC làm bằng chứng đó.
Có. Yêu cầu Stripe bật raw card data APIs trong test mode, không cần tài liệu PCI, rồi kết nối Stripe trong test mode với Dodo Payments. Bạn cần được phê duyệt live mode trước khi xử lý các khoản thanh toán thực.
Để xem lại signing secret, hãy mở webhook endpoint trong Stripe và chọn Reveal secret. Để cập nhật secret trong Dodo Payments, mở Settings → BYOP, chọn Edit Configuration, chỉnh sửa kết nối Stripe, dán secret vào Webhook Signing Secret, rồi chọn Save & continue.Nếu bạn làm mất live secret key đã tạo, Stripe không thể hiển thị lại khóa đó, vì vậy hãy xoay vòng khóa hoặc tạo khóa mới trên trang API keys. Dodo dashboard không cho phép bạn thay đổi secret key đã lưu. Để thay thế secret key trên một kết nối hiện có, hãy liên hệ support@dodopayments.com.

Tài liệu tham khảo

Lần sửa đổi cuối 28 tháng 9, 2026