Skip to main content
Cho phép khách hàng Trung Quốc thanh toán bằng cách quét mã QR với ứng dụng WeChat. WeChat Pay là ví thanh toán bên trong WeChat, ứng dụng di động hàng đầu của Trung Quốc, và Dodo Payments cung cấp phương thức này cho các khoản thanh toán một lần được tính phí bằng USD hoặc CNY.

Tại sao nên cung cấp WeChat Pay?

800M+ Users

WeChat có hơn 1 tỷ người dùng hoạt động hàng tháng, còn WeChat Pay có hơn 800 triệu người dùng.

Mobile-First

Khách hàng phê duyệt khoản thanh toán ngay trong ứng dụng WeChat, một quy trình mà khách hàng Trung Quốc đã quen thuộc.

Dual Currency

Tính phí bằng USD hoặc CNY, tùy thuộc vào nhóm khách hàng mà bạn bán hàng cho.

Tổng quan

Cách hoạt động

Trải nghiệm khách hàng

  1. Khách hàng chọn WeChat tại bước thanh toán và nhấp vào Pay.
  2. Mã QR mở trong lớp phủ toàn màn hình trên trang thanh toán.
  3. Khách hàng mở WeChat trên điện thoại và quét mã QR. Nếu khách hàng đang thanh toán trên điện thoại, trang thanh toán sẽ hướng dẫn họ chụp ảnh màn hình mã QR và quét mã từ album ảnh WeChat.
  4. Khách hàng xác nhận khoản thanh toán trong ứng dụng WeChat.
  5. Trang thanh toán phát hiện khoản thanh toán đã hoàn tất và chuyển hướng khách hàng đến trang thành công của bạn.
Khách hàng thanh toán bằng USD hoặc CNY, và bạn nhận tiền đối soát bằng USD.

Cấu hình

WeChat Pay xuất hiện trên các trang thanh toán một lần được tính phí bằng USD hoặc CNY. Để tính phí bằng CNY, hãy bật Adaptive Currency và truyền billing_currency: 'CNY'.

Loại phương thức API

Kiểm thử

1

Enable test mode

Tắt công tắc Live Mode trong thanh bên của dashboard và sử dụng các API key được tạo ở chế độ kiểm thử.
2

Create a test checkout

Tạo một phiên thanh toán một lần với we_chat_pay trong allowed_payment_method_types.
3

Scan the QR code

Trang thanh toán hiển thị mã QR kiểm thử. Quét mã bằng camera điện thoại; không cần ứng dụng WeChat. Mã QR mở một trang kiểm thử, nơi bạn có thể ủy quyền hoặc làm cho khoản thanh toán thất bại.

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

WeChat Pay chủ yếu được người tiêu dùng Trung Quốc sử dụng. Hãy cung cấp phương thức này khi khách hàng của bạn bao gồm người mua Trung Quốc hoặc khi bạn bán hàng cho thị trường Trung Quốc.
Không phải khách hàng nào cũng có WeChat. Hãy cung cấp credit và debit làm phương thức thanh toán dự phòng.
Việc quét mã dễ dàng nhất khi trang thanh toán được mở trên máy tính hoặc máy tính bảng và khách hàng quét bằng điện thoại. Trên điện thoại, trang thanh toán hướng dẫn khách hàng chụp ảnh màn hình mã QR và quét mã từ album ảnh WeChat, vì vậy hãy đảm bảo trang thanh toán của bạn có thiết kế responsive.
WeChat Pay hỗ trợ USD và CNY. Hãy chọn loại tiền tính phí phù hợp với khách hàng của bạn: USD nếu bạn định giá bằng USD hoặc CNY để hiển thị cho khách hàng Trung Quốc mức giá bằng đồng tiền của họ. Dù chọn loại tiền nào, việc thanh toán đối soát vẫn bằng USD.

Khắc phục sự cố

Kiểm tra:
  1. we_chat_pay có được đưa vào allowed_payment_method_types không?
  2. Loại tiền tính phí có phải là USD hoặc CNY không?
  3. Số tiền có đạt mức tối thiểu ($0.50 hoặc 4.00 CNY) không?
  4. Đây có phải là khoản thanh toán một lần không? WeChat Pay không được cung cấp cho subscriptions.
Giải pháp: Kiểm tra loại phương thức thanh toán và loại tiền trong API request của bạn.
Nguyên nhân: Mã QR có thể đã hết hạn hoặc phiên bản WeChat của khách hàng đã lỗi thời. Mã QR sẽ hết hạn sau một khoảng thời gian giới hạn.Giải pháp: Nếu mã QR đã hết hạn, khách hàng cần bắt đầu một checkout mới từ trang web của bạn hoặc bạn có thể tạo một checkout session mới cho họ. Nếu mã vẫn còn hiệu lực, hãy yêu cầu khách hàng cập nhật WeChat lên phiên bản hiện tại.
Nguyên nhân: WeChat Pay thường xác nhận trong vài giây, nhưng có thể xảy ra chậm trễ do mạng.Giải pháp: Sử dụng webhooks để xác nhận khoản thanh toán. Nếu khoản thanh toán không được xác nhận trong vài phút, khách hàng có thể cần thử lại.

Trang liên quan

Payment Methods Overview

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

Checkout Guide

Hướng dẫn hoàn chỉnh về cách triển khai trang thanh toán.

Webhooks

Xử lý xác nhận thanh toán không đồng bộ.

Asia-Pacific

GCash (Philippines), Alipay HK và FPS (Hong Kong), cùng Touch ‘n Go (Malaysia).

Testing Process

Hướng dẫn kiểm thử hoàn chỉnh cho tất cả phương thức thanh toán.
Lần sửa đổi cuối 26 tháng 9, 2026