Phương thức thanh toán tại Châu Á - Thái Bình Dương

Cho phép khách hàng tại Philippines, Hồng Kông và Malaysia thanh toán bằng ví điện tử hoặc chuyển khoản ngân hàng mà họ sử dụng hằng ngày. Dodo Payments hỗ trợ GCash (Philippines), Alipay HK và FPS (Hồng Kông), cùng Touch ‘n Go (Malaysia) cho các khoản thanh toán một lần. Mỗi phương thức được tính phí bằng đơn vị tiền tệ địa phương, và khách hàng thanh toán bằng cách quét mã QR hiển thị trong quá trình checkout.

Trang này bao quát Philippines, Hồng Kông và Malaysia. Đối với các thị trường châu Á khác, hãy xem Ấn Độ để tìm hiểu về UPI và Rupay, Hàn Quốc về Kakao Pay, Naver Pay và PAYCO, cùng WeChat Pay dành cho khách hàng Trung Quốc.

Vì sao ví điện tử tại Châu Á - Thái Bình Dương quan trọng

Wallet-First Markets

GCash là ví điện tử phổ biến nhất tại Philippines, còn Touch ‘n Go là ví điện tử lớn nhất tại Malaysia.

Low Card Penetration

Việc sử dụng thẻ tín dụng tại Philippines thấp hơn so với các thị trường ưu tiên thanh toán bằng thẻ. Ví điện tử và chuyển khoản ngân hàng địa phương tiếp cận được những khách hàng mà quy trình checkout chỉ hỗ trợ thẻ không thể phục vụ.

Instant Settlement

FPS hoạt động 24 giờ mỗi ngày tại Hồng Kông và tiền đến người nhận gần như ngay lập tức, vì vậy checkout có thể xác nhận thanh toán trong khi khách hàng chờ.

Phương thức được hỗ trợ

Bảng liệt kê thị trường, đơn vị tiền tệ thanh toán và số tiền tối thiểu của từng phương thức. Mức tối thiểu là số tiền tối thiểu khi checkout cho đơn vị tiền tệ đó, nên áp dụng cho mọi phương thức thanh toán trong checkout sử dụng đơn vị tiền tệ này.

Phương thức	Quốc gia	Đơn vị tiền tệ thanh toán	Gói đăng ký	Số tiền tối thiểu
GCash	Philippines	PHP	Không	50.00 PHP
Alipay HK	Hồng Kông	HKD	Không	4.00 HKD
FPS	Hồng Kông	HKD, CNY	Không	4.00 HKD / 4.00 CNY
Touch ‘n Go	Malaysia	MYR	Không	4.00 MYR

Cả bốn phương thức chỉ dùng cho thanh toán một lần. Không phương thức nào xuất hiện trong checkout đăng ký hoặc hỗ trợ bất kỳ khoản phí định kỳ nào khác. Hãy thêm credit và debit vào checkout đăng ký để khách hàng tại các thị trường này vẫn có thể đăng ký.

Khách hàng thanh toán bằng đơn vị tiền tệ địa phương. Các khoản thanh toán bằng bốn phương thức này được quyết toán vào ví USD của bạn. Các khoản thanh toán bằng thẻ trong cùng checkout cũng được quyết toán bằng USD.

Chi tiết phương thức

GCash (Philippines)

GCash là ví điện tử phổ biến nhất tại Philippines. Trong checkout, khách hàng chọn GCash, nhấp vào Pay và quét mã QR bằng ứng dụng GCash để phê duyệt thanh toán.Được cung cấp trong các checkout một lần, được tính phí cho Philippines (PH) bằng PHP.

Alipay HK (Hong Kong)

Alipay HK là phiên bản Alipay dành cho Hồng Kông. Phương thức này phục vụ thị trường địa phương và được quyết toán bằng đô la Hồng Kông. Đây là phương thức riêng biệt với sản phẩm Alipay của Trung Quốc đại lục. Checkout hiển thị tên phương thức là AlipayHK.Được cung cấp trong các checkout một lần, được tính phí cho Hồng Kông (HK) bằng HKD. Alipay HK chỉ được quyết toán bằng HKD, vì vậy không xuất hiện trong checkout bằng CNY, ngay cả khi quốc gia thanh toán là Hồng Kông.

FPS (Hong Kong)

FPS (Faster Payment System) là hệ thống thanh toán theo thời gian thực của Hồng Kông, do Hong Kong Monetary Authority ra mắt. Hệ thống kết nối các ngân hàng và ví điện tử, hoạt động 24 giờ mỗi ngày, đồng thời hỗ trợ đô la Hồng Kông và nhân dân tệ Trung Quốc. Khách hàng quét mã QR bằng ứng dụng ngân hàng hoặc ví điện tử, và tiền đến gần như ngay lập tức.Được cung cấp trong các checkout một lần, được tính phí cho Hồng Kông (HK) bằng HKD hoặc CNY.

Touch 'n Go (Malaysia)

Touch ‘n Go là ví điện tử lớn nhất tại Malaysia. Khách hàng quét mã QR bằng ứng dụng Touch ‘n Go và xác nhận thanh toán trong ứng dụng.Được cung cấp trong các checkout một lần, được tính phí cho Malaysia (MY) bằng MYR.

Cấu hình

Loại phương thức API

Truyền các giá trị này trong allowed_payment_method_types:

Loại	Mô tả
`gcash`	Ví GCash (Philippines)
`ali_pay_hk`	Ví Alipay HK (Hồng Kông)
`fps`	Chuyển khoản ngân hàng theo thời gian thực FPS (Hồng Kông)
`touch_n_go`	Ví Touch ‘n Go (Malaysia)

Ví dụ: Checkout tại Philippines

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['gcash', 'credit', 'debit'],
  billing_currency: 'PHP',
  billing_address: {
    country: 'PH',
    zipcode: '1226'
  },
  return_url: 'https://example.com/success'
});

Ví dụ: Checkout tại Hồng Kông

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ali_pay_hk', 'fps', 'credit', 'debit'],
  billing_currency: 'HKD',
  billing_address: {
    country: 'HK',
    zipcode: '999077'
  },
  return_url: 'https://example.com/success'
});

Ví dụ: Checkout tại Malaysia

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['touch_n_go', 'credit', 'debit'],
  billing_currency: 'MYR',
  billing_address: {
    country: 'MY',
    zipcode: '50450'
  },
  return_url: 'https://example.com/success'
});

Yêu cầu

Một phương thức chỉ xuất hiện trong checkout khi tất cả điều kiện sau đều đúng:

Quốc gia thanh toán khớp với thị trường của phương thức: PH cho GCash, HK cho Alipay HK và FPS, MY cho Touch ‘n Go.
Đơn vị tiền tệ thanh toán khớp với phương thức: PHP, HKD (hoặc CNY cho FPS), hoặc MYR.
Checkout là khoản thanh toán một lần, không phải gói đăng ký.
Adaptive Currency được bật. Nếu không, billing_currency sẽ bị bỏ qua và checkout không thể tính phí bằng PHP, HKD, CNY hoặc MYR.

Nếu Adaptive Currency bị tắt, khách hàng tại các thị trường này sẽ không bị tính phí bằng đơn vị tiền tệ địa phương và không phương thức nào trong số này xuất hiện.

Kiểm thử

Enable 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 ở test mode.

Set the billing country and currency

Tạo checkout một lần với quốc gia của địa chỉ thanh toán và đơn vị tiền tệ thanh toán tương ứng với phương thức bạn đang kiểm thử:

Phương thức	Quốc gia thanh toán	Đơn vị tiền tệ thanh toán
GCash	`PH`	`PHP`
Alipay HK	`HK`	`HKD`
FPS	`HK`	`HKD` hoặc `CNY`
Touch ‘n Go	`MY`	`MYR`

Thêm loại phương thức vào allowed_payment_method_types. Các phương thức này không được cung cấp trong checkout đăng ký.

Select the method and confirm

Chọn phương thức thanh toán trong checkout và nhấp vào Pay. Mã QR mở trong lớp phủ toàn màn hình cùng đồng hồ đếm ngược 10 phút, và checkout kiểm tra trạng thái thanh toán trong khi lớp phủ đang mở.

Verify the checkout behavior

Xác nhận rằng phương thức chỉ xuất hiện cho quốc gia và đơn vị tiền tệ tương ứng, đồng thời mã QR được hiển thị.

Mã QR ở test mode đến từ môi trường kiểm thử của nhà cung cấp ví và có thể hoạt động khác với thanh toán thực.

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

Lead with the local wallet

Tại Philippines và Malaysia, nhiều khách hàng mong muốn thanh toán bằng ví điện tử địa phương. Hiển thị GCash hoặc Touch ‘n Go bên cạnh thẻ trong checkout dành cho các thị trường này.

Offer both Hong Kong methods

Alipay HK và FPS phục vụ các nhóm khách hàng khác nhau: người dùng ví điện tử và người dùng chuyển khoản ngân hàng. Thêm cả hai vào checkout bằng HKD để mỗi khách hàng thấy phương thức họ ưa thích.

Keep cards on subscription checkouts

Mọi phương thức trên trang này chỉ dùng cho thanh toán một lần, vì vậy checkout đăng ký chỉ liệt kê ví điện tử địa phương sẽ không có phương thức nào để hiển thị. Thêm credit và debit cho các gói định kỳ.

Match currency to region

Các phương thức này yêu cầu đơn vị tiền tệ thanh toán địa phương. Nếu danh mục của bạn được định giá bằng USD hoặc EUR, hãy bật Adaptive Currency để khách hàng được báo giá và tính phí bằng PHP, HKD, CNY hoặc MYR.

Khắc phục sự cố

Method not appearing at checkout

Kiểm tra:

Quốc gia thanh toán có phải là PH, HK hoặc MY, khớp với phương thức không?
Đơn vị tiền tệ thanh toán có phải là PHP, HKD, CNY hoặc MYR, khớp với phương thức không?
Đây có phải là khoản thanh toán một lần không? Không phương thức nào trong số này xuất hiện trong gói đăng ký.
Loại phương thức (gcash, ali_pay_hk, fps hoặc touch_n_go) có được thêm vào allowed_payment_method_types không?
Adaptive Currency đã được bật chưa?
Số tiền có đạt mức tối thiểu của đơn vị tiền tệ trong Các phương thức được hỗ trợ không?

Giải pháp: Tạm thời xóa allowed_payment_method_types để xem mọi phương thức đủ điều kiện, sau đó xác định điều kiện không đạt.

Alipay HK missing on a CNY checkout

Nguyên nhân: Alipay HK chỉ được quyết toán bằng HKD. Checkout tính phí cho Hồng Kông bằng CNY sẽ cung cấp FPS nhưng không bao giờ cung cấp Alipay HK.Giải pháp: Tính phí bằng HKD để cung cấp Alipay HK hoặc thêm fps cho checkout bằng CNY tại Hồng Kông.

Wallet missing on a subscription

Nguyên nhân: GCash, Alipay HK, FPS và Touch ‘n Go chỉ dùng cho thanh toán một lần và không được cung cấp cho thanh toán định kỳ.Giải pháp: Sử dụng credit và debit cho các gói đăng ký tại những thị trường này.

Payment not confirming

Nguyên nhân: Khách hàng phải quét mã QR và phê duyệt thanh toán trong ứng dụng ví điện tử hoặc ngân hàng. Nếu khách hàng đóng ứng dụng trước khi phê duyệt, thanh toán sẽ vẫn chưa hoàn tất.Giải pháp: Sử dụng webhook cho trạng thái thanh toán cuối cùng thay vì chuyển hướng trả về. Xem hướng dẫn Webhooks.

Trang liên quan

Payment Methods Overview

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

Adaptive Currency

Tính phí khách hàng bằng đơn vị tiền tệ địa phương của họ, bao gồm PHP, HKD, CNY và MYR.

Checkout Guide

Hướng dẫn hoàn chỉnh về triển khai checkout.

Testing Process

Dữ liệu kiểm thử và hướng dẫn kiểm thử checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Phương thức thanh toán tại Châu Á - Thái Bình Dương

Vì sao ví điện tử tại Châu Á - Thái Bình Dương quan trọng

Wallet-First Markets

Low Card Penetration

Instant Settlement

Phương thức được hỗ trợ

Chi tiết phương thức

Cấu hình

Loại phương thức API

Ví dụ: Checkout tại Philippines

Ví dụ: Checkout tại Hồng Kông

Ví dụ: Checkout tại Malaysia

Yêu cầu

Kiểm thử

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

Khắc phục sự cố

Trang liên quan

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

​Vì sao ví điện tử tại Châu Á - Thái Bình Dương quan trọng

Wallet-First Markets

Low Card Penetration

Instant Settlement

​Phương thức được hỗ trợ

​Chi tiết phương thức

​Cấu hình

​Loại phương thức API

​Ví dụ: Checkout tại Philippines

​Ví dụ: Checkout tại Hồng Kông

​Ví dụ: Checkout tại Malaysia

​Yêu cầu

​Kiểm thử

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

​Khắc phục sự cố

​Trang liên quan

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

Vì sao ví điện tử tại Châu Á - Thái Bình Dương quan trọng

Phương thức được hỗ trợ

Chi tiết phương thức

Cấu hình

Loại phương thức API

Ví dụ: Checkout tại Philippines

Ví dụ: Checkout tại Hồng Kông

Ví dụ: Checkout tại Malaysia

Yêu cầu

Kiểm thử

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

Khắc phục sự cố

Trang liên quan