> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Chấp nhận GCash tại Philippines, Alipay HK và FPS tại Hồng Kông, cùng Touch 'n Go tại Malaysia. Tìm hiểu về yêu cầu tiền tệ, hỗ trợ thanh toán một lần và cấu hình.

Người mua trên khắp khu vực Châu Á - Thái Bình Dương thanh toán bằng ví điện tử nội địa và chuyển khoản ngân hàng theo thời gian thực thường xuyên hơn nhiều so với thẻ quốc tế. Dodo Payments hỗ trợ **GCash** (Philippines), **Alipay HK** và **FPS** (Hồng Kông), cùng **Touch 'n Go** (Malaysia); mỗi phương thức được tính phí bằng đồng tiền địa phương.

<Note>
  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 Độ](/features/payment-methods/india) để tìm hiểu về UPI và Rupay, [Hàn Quốc](/features/payment-methods/south-korea) về Kakao Pay, Naver Pay và PAYCO, cùng [WeChat Pay](/features/payment-methods/wechat) dành cho khách hàng Trung Quốc.
</Note>

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

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash và Touch 'n Go là phương thức thanh toán trực tuyến mặc định tại Philippines và Malaysia, vượt xa việc nhập thông tin thẻ.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    Tỷ lệ sở hữu thẻ còn hạn chế ở phần lớn khu vực này. Ví điện tử nội địa và hệ thống ngân hàng địa phương tiếp cận được những khách hàng mà quy trình thanh toán chỉ hỗ trợ thẻ bỏ sót.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS xử lý chuyển khoản giữa các ngân hàng theo thời gian thực tại Hồng Kông, vì vậy thanh toán được xác nhận trong lúc thanh toán thay vì phải chờ nhiều giờ.
  </Card>
</CardGroup>

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

| Phương thức     | Quốc gia    | Đồng tiền 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            |

<Warning>
  **Cả bốn phương thức đều chỉ hỗ trợ thanh toán một lần.** Không phương thức nào hỗ trợ gói đăng ký hoặc bất kỳ khoản phí định kỳ nào khác. Luôn bao gồm `credit` và `debit` trong quy trình thanh toán gói đăng ký để khách hàng tại các thị trường này vẫn có thể đăng ký.
</Warning>

<Info>
  Khách hàng thanh toán bằng đồng tiền địa phương và bạn nhận tiền quyết toán bằng **USD**, giống như mọi phương thức không phải USD khác.
</Info>

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

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash là ví điện tử lớn nhất Philippines, được sử dụng cho mọi nhu cầu từ thanh toán hóa đơn đến mua sắm trực tuyến. Khách hàng phê duyệt thanh toán trong ứng dụng GCash rồi được chuyển về trang thành công của bạn.

    Được cung cấp trong các quy trình thanh toán **một lần**, tính phí tại **Philippines (`PH`)** bằng **PHP**.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK là phiên bản Alipay dành cho Hồng Kông, được vận hành cho thị trường địa phương và quyết toán bằng đô la Hồng Kông. Đây là một phương thức riêng biệt với sản phẩm Alipay tại Trung Quốc đại lục.

    Được cung cấp trong các quy trình thanh toán **một lần**, tính phí tại **Hồng Kông (`HK`)** bằng **HKD**. Alipay HK chỉ quyết toán bằng HKD, vì vậy phương thức này không xuất hiện trong quy trình thanh toán bằng CNY ngay cả khi quốc gia thanh toán là Hồng Kông.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS (Faster Payment System) là mạng lưới chuyển khoản liên ngân hàng theo thời gian thực của Hồng Kông, do Hong Kong Monetary Authority vận hành. Khách hàng thanh toán trực tiếp từ tài khoản ngân hàng và giao dịch được xử lý ngay lập tức.

    Được cung cấp trong các quy trình thanh toán **một lần**, tính phí tại **Hồng Kông (`HK`)** bằng **HKD** hoặc **CNY**.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go là ví điện tử phổ biến nhất Malaysia. Khách hàng xác nhận thanh toán trong ứng dụng Touch 'n Go rồi quay lại trang thành công của bạn.

    Được cung cấp trong các quy trình thanh toán **một lần**, tính phí tại **Malaysia (`MY`)** bằng **MYR**.
  </Accordion>
</AccordionGroup>

## Cấu hình

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

| 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ụ: Quy trình thanh toán tại Philippines

```javascript theme={null}
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ụ: Quy trình thanh toán tại Hồng Kông

```javascript theme={null}
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ụ: Quy trình thanh toán tại Malaysia

```javascript theme={null}
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

Để các phương thức này xuất hiện trong quy trình thanh toán:

1. **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
2. **Tiền tệ** khớp với phương thức — PHP, HKD (hoặc CNY đối với FPS), hoặc MYR
3. **Loại thanh toán** là thanh toán một lần, không phải gói đăng ký
4. Đối với các merchant định giá bằng một loại tiền tệ khác: phải bật **[Adaptive Currency](/features/adaptive-currency)** để khách hàng được tính phí bằng đồng tiền địa phương

<Warning>
  Nếu bạn định giá bằng một loại tiền tệ khác và chưa bật Adaptive Currency, khách hàng tại các thị trường này sẽ không được tính phí bằng đồng tiền địa phương và không phương thức nào trong số này khả dụng.
</Warning>

## Kiểm thử

<Steps>
  <Step title="Enable test mode">
    Sử dụng API key kiểm thử của Dodo Payments.
  </Step>

  <Step title="Set the billing country and currency">
    Tạo một quy trình thanh toán một lần với quốc gia địa chỉ thanh toá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 | Tiền tệ thanh toán |
    | :---------- | :------------------ | :----------------- |
    | GCash       | `PH`                | `PHP`              |
    | Alipay HK   | `HK`                | `HKD`              |
    | FPS         | `HK`                | `HKD` hoặc `CNY`   |
    | Touch 'n Go | `MY`                | `MYR`              |

    Bao gồm loại phương thức trong `allowed_payment_method_types`. Các phương thức này không được cung cấp trong quy trình thanh toán gói đăng ký.
  </Step>

  <Step title="Select the method and confirm">
    Chọn phương thức thanh toán trong quy trình thanh toán rồi nhấp vào **Pay**. Mã QR sẽ mở trong lớp phủ toàn màn hình và quy trình thanh toán sẽ chờ thanh toán được thực hiện.
  </Step>

  <Step title="Verify the checkout behavior">
    Xác nhận rằng phương thức chỉ xuất hiện với quốc gia và tiền tệ tương ứng, đồng thời mã QR được hiển thị.
  </Step>
</Steps>

<Note>
  Mã QR ở chế độ kiểm thử do môi trường kiểm thử của nhà cung cấp ví phát hành và có thể hoạt động khác với thanh toán thực tế.
</Note>

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

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    Tại Philippines và Malaysia, ví điện tử địa phương là phương thức chính mà khách hàng mong muốn sử dụng để thanh toán. Việc cung cấp GCash hoặc Touch 'n Go cùng với thẻ giúp giảm đáng kể tỷ lệ từ bỏ thanh toán.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK và FPS phục vụ những 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. Hãy cung cấp cả hai trong quy trình thanh toán bằng HKD để Dodo Payments có thể hiển thị phương thức mà khách hàng ưu tiên.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Vì mọi phương thức trên trang này đều chỉ hỗ trợ thanh toán một lần, quy trình thanh toán gói đă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ị. Luôn bao gồm `credit` và `debit` cho các gói định kỳ.
  </Accordion>

  <Accordion title="Match currency to region">
    Các phương thức này yêu cầu đồng tiền thanh toán địa phương tương ứ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.
  </Accordion>
</AccordionGroup>

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **Kiểm tra:**

    1. Quốc gia thanh toán có được đặt thành `PH`, `HK` hoặc `MY` để khớp với phương thức không?
    2. Tiền tệ thanh toán có được đặt thành PHP, HKD, CNY hoặc MYR để khớp với phương thức không?
    3. Đây có phải là 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ý.
    4. Phương thức (`gcash`, `ali_pay_hk`, `fps` hoặc `touch_n_go`) có được bao gồm trong `allowed_payment_method_types` không?
    5. Nếu định giá bằng một loại tiền tệ khác: Adaptive Currency đã được bật chưa?

    **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 đó thu hẹp phạm vi nhằm xác định điều kiện nào không đạt.
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **Nguyên nhân:** Alipay HK chỉ quyết toán bằng HKD. Quy trình thanh toán tại 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 bao gồm `fps` cho các quy trình thanh toán bằng CNY tại Hồng Kông.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **Nguyên nhân:** GCash, Alipay HK, FPS và Touch 'n Go đều chỉ hỗ trợ thanh toán một lần và không bao giờ được cung cấp cho hình thức 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.
  </Accordion>

  <Accordion title="Payment not confirming">
    **Nguyên nhân:** Các phương thức này chuyển hướng khách hàng đến ứng dụng ví điện tử hoặc ứng dụng ngân hàng. Nếu khách hàng rời khỏi ứng dụng, thanh toán sẽ vẫn ở trạng thái chưa hoàn tất.

    **Giải pháp:** Theo dõi webhook để xác định trạng thái thanh toán cuối cùng thay vì dựa vào chuyển hướng quay lại. Xem [hướng dẫn Webhooks](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

## Trang liên quan

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Xem tất cả phương thức thanh toán được hỗ trợ.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Tính phí khách hàng bằng đồng tiền địa phương của họ, bao gồm PHP, HKD, CNY và MYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Hướng dẫn hoàn chỉnh về cách triển khai quy trình thanh toán.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Dữ liệu kiểm thử và hướng dẫn kiểm thử quy trình thanh toán.
  </Card>
</CardGroup>