Skip to main content
Bring Your Own Processor (BYOP) kết nối tài khoản Stripe hoặc Adyen của riêng bạn với Dodo Payments. Các khoản thanh toán từ những quốc gia bạn chọn sẽ được xử lý trên tài khoản processor của bạn, trong khi Dodo Payments vận hành mọi thành phần xung quanh giao dịch: products, subscriptions, license keys và entitlement engine, invoicing, Customer Portal và analytics. Với mỗi quốc gia của khách hàng, bạn chọn bên xử lý thanh toán: processor của bạn, bên khiến bạn trở thành người bán hợp pháp cho tuyến đó, hoặc Dodo Payments với tư cách Merchant of Record cung cấp dịch vụ đầy đủ. Các khoản thanh toán từ những quốc gia không có tuyến sẽ được chuyển đến Dodo Payments.

Route by Geography

Gửi các khoản thanh toán từ những quốc gia cụ thể đến processor của bạn, và chuyển mọi khoản còn lại đến Dodo Payments.

Keep Your Processor Accounts

Tiếp tục sử dụng các tài khoản và mối quan hệ Stripe hoặc Adyen hiện có của bạn.

Stay the Merchant of Record

Trên các tuyến của riêng bạn, bạn vẫn là người bán hợp pháp và kiểm soát thuế, tranh chấp và payouts.

One Billing Layer

Dodo Payments vận hành products, subscriptions, invoices và analytics trên cả hai tuyến.

BYOP so với Dodo là Merchant of Record

Hai mô hình hoạt động song song. Mỗi khoản thanh toán tuân theo tuyến được thiết lập cho quốc gia của khách hàng. Để xem phần so sánh này trong dashboard, chọn Show Comparison bên dưới Settings → BYOP.
Một thiết lập phổ biến là hybrid: định tuyến một quốc gia nơi bạn đã có pháp nhân và processor đã đăng ký (ví dụ: thị trường nội địa) đến processor của riêng bạn, rồi để Dodo Payments xử lý phần còn lại của thế giới với tư cách Merchant of Record.

Các processor được hỗ trợ

Bạn có thể kết nối Stripe và Adyen.

Stripe

Adyen

Các khoản thanh toán được định tuyến qua processor của riêng bạn chỉ hỗ trợ credit và debit cards.
Cả Stripe và Adyen đều yêu cầu tài khoản của bạn có raw card API access, để Dodo Payments có thể chạy billing trên processor của bạn. Mỗi processor sẽ bật tính năng này theo yêu cầu, vì vậy hãy liên hệ với support của processor trước khi kết nối. Bước kết nối trong setup wizard cũng hiển thị yêu cầu này, cùng với liên kết View documentation đến các hướng dẫn Stripe và Adyen.

Thiết lập BYOP

Để bắt đầu setup wizard, mở Settings → BYOP trong dashboard và chọn Configure trên thẻ Bring Your Own Processor.
Connections được cấu hình theo từng environment. Processor bạn kết nối ở test mode (hiển thị là Sandbox) tách biệt với processor bạn kết nối ở live mode (hiển thị là Production). Để kiểm thử trước khi go live, hãy thiết lập cả hai. Setup wizard sử dụng mode được đặt bằng công tắc Live Mode trong sidebar.
Cài đặt BYOP hiển thị tùy chọn Merchant of Record và Mang Theo Bộ Xử Lý Của Bạn với so sánh tính năng
1

Choose a Payment Processor

Trong Select Payment Processor, chọn Stripe hoặc Adyen, sau đó chọn Continue.
Chọn hộp thoại Bộ Xử Lý Thanh Toán với tùy chọn Stripe và Adyen
2

Connect Your Account

Nhập thông tin connection, sau đó chọn Connect processor:
  • Processor Name: tên cho connection này, dài 2–75 ký tự. Tên giúp bạn nhận biết khi kết nối nhiều tài khoản từ cùng một processor, ví dụ Stripe US và Stripe UK.
  • Secret Key: API key của processor cho mode hiện tại. Với Stripe, đây là secret key sk_... của bạn.
  • Merchant Account (chỉ Adyen): mã định danh tài khoản merchant Adyen của bạn.
Bước Kết Nối Tài Khoản Stripe của bạn hiển thị tên bộ xử lý, khóa bí mật, điểm cuối webhook, và trường bí mật ký
Dodo Payments tạo connection và hiển thị URL Webhook Endpoint duy nhất cho connection đó. Thêm URL này làm đích webhook trong dashboard của processor. Sau đó dán Webhook Signing Secret vào Dodo Payments và chọn Save & continue:
  • Stripe: signing secret của webhook endpoint bạn đã thêm.
  • Adyen: HMAC key từ Customer Area → Webhooks.
Cho đến khi bạn lưu signing secret, connection sẽ hiển thị là Incomplete bên dưới Edit Configuration. Sau khi lưu, connection sẽ hiển thị là Connected.
Sau khi kết nối, secret key của bạn được lưu trữ an toàn và không thể xem hoặc thay đổi. Merchant account của Adyen cũng không thể thay đổi sau khi thiết lập. Trong processor, bạn chỉ cấu hình webhook URL do Dodo Payments tạo; bạn không bao giờ phải làm việc trực tiếp với infrastructure bên dưới.
3

Configure Payment Routing

Thêm routing rules để ánh xạ quốc gia của khách hàng đến một processor. Mỗi quốc gia được định tuyến đến đúng một processor:
  • Processor của bạn xử lý các khoản thanh toán từ những quốc gia bạn chỉ định cho processor đó.
  • Dodo Payments xử lý Rest of the World, tức mọi quốc gia bạn không định tuyến, với tư cách Merchant of Record.
Bước Cấu Hình Định Tuyến Thanh Toán hiển thị Stripe US định tuyến đến Hoa Kỳ và Dodo Payments là mặc định cho Phần còn lại của Thế giới
Để chỉ định một hoặc nhiều quốc gia cho processor, chọn Add Route, chọn processor rồi chọn các quốc gia. Không thể thêm một quốc gia đã được định tuyến đến processor khác.
Bảng Thêm Tuyến chọn một bộ xử lý và các quốc gia
Hướng dẫn định tuyến
  • Rest of the World bao gồm mọi quốc gia không có route.
  • Các route Merchant of Record của Dodo Payments tự động xử lý compliance và thuế.
  • Các route trên processor thanh toán của riêng bạn yêu cầu cấu hình thuế riêng nếu cần.
4

Configure Invoice Information

Đối với các khoản thanh toán được định tuyến qua processor của riêng bạn, bạn là người bán trên invoice. Nhập thông tin doanh nghiệp cho các invoice đó:
  • Registered Business Name (bắt buộc).
  • Tax ID (EIN, SSN, etc.) (không bắt buộc): 3–32 chữ cái, chữ số hoặc dấu gạch ngang. Có kiểm tra định dạng cho EIN của Hoa Kỳ.
  • Statement Descriptor (bắt buộc): nội dung khách hàng nhìn thấy trên sao kê ngân hàng. Sử dụng 5–22 chữ cái, chữ số, dấu cách, _ hoặc -.
  • Registered Business Address (bắt buộc): bắt đầu nhập để tìm kiếm địa chỉ hoặc nhập thủ công.
  • Privacy Policy Link và Terms of Service Link (bắt buộc).
Invoice Header Preview hiển thị cách các thông tin này xuất hiện. Các thông tin này chỉ áp dụng cho invoice của những route do processor của riêng bạn xử lý. Các khoản thanh toán được định tuyến đến Dodo Payments vẫn sử dụng thông tin Merchant of Record của Dodo Payments.
Bước Cấu Hình Thông Tin Hóa Đơn với chi tiết doanh nghiệp và xem trước tiêu đề hóa đơn trực tiếp
5

Review and Finish

Kiểm tra connection của processor, routing rules và thông tin invoice. Chọn I confirm that the routing and billing details are correct, sau đó chọn Finish setup.
Bước Xem Lại Cấu Hình của bạn tóm tắt bộ xử lý, định tuyến, và chi tiết hóa đơn
Sau khi thiết lập, thẻ Bring Your Own Processor hiển thị Edit Configuration, nơi bạn có thể thêm processor và chỉnh sửa routing cũng như thông tin invoice. Để chuyển lại toàn bộ thanh toán qua Dodo Payments với tư cách Merchant of Record, chọn Edit routing rules, mở từng route và tắt Enable processor. Các processor bị vô hiệu hóa sẽ được bỏ qua trong quá trình định tuyến thanh toán, và subscriptions trên processor bị vô hiệu hóa sẽ không thể renew.
Cài đặt BYOP sau khi cấu hình hiển thị tùy chọn Chỉnh sửa Cấu hình và định tuyến

Cách định tuyến hoạt động

Dodo Payments chọn route dựa trên billing country của khách hàng khi tạo payment. Quy tắc tương tự áp dụng cho one-time payments, checkout sessions và subscriptions mới. Renewals sử dụng lại processor nơi subscription được tạo (xem Subscriptions). Trên route do processor của bạn xử lý:
  • Payment được thực hiện trên tài khoản processor của bạn, theo billing currency.
  • Dodo Payments không tính hoặc thu thuế. Bạn chịu trách nhiệm về thuế trên route đó.
  • Invoice hiển thị business details và statement descriptor bạn đã cấu hình, không có thông tin Merchant of Record của Dodo Payments.
  • Processor thanh toán cho bạn trực tiếp. Số tiền payment không bao giờ đi vào số dư Dodo Payments của bạn; chỉ billing fee BYOP được ghi nhận ở đó.
Trên route do Dodo Payments xử lý (Rest of the World), Dodo Payments là Merchant of Record cung cấp dịch vụ đầy đủ cho bạn. Dodo Payments xử lý thuế, compliance, fraud screening và payouts được tổng hợp, đồng thời cung cấp các công cụ giúp bạn ngăn chặn và phản hồi tranh chấp. Bạn chịu chi phí tranh chấp đối với các khoản thanh toán này.

Đăng ký

Một subscription vẫn sử dụng processor nơi nó được tạo. Khi renew, Dodo Payments charge cùng processor đó bằng payment mandate được lưu khi khách hàng đăng ký và không đánh giá lại routing rules. Các cập nhật payment method cho subscription cũng đi qua cùng processor. Việc Dodo Payments có tính thuế cho subscription hay không cũng được cố định khi subscription được tạo.

Xem processor đã xử lý payment

Sau khi cấu hình BYOP, các bảng Payments và Disputes hiển thị biểu tượng processor (Stripe, Adyen hoặc Dodo Payments) trên mỗi hàng. Các trang chi tiết payment và dispute bổ sung trường Payment Processor, giúp bạn biết route nào đã xử lý giao dịch.

Refunds, Disputes & Payouts

Bắt đầu refunds từ dashboard Dodo như thường lệ. Đối với payment được định tuyến qua processor của riêng bạn, Dodo Payments gửi refund đến processor đó để processor hoàn tiền; refund không sử dụng số dư Dodo Payments của bạn. Đối với payment được định tuyến đến Dodo, Dodo Payments xử lý refund.

Analytics

Analytics về revenue, tax và subscription bao gồm cả hai route, vì vậy bạn có thể xem toàn bộ billing tại một nơi. Các widget disputes và payouts chỉ hiển thị hoạt động được Dodo xử lý. Hoạt động trên processor của riêng bạn cũng xuất hiện trong dashboard của processor đó.

Billing Fee

Dodo Payments tính BYOP billing fee trên mỗi payment được định tuyến qua processor của riêng bạn, vì Dodo Payments vẫn vận hành products, subscriptions, invoicing và analytics cho các payment đó. Mức mặc định là 0,5% giá trị tương đương bằng USD của payment và mức chính xác được xác nhận khi BYOP được bật cho tài khoản của bạn. Fee xuất hiện dưới dạng một mục byop_fee trong balance ledger của bạn. Để trao đổi về mức phí, liên hệ đội ngũ.

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

Stripe và Adyen. Cả hai đều yêu cầu tài khoản của bạn có raw card API access, được yêu cầu từ support của processor. Xem hướng dẫn Stripe và Adyen.
Có. Chỉ định các quốc gia cụ thể cho processor của bạn và để phần còn lại là Rest of the World, nơi Dodo Payments xử lý với tư cách Merchant of Record. Mỗi quốc gia được định tuyến đến đúng một processor.
Đúng vậy. Trên các route do processor của riêng bạn xử lý, bạn vẫn là người bán hợp pháp và chịu trách nhiệm về thuế, chargebacks, PCI compliance và payouts cho các giao dịch đó.
Không. Dodo Payments không tính hoặc thu thuế trên các route do processor của riêng bạn xử lý; bạn quản lý thuế cho các giao dịch đó. Dodo Payments tiếp tục xử lý thuế trên các khoản thanh toán được định tuyến đến Dodo Payments với tư cách Merchant of Record.
Renewals trên processor đó sẽ thất bại khi processor bị vô hiệu hóa, vì mỗi subscription renew trên processor nơi nó được tạo. Các renewals này xuất hiện dưới dạng failed payments trong dashboard.Dodo Payments cũng tạm dừng các email payment recovery cho những subscription đó. Bật lại processor để khôi phục renewals; các recovery attempts bị tạm dừng sau đó sẽ tiếp tục.

Bắt đầu

What is Merchant of Record?

Tìm hiểu cách mô hình Merchant of Record cung cấp dịch vụ đầy đủ của Dodo Payments hoạt động.
Lần sửa đổi cuối 26 tháng 9, 2026