Ví điện tử

Chấp nhận Apple Pay, Google Pay, Amazon Pay, Cash App Pay và RevolutPay khi thanh toán. Bao gồm thông tin về khả năng cung cấp, xác minh miền Apple Pay và kiểm thử.

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í đó:

Ví điện tử	Khả dụng	Tiền tệ	Gói đăng ký	Yêu cầu thiết lập
Apple Pay	Toàn cầu, bao gồm Ấn Độ	Tất cả, bao gồm INR	Có	Xác minh domain cho inline checkout
Google Pay	Toàn cầu (trừ Ấn Độ)	Tất cả	Có	Không có
Amazon Pay	Toàn cầu (trừ Ấn Độ)	USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR	Không	Không có
Cash App Pay	Chỉ tại Hoa Kỳ	USD	Có	Không có
RevolutPay	Toàn cầu	GBP	Không	Không có

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. Tại Ấn Độ, Apple yêu cầu iPhone XR trở lên chạy iOS 18 trở lên.
• Giao thức: Trang phải được tải qua HTTPS.
• Domain: Đối với inline checkout, domain phải được xác minh với Apple.

​

Apple Pay tại Ấn Độ

Khách hàng tại Ấn Độ có thể thanh toán bằng Apple Pay trên các checkout được lập hóa đơn bằng INR.

Apple Pay tại Ấn Độ hoạt động trong các điều kiện sau:

• Tiền tệ: Checkout được lập hóa đơn bằng INR. Khoản thanh toán bằng INR phải đáp ứng mức tối thiểu của INR.
• Thẻ: Khách hàng có thẻ trong Apple Wallet từ một ngân hàng Ấn Độ hỗ trợ Apple Pay. Apple kiểm soát những ngân hàng và thẻ nào đủ điều kiện.
• Máy tính: Trong trình duyệt trên máy tính, khách hàng có thể quét mã bằng iPhone và xác nhận khoản thanh toán trên điện thoại.
• Gói đăng ký: Gói đăng ký Apple Pay bằng INR hoạt động theo ủy nhiệm của RBI. Mỗi khoản phí gia hạn được hoàn tất khoảng 48 giờ sau ngày gia hạn, tương tự các thẻ khác được phát hành tại Ấn Độ.

Để lập hóa đơn cho khách hàng tại Ấn Độ bằng INR, hãy tuân thủ các yêu cầu về quốc gia lập hóa đơn và Adaptive Currency trong Payment Methods tại Ấn Độ.

​

Xác minh domain

Xác minh domain chỉ bắt buộc đối với inline checkout (nhúng). Hosted checkout và payment links hiển thị Apple Pay mà không cần xác minh.

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 domain cho inline checkout, hãy thực hiện các bước sau trong dashboard:

1. Open Apple Pay Domains

   Đi đến Settings → Payment Methods. Trên hàng Apple Pay, hãy nhấp vào Manage domains.

   

   Open Apple Pay domains from the Apple Pay row

2. Download the Domain Association File

   Trong bảng Apple Pay domains, hãy nhấp vào Download file.

   

   Download the Apple Pay domain association file

3. Register Your Domain

   Nhấp vào Register domain, nhập domain nơi bạn nhúng checkout (ví dụ: shop.example.com), rồi nhấp vào Continue.

   

   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:

   https://shop.example.com/.well-known/apple-developer-merchantid-domain-association
   

   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 domain của bạn đến Apple.

   

   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 domain đó. Để bật hoặc tắt Apple Pay cho một domain, hãy sử dụng nút chuyển Enabled của domain đó.

   

   Verified domains show an Active status

7. Test the Integration

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

​

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:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['apple_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

​

Google Pay

Google Pay cho phép khách hàng thanh toán bằng các thẻ đã 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, tùy chọn 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:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['google_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Google Pay không yêu cầu xác minh domain.

​

Amazon Pay

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

​

Tính khả dụng

• Khu vực: Toàn cầu, trừ Ấn Độ.
• 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:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['amazon_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

​

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

​

Tính khả dụng

• Khu vực: Chỉ tại Hoa Kỳ. Quốc gia lập hóa đơn phải là Hoa Kỳ.
• 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:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['cashapp', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

​

RevolutPay

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

​

Tính khả dụng

• Khu vực: Toàn cầu.
• 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:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['revolut_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

​

Kiểm thử

Trong test mode, các khoản thanh toán bằng ví điện tử sử dụng cùng quy trình checkout mà 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 các API key đượ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 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 các API key đượ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 và Cash App Pay

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

​

Hỗ trợ SDK

Tính khả dụng của ví điện tử phụ thuộc vào cách bạn hiển thị checkout.

​

SDK cho Web

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 domain.
• Tích hợp API trực tiếp với hosted checkout.

​

SDK cho Mobile (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 Hướng dẫn tích hợp Mobile để thiết lập.

​

Phương pháp hay nhất

Prioritize wallets on mobile

Khách hàng mobile thườ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 mobile.

Complete domain verification early

Nếu sử dụng inline checkout, hãy xác minh domain cho Apple Pay trong quá trình phát triển, không phải vào ngày ra mắt.

Always include card fallbacks

Không phải mọi khách hàng đều có ví điện tử. Hãy bao gồm credit và debit trong allowed_payment_method_types.

Test on real devices

Trình mô phỏng không tái hiện đầy đủ hành vi của ví điện tử. Hãy kiểm thử trên các thiết bị iOS và Android thật trước khi ra mắt.

Handle wallet unavailability

Ví điện tử 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ố

Apple Pay button not appearing

Kiểm tra:

1. Đối với inline checkout, domain đã được xác minh trong Manage domains chưa?
2. Trang có được tải qua HTTPS không?
3. Thiết bị có 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 bao gồm trong 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 domain và cung cấp trang qua HTTPS. Kiểm thử trên một thiết bị Apple thật.

Apple Pay domain stuck on Pending

Sau khi bạn nhấp vào Verify domain, Dodo Payments lấy tệp association từ domain của bạn và gửi domain đến Apple. Domain vẫn ở trạng thái Pending thường là do Dodo Payments không thể lấy tệp như dự kiến.

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ột host 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 tái sử dụng từ tài khoản hoặc provider 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 riêng của bạn, chẳng hạn 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 sự cố hosting, sau đó nhấp lại vào Verify domain. Nếu domain không chuyển sang Active sau khi kiểm tra thành công, hãy liên hệ [e-mail] và cung cấp tên domain.

Google Pay button not appearing

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.

Wallet payment failed

Nguyên nhân phổ biến:

• 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 khoả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.

Wrong device type

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 dự kiến. Hãy duy trì 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.