Ví điện tử

Ví điện tử cho phép khách hàng thanh toán chỉ với một lần chạm bằng các phương thức thanh toán được lưu trên thiết bị của họ. Ví điện tử mang lại tỷ lệ chuyển đổi cao hơn, bảo mật tốt hơn nhờ tokenization và trải nghiệm thanh toán được tinh gọn.

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

Ví	Khả dụng	Tiền tệ	Gói đăng ký	Yêu cầu thiết lập
Apple Pay	Toàn cầu (trừ Ấn Độ)	Tất cả	Có	Xác minh domain
Google Pay	Toàn cầu (trừ Ấn Độ)	Tất cả	Có	Không có
Amazon Pay	Toàn cầu (trừ Ấn Độ)	USD	Không	Không có
Cash App Pay	Chỉ tại Hoa Kỳ	USD	Không	Không có
RevolutPay	Toàn cầu	GBP	Không	Không có

Hỗ trợ PayPal tạm dừng: PayPal 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 các thẻ được lưu trong Apple Wallet, với xác thực Face ID hoặc Touch ID.

Apple Pay được cung cấp cho các gói đăng ký ngay cả khi khoản phí đầu tiên là **

0** (ví dụ: bản dùng thử miễn phí), để có thể thiết lập ủy nhiệm thanh toán khi đăng ký. Đối với các khoản thanh toán một lần, Apple Pay chỉ hiển thị khi số tiền lớn hơn

Yêu cầu

Thiết bị: iOS 17+, iPadOS 17+, Safari 17+ trên macOS
Giao thức: Bắt buộc sử dụng HTTPS
Domain: Phải được xác minh với Apple

Xác minh domain

Chỉ cần xác minh domain đối với checkout inline (nhúng). Checkout overlay, checkout hosted và payment links không yêu cầu xác minh.

Open Wallet domains

Trong dashboard, đi đến Settings → Payment Methods và 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 Wallet domains from the Apple Pay row

Download the domain association file

Từ bảng điều khiển Wallet domains, tải xuống association file.

Bảng Wallet domains với nút Download file — Download the Apple Pay domain association file

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

Biểu mẫu đăng ký domain với một domain đã được nhập — Register the domain where you embed checkout

Host the file on your domain

Tải lên server của bạn tại:

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

File phải được cung cấp qua HTTPS, có thể truy cập mà không cần redirect và được cung cấp với Content-Type: application/octet-stream hoặc text/plain.

Verify the domain

Nhấp vào Verify domain. Dodo Payments kiểm tra file được lưu trữ và gửi domain của bạn đến Apple.

Màn hình Verify your domain với đường dẫn host của association file và nút Verify domain — Verify the hosted association file

Confirm it's active

Khi trạng thái hiển thị Active, Apple Pay đã hoạt động cho domain đó. Sử dụng công tắc Enabled để bật hoặc tắt theo từng domain.

Danh sách Wallet domains hiển thị các domain có trạng thái Apple Pay Active và các công tắc Enabled — Verified domains show an Active status

Test the integration

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

Cấu hình

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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ẻ được lưu trong tài khoản Google của họ, với tính năng bảo vệ chống gian lận tích hợp sẵn.

Yêu cầu

Trình duyệt: Chrome (desktop/mobile), Safari, Firefox
Thiết bị: Thiết bị Android có ứng dụng Google Pay
Cài đặt: Bật “Allow sites to check if you have payment methods” trong Chrome

Cấu hình

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

Không cần xác minh domain cho Google Pay — tính năng này tự động hoạt động khi tài khoản của bạn đã live.

Amazon Pay

Amazon Pay cho phép khách hàng sử dụng thông tin đăng nhập và các phương thức thanh toán đã lưu trong tài khoản Amazon để có trải nghiệm checkout quen thuộc.

Hạn chế

Tiền tệ: Chỉ USD
Gói đăng ký: Không được hỗ trợ
Khu vực: Không khả dụng tại Ấn Độ

Cấu hình

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 thanh toán từ Cash App, phổ biến với người tiêu dùng Hoa Kỳ khi thực hiện thanh toán ngang hàng.

Hạn chế

Khu vực: Chỉ tại Hoa Kỳ
Tiền tệ: Chỉ USD
Gói đăng ký: Không được hỗ trợ

Cấu hình

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 trên toàn cầu thanh toán nhanh chóng và liền mạch bằng số dư tài khoản Revolut hiện có hoặc các thẻ đã liên kết.

Hạn chế

Tiền tệ: Chỉ GBP
Gói đăng ký: Không được hỗ trợ

Cấu hình

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

Kiểm thử

Kiểm thử Apple Pay

Use test mode

Bật chế độ kiểm thử trong dashboard Dodo Payments của bạn.

Add a card to Apple Wallet

Thêm một thẻ thật vào Apple Wallet. Trong chế độ kiểm thử, thẻ sẽ không bị tính phí.

Complete 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. Tính năng này sẽ không xuất hiện trên localhost nếu chưa thiết lập SSL đúng cách.

Kiểm thử Google Pay

Join the test card group

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

Enable test mode

Sử dụng API keys kiểm thử Dodo Payments của bạn.

Complete 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 kiểm thử của bạn và thực hiện quy trình checkout tiêu chuẩn. Các giao dịch kiểm thử sẽ được mô phỏng mà không phát sinh khoản phí thực tế.

Hỗ trợ SDK

Web SDK

Tất cả ví điện tử đều được hỗ trợ đầy đủ trong:

Overlay Checkout
Inline Checkout
Tích hợp Direct API

SDK Mobile (Checkout)

Các SDK checkout cho Android, iOS, React Native và Flutter sẽ mở checkout được lưu trữ trên Dodo trong giao diện trình duyệt thực của nền tảng (SFSafariViewController / Chrome Custom Tabs), không phải WebView, vì vậy Apple Pay và Google Pay hoạt động tương tự như trên web. Xem Hướng dẫn tích hợp Mobile để biết cách thiết lập.

Các phương pháp hay nhất

Prioritize wallets on mobile

Người dùng mobile 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

Apple Pay yêu cầu xác minh domain. Đừng chờ đến ngày ra mắt — hãy bắt đầu quy trình trong giai đoạn phát triển.

Always include card fallbacks

Không phải tất cả khách hàng đều có ví kỹ thuật số. Luôn bao gồm credit và debit trong các phương thức được phép.

Test on real devices

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 các thiết bị iOS và Android thực tế trước khi ra mắt.

Handle wallet unavailability gracefully

Nếu không có ví (thiết bị không phù hợp, không lưu thẻ nào), hãy đảm bảo các tùy chọn thanh toán khác vẫn hiển thị.

Khắc phục sự cố

Apple Pay button not appearing

Kiểm tra:

Domain đã được xác minh với Dodo Payments chưa?
Có đang sử dụng HTTPS không?
Thiết bị có phải là iOS 17+ / Safari 17+ / iPadOS 17+ không?
Khách hàng có thẻ trong Apple Wallet không?
apple_pay có được bao gồm trong allowed_payment_method_types không?

Giải pháp: Hoàn tất xác minh domain và đảm bảo sử dụng HTTPS. Kiểm thử trên thiết bị Apple thực tế.

Google Pay button not appearing

Kiểm tra:

Có đang sử dụng Chrome hoặc trình duyệt tương thích không?
Khách hàng có thẻ trong Google Pay không?
Cài đặt Chrome “Allow sites to check payment methods” đã được bật chưa?
google_pay có được bao gồm trong allowed_payment_method_types không?

Giải pháp: Xác minh khả năng tương thích của trình duyệt và thiết lập Google Pay của khách hàng.

Wallet payment failed

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

Giải pháp: Khách hàng nên xác minh thẻ trong ví hoặc thử một phương thức thanh toán khác.

Wrong device type

Ví kỹ thuật số chỉ xuất hiện trên các thiết bị tương thích:

Apple Pay: chỉ các thiết bị Apple
Google Pay: trình duyệt Chrome hoặc thiết bị Android

Giải pháp: Đây là hành vi dự kiến. Đảm bảo có sẵn các phương án dự phòng khi thẻ không sử dụng được.

Các trang liên quan

Payment Methods Overview

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

Overlay Checkout

Triển khai checkout với hỗ trợ ví kỹ thuật số.

Testing Process

Hướng dẫn kiểm thử đầy đủ cho tất cả các phương thức thanh toán.

Mobile Integration Guide

Mở checkout được lưu trữ trong tab trình duyệt gốc — Apple Pay và Google Pay hoạt động giống như trên web.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Apple Pay

Yêu cầu

Xác minh domain

Cấu hình

Google Pay

Yêu cầu

Cấu hình

Amazon Pay

Hạn chế

Cấu hình

Cash App Pay

Hạn chế

Cấu hình

RevolutPay

Hạn chế

Cấu hình

Kiểm thử

Kiểm thử Apple Pay

Kiểm thử Google Pay

Amazon Pay & Cash App Pay

Hỗ trợ SDK

Web SDK

SDK Mobile (Checkout)

Các phương pháp hay nhất

Khắc phục sự cố

Các trang liên quan

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

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

​Apple Pay

​Yêu cầu

​Xác minh domain

​Cấu hình

​Google Pay

​Yêu cầu

​Cấu hình

​Amazon Pay

​Hạn chế

​Cấu hình

​Cash App Pay

​Hạn chế

​Cấu hình

​RevolutPay

​Hạn chế

​Cấu hình

​Kiểm thử

​Kiểm thử Apple Pay

​Kiểm thử Google Pay

​Amazon Pay & Cash App Pay

​Hỗ trợ SDK

​Web SDK

​SDK Mobile (Checkout)

​Các phương pháp hay nhất

​Khắc phục sự cố

​Các trang liên quan

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

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

Apple Pay

Yêu cầu

Xác minh domain

Cấu hình

Google Pay

Yêu cầu

Cấu hình

Amazon Pay

Hạn chế

Cấu hình

Cash App Pay

Hạn chế

Cấu hình

RevolutPay

Hạn chế

Cấu hình

Kiểm thử

Kiểm thử Apple Pay

Kiểm thử Google Pay

Amazon Pay & Cash App Pay

Hỗ trợ SDK

Web SDK

SDK Mobile (Checkout)

Các phương pháp hay nhất

Khắc phục sự cố

Các trang liên quan