Skip to main content
Ví điện tử cho phép khách hàng thanh toán bằng thẻ hoặc tài khoản đã được lưu trên thiết bị mà không cần nhập thông tin thẻ. Ví gửi token thay vì số thẻ, và khách hàng xác nhận thanh toán bằng cách chạm hoặc xác thực sinh trắc học.

Các ví được hỗ trợ

Dodo Payments chỉ hiển thị từng ví khi phiên thanh toán phù hợp với quốc gia, loại tiền tệ và loại thanh toán của ví đó:
PayPal hiện tạm thời không khả dụng cho các giao dịch mới.

Apple Pay

Apple Pay cho phép khách hàng thanh toán bằng thẻ được lưu trong Apple Wallet và xác nhận bằng Face ID hoặc Touch ID.
Apple Pay xuất hiện cho các gói đăng ký ngay cả khi khoản phí đầu tiên là $0, chẳng hạn như bản dùng thử miễn phí, để thiết lập ủy quyền thanh toán khi đăng ký. Đối với thanh toán một lần, Apple Pay chỉ xuất hiện khi số tiền lớn hơn $0.

Yêu cầu

  • Thiết bị: iOS 17 trở lên, iPadOS 17 trở lên hoặc Safari 17 trở lên trên macOS.
  • Giao thức: Trang phải được tải qua HTTPS.
  • Miền: Đối với inline checkout, miền phải được xác minh với Apple.

Xác minh miền

Chỉ bắt buộc xác minh miền đối với inline (embedded) checkout. Hosted checkout và payment links hiển thị Apple Pay mà không cần xác minh miền.
Apple Pay không khả dụng trong overlay checkout. Để cung cấp Apple Pay, hãy sử dụng inline checkout, hosted checkout hoặc payment link.
Để xác minh miền cho inline checkout, hãy thực hiện các bước sau trong dashboard:
1

Open Apple Pay Domains

Đi tới Settings → Payment Methods. Trên dòng Apple Pay, nhấp vào Manage domains.
Nút Manage domains trên dòng Apple Pay trong phần cài đặt Payment Methods

Open Apple Pay domains from the Apple Pay row

2

Download the Domain Association File

Trong bảng Apple Pay domains, nhấp vào Download file.
Bảng Apple Pay domains có nút Download file

Download the Apple Pay domain association file

3

Register Your Domain

Nhấp vào Register domain, nhập miền nơi bạn nhúng checkout (ví dụ: shop.example.com), rồi nhấp vào Continue.
Biểu mẫu đăng ký miền có nhập miền

Register the domain where you embed checkout

4

Host the File on Your Domain

Tải tệp lên máy chủ của bạn tại đường dẫn sau:
Cung cấp tệp qua HTTPS, không chuyển hướng, với Content-Type: application/octet-stream hoặc text/plain.
5

Verify the Domain

Nhấp vào Verify domain. Dodo Payments kiểm tra tệp được lưu trữ và gửi miền của bạn đến Apple.
Màn hình Verify your domain với đường dẫn máy chủ của tệp association và nút Verify domain

Verify the hosted association file

6

Confirm It's Active

Khi trạng thái hiển thị Active, Apple Pay đã hoạt động trên miền đó. Để bật hoặc tắt Apple Pay cho một miền, hãy sử dụng nút chuyển Enabled của miền đó.
Danh sách Apple Pay domains hiển thị các miền có trạng thái Active và nút chuyển Enabled

Verified domains show an Active status

7

Test the Integration

  1. Mở checkout trên thiết bị Apple.
  2. Xác nhận rằng nút Apple Pay xuất hiện.
  3. Hoàn tất một giao dịch thử nghiệm.

Cấu hình

Để giới hạn một phiên checkout chỉ sử dụng Apple Pay và thẻ, hãy truyền allowed_payment_method_types:

Google Pay

Google Pay cho phép khách hàng thanh toán bằng thẻ được lưu trong tài khoản Google của họ.

Yêu cầu

  • Trình duyệt: Chrome trên máy tính và Android, và Firefox trên máy tính. Checkout không hiển thị Google Pay trong Safari hoặc bất kỳ trình duyệt nào trên iOS. Trên các trình duyệt đó, khách hàng có thể thanh toán bằng Apple Pay hoặc thẻ.
  • Thiết bị: Thiết bị Android có ứng dụng Google Pay.
  • Cài đặt: Trong Chrome, Allow sites to check if you have payment methods saved phải được bật.

Cấu hình

Để giới hạn một phiên checkout chỉ sử dụng Google Pay và thẻ, hãy truyền allowed_payment_method_types:
Google Pay không cần xác minh miền.

Amazon Pay

Amazon Pay cho phép khách hàng thanh toán bằng các phương thức thanh toán được lưu trong tài khoản Amazon của họ.

Khả năng cung cấp

  • Khu vực: Toàn cầu, trừ Ấn Độ.
  • Loại tiền tệ: USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. Các loại tiền tệ mà checkout cung cấp phụ thuộc vào processor phục vụ checkout đó.
  • Gói đăng ký: Không được hỗ trợ.

Cấu hình

Để giới hạn một phiên checkout chỉ sử dụng Amazon Pay và thẻ, hãy truyền allowed_payment_method_types:

Cash App Pay

Cash App Pay cho phép khách hàng tại Hoa Kỳ thanh toán từ tài khoản Cash App của họ.

Khả năng cung cấp

  • Khu vực: Chỉ Hoa Kỳ. Quốc gia thanh toán phải là Hoa Kỳ.
  • Loại tiền tệ: Chỉ USD.
  • Gói đăng ký: Được hỗ trợ.

Cấu hình

Để giới hạn một phiên checkout chỉ sử dụng Cash App Pay và thẻ, hãy truyền allowed_payment_method_types:

RevolutPay

RevolutPay cho phép người dùng Revolut thanh toán từ số dư tài khoản Revolut hoặc thẻ được liên kết.

Khả năng cung cấp

  • Khu vực: Toàn cầu.
  • Loại tiền tệ: Chỉ GBP.
  • Gói đăng ký: Không được hỗ trợ.

Cấu hình

Để giới hạn một phiên checkout chỉ sử dụng RevolutPay và thẻ, hãy truyền allowed_payment_method_types:

Kiểm thử

Trong test mode, thanh toán bằng ví sử dụng cùng quy trình checkout nhưng không phát sinh giao dịch tiền thật.

Kiểm thử Apple Pay

1

Use Test Mode

Tắt nút chuyển Live Mode trong thanh bên của dashboard và sử dụng API keys được tạo trong test mode.
2

Add a Card to Apple Wallet

Thêm một thẻ thật vào Apple Wallet. Trong test mode, thẻ sẽ không bị tính phí.
3

Complete a Test Purchase

Mở checkout trên thiết bị Apple và hoàn tất quy trình Apple Pay.
Apple Pay yêu cầu HTTPS. Apple Pay sẽ không xuất hiện trên localhost trừ khi trang được cung cấp qua HTTPS.

Kiểm thử Google Pay

1

Join the Test Card Group

Tham gia nhóm thẻ kiểm thử Google Pay để thêm thẻ kiểm thử vào ví của bạn.
2

Enable Test Mode

Sử dụng API keys được tạo trong test mode.
3

Complete a Test Purchase

Chọn một trong các thẻ kiểm thử trong Google Pay để hoàn tất giao dịch.

Amazon Pay & Cash App Pay

Sử dụng API keys trong test mode và làm theo quy trình checkout tiêu chuẩn. Các giao dịch thử nghiệm được mô phỏng và không phát sinh khoản phí thật.

Hỗ trợ SDK

Khả năng cung cấp ví phụ thuộc vào cách bạn hiển thị checkout.

Web SDKs

Ví điện tử hoạt động trong:
  • Overlay Checkout, ngoại trừ Apple Pay.
  • Inline Checkout. Apple Pay yêu cầu xác minh miền.
  • Tích hợp Direct API với hosted checkout.

Mobile SDKs (Checkout)

Các SDK checkout Android, iOS, React Native và Flutter mở hosted checkout của Dodo Payments trong trình duyệt hệ thống của nền tảng (SFSafariViewController trên iOS, Chrome Custom Tabs trên Android), không phải trong WebView. Apple Pay và Google Pay hoạt động ở đó giống như trên web. Xem Mobile Integration Guide để biết cách thiết lập.

Thực tiễn tốt nhất

Khách hàng trên thiết bị di động mong đợi Apple Pay và Google Pay. Hãy hiển thị nổi bật các tùy chọn này trên checkout di động.
Nếu sử dụng inline checkout, hãy xác minh miền cho Apple Pay trong quá trình phát triển, không phải vào ngày ra mắt.
Không phải khách hàng nào cũng có ví điện tử. Hãy bao gồm credit và debit trong allowed_payment_method_types.
Trình mô phỏng không tái hiện đầy đủ hoạt động của ví. Hãy kiểm thử trên thiết bị iOS và Android thật trước khi ra mắt.
Ví sẽ không xuất hiện trên thiết bị không được hỗ trợ hoặc khi khách hàng không có thẻ đã lưu. Hãy giữ các phương thức thanh toán khác hiển thị cho những khách hàng này.

Khắc phục sự cố

Kiểm tra:
  1. Đối với inline checkout, miền đã được xác minh trong Manage domains chưa?
  2. Trang có được tải qua HTTPS không?
  3. Thiết bị có đang chạy iOS 17, iPadOS 17 hoặc Safari 17 trở lên không?
  4. Khách hàng có thẻ trong Apple Wallet không?
  5. apple_pay có được đưa vào allowed_payment_method_types không?
  6. Checkout có phải là overlay không? Apple Pay không khả dụng trong overlay checkout.
Giải pháp: Hoàn tất xác minh miền và cung cấp trang qua HTTPS. Kiểm thử trên thiết bị Apple thật.
Sau khi bạn nhấp vào Verify domain, Dodo Payments tải tệp association từ miền của bạn và gửi miền đến Apple. Miền vẫn ở trạng thái Pending thường do Dodo Payments không thể tải tệp như mong đợi.Kiểm tra:
  1. Tệp có thể truy cập tại https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
  2. Tệp được cung cấp qua HTTPS với chứng chỉ hợp lệ.
  3. Tệp được phân giải mà không chuyển hướng. Chuyển hướng đến www, máy chủ khác hoặc trang lỗi sẽ khiến kiểm tra thất bại.
  4. Tệp được cung cấp dưới dạng Content-Type: application/octet-stream hoặc text/plain, không phải text/html.
  5. Đây là tệp được tải xuống từ Manage domains cho business này, không phải tệp được dùng lại từ tài khoản hoặc nhà cung cấp khác.
Để xác nhận tệp có thể truy cập công khai, hãy yêu cầu URL từ bên ngoài mạng của bạn, chẳng hạn như trong cửa sổ duyệt web riêng tư. Mật khẩu staging, lớp xác thực và quy tắc firewall thường cho phép yêu cầu thành công với bạn nhưng thất bại với Dodo Payments.Giải pháp: Khắc phục vấn đề lưu trữ, sau đó nhấp lại vào Verify domain. Nếu miền không chuyển sang Active sau khi kiểm tra thành công, hãy liên hệ support@dodopayments.com cùng với tên miền.
Kiểm tra:
  1. Khách hàng có đang sử dụng trình duyệt được hỗ trợ không? Google Pay không xuất hiện trong Safari hoặc bất kỳ trình duyệt nào trên iOS.
  2. Khách hàng có thẻ trong Google Pay không?
  3. Cài đặt Chrome Allow sites to check if you have payment methods saved có được bật không?
  4. google_pay có được bao gồm trong allowed_payment_method_types không?
Giải pháp: Kiểm tra trình duyệt và thiết lập Google Pay của khách hàng.
Nguyên nhân thường gặp:
  • Thẻ trong ví đã hết hạn hoặc không hợp lệ.
  • Ngân hàng từ chối giao dịch.
  • Sự cố kết nối mạng làm gián đoạn thanh toán.
Giải pháp: Yêu cầu khách hàng kiểm tra thẻ trong ví hoặc sử dụng phương thức thanh toán khác.
Ví điện tử chỉ xuất hiện trên các thiết bị tương thích:
  • Apple Pay: Chỉ thiết bị Apple.
  • Google Pay: Thiết bị Chrome hoặc Android.
Giải pháp: Đây là hành vi bình thường. Hãy giữ tùy chọn thanh toán bằng thẻ làm phương án dự phòng.

Trang liên quan

Payment Methods Overview

Tất cả phương thức thanh toán được hỗ trợ.

Overlay Checkout

Mở checkout dưới dạng overlay trên trang của bạn.

Testing Process

Dữ liệu kiểm thử cho mọi phương thức thanh toán.

Mobile Integration Guide

Mở hosted checkout trong trình duyệt hệ thống, nơi Apple Pay và Google Pay hoạt động như trên web.
Lần sửa đổi cuối 26 tháng 9, 2026