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

# Metode Pembayaran Asia-Pasifik

> Terima GCash di Filipina, Alipay HK dan FPS di Hong Kong, serta Touch 'n Go di Malaysia. Pelajari persyaratan mata uang, dukungan pembayaran satu kali, dan konfigurasinya.

Pembeli di seluruh kawasan Asia-Pasifik jauh lebih sering melakukan checkout dengan e-wallet lokal dan transfer bank real-time dibandingkan dengan kartu internasional. Dodo Payments mendukung **GCash** (Filipina), **Alipay HK** dan **FPS** (Hong Kong), serta **Touch 'n Go** (Malaysia), yang masing-masing ditagihkan dalam mata uang lokalnya.

<Note>
  Halaman ini mencakup Filipina, Hong Kong, dan Malaysia. Untuk pasar Asia lainnya, lihat [India](/features/payment-methods/india) untuk UPI dan Rupay, [Korea Selatan](/features/payment-methods/south-korea) untuk Kakao Pay, Naver Pay, dan PAYCO, serta [WeChat Pay](/features/payment-methods/wechat) untuk pelanggan di Tiongkok.
</Note>

## Mengapa E-Wallet Asia-Pasifik Penting

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash dan Touch 'n Go merupakan cara pembayaran online utama di Filipina dan Malaysia, jauh lebih banyak digunakan daripada memasukkan data kartu.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    Kepemilikan kartu masih terbatas di sebagian besar kawasan ini. E-wallet dan jaringan perbankan lokal dapat menjangkau pelanggan yang tidak terlayani oleh checkout yang hanya menerima kartu.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS memproses transfer antarbank secara real-time di Hong Kong, sehingga pembayaran dikonfirmasi selama checkout, bukan beberapa jam kemudian.
  </Card>
</CardGroup>

## Metode yang Didukung

| Metode          | Negara    | Mata Uang Penagihan | Langganan | Jumlah Min.         |
| :-------------- | :-------- | :------------------ | :-------: | :------------------ |
| **GCash**       | Filipina  | PHP                 |   Tidak   | 50.00 PHP           |
| **Alipay HK**   | Hong Kong | HKD                 |   Tidak   | 4.00 HKD            |
| **FPS**         | Hong Kong | HKD, CNY            |   Tidak   | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | Malaysia  | MYR                 |   Tidak   | 4.00 MYR            |

<Warning>
  **Keempat metode ini hanya dapat digunakan untuk pembayaran satu kali.** Tidak satu pun mendukung langganan atau tagihan berulang lainnya. Selalu sertakan `credit` dan `debit` pada checkout langganan agar pelanggan di pasar-pasar ini tetap dapat mendaftar.
</Warning>

<Info>
  Pelanggan membayar dalam mata uang lokal mereka, dan Anda menerima penyelesaian dalam **USD**, sama seperti metode non-USD lainnya.
</Info>

### Detail Metode

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash adalah e-wallet terbesar di Filipina, yang digunakan untuk segala hal mulai dari membayar tagihan hingga berbelanja online. Pelanggan menyetujui pembayaran di aplikasi GCash dan diarahkan kembali ke halaman keberhasilan Anda.

    Tersedia pada checkout **satu kali** yang ditagihkan ke **Filipina (`PH`)** dalam **PHP**.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK adalah edisi Hong Kong dari Alipay, yang dioperasikan untuk pasar lokal dan diselesaikan dalam dolar Hong Kong. Metode ini terpisah dari produk Alipay Tiongkok daratan.

    Tersedia pada checkout **satu kali** yang ditagihkan ke **Hong Kong (`HK`)** dalam **HKD**. Alipay HK hanya diselesaikan dalam HKD, sehingga tidak muncul pada checkout CNY meskipun negara penagihannya adalah Hong Kong.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS (Faster Payment System) adalah jaringan transfer antarbank real-time Hong Kong yang dijalankan oleh Hong Kong Monetary Authority. Pelanggan membayar langsung dari rekening bank mereka dan transfer diproses secara instan.

    Tersedia pada checkout **satu kali** yang ditagihkan ke **Hong Kong (`HK`)** dalam **HKD** atau **CNY**.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go adalah e-wallet yang paling banyak digunakan di Malaysia. Pelanggan mengonfirmasi pembayaran di aplikasi Touch 'n Go dan kembali ke halaman keberhasilan Anda.

    Tersedia pada checkout **satu kali** yang ditagihkan ke **Malaysia (`MY`)** dalam **MYR**.
  </Accordion>
</AccordionGroup>

## Konfigurasi

### Jenis Metode API

| Jenis        | Deskripsi                               |
| :----------- | :-------------------------------------- |
| `gcash`      | E-wallet GCash (Filipina)               |
| `ali_pay_hk` | E-wallet Alipay HK (Hong Kong)          |
| `fps`        | Transfer bank real-time FPS (Hong Kong) |
| `touch_n_go` | E-wallet Touch 'n Go (Malaysia)         |

### Contoh: Checkout Filipina

```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'
});
```

### Contoh: Checkout Hong Kong

```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'
});
```

### Contoh: Checkout 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'
});
```

### Persyaratan

Agar metode-metode ini muncul saat checkout:

1. **Negara penagihan** sesuai dengan pasar metode tersebut — `PH` untuk GCash, `HK` untuk Alipay HK dan FPS, serta `MY` untuk Touch 'n Go
2. **Mata uang** sesuai dengan metode tersebut — PHP, HKD (atau CNY untuk FPS), atau MYR
3. **Jenis pembayaran** adalah pembayaran satu kali, bukan langganan
4. Untuk merchant yang menetapkan harga dalam mata uang lain: **[Adaptive Currency](/features/adaptive-currency)** harus diaktifkan agar pelanggan ditagihkan dalam mata uang lokal

<Warning>
  Jika Anda menetapkan harga dalam mata uang lain dan Adaptive Currency tidak diaktifkan, pelanggan di pasar-pasar ini tidak akan ditagihkan dalam mata uang lokal dan tidak satu pun metode ini akan tersedia.
</Warning>

## Pengujian

<Steps>
  <Step title="Enable test mode">
    Gunakan API key pengujian Dodo Payments Anda.
  </Step>

  <Step title="Set the billing country and currency">
    Buat checkout satu kali dengan negara alamat penagihan dan mata uang penagihan untuk metode yang sedang Anda uji:

    | Metode      | Negara Penagihan | Mata Uang Penagihan |
    | :---------- | :--------------- | :------------------ |
    | GCash       | `PH`             | `PHP`               |
    | Alipay HK   | `HK`             | `HKD`               |
    | FPS         | `HK`             | `HKD` atau `CNY`    |
    | Touch 'n Go | `MY`             | `MYR`               |

    Sertakan jenis metode di `allowed_payment_method_types`. Metode-metode ini tidak ditawarkan pada checkout langganan.
  </Step>

  <Step title="Select the method and confirm">
    Pilih metode pembayaran saat checkout, lalu klik **Pay**. Kode QR terbuka dalam overlay layar penuh dan checkout menunggu pembayaran.
  </Step>

  <Step title="Verify the checkout behavior">
    Pastikan metode hanya muncul untuk negara dan mata uang yang sesuai, serta kode QR berhasil ditampilkan.
  </Step>
</Steps>

<Note>
  Kode QR dalam mode pengujian diterbitkan oleh lingkungan pengujian penyedia e-wallet dan mungkin berperilaku berbeda dari pembayaran langsung.
</Note>

## Praktik Terbaik

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    Di Filipina dan Malaysia, pelanggan mengharapkan e-wallet lokal sebagai cara pembayaran utama. Menyediakan GCash atau Touch 'n Go bersama kartu dapat mengurangi pembatalan secara signifikan.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK dan FPS melayani pelanggan yang berbeda — pengguna e-wallet dan pengguna transfer bank. Sertakan keduanya pada checkout HKD agar Dodo Payments dapat menampilkan opsi yang disukai pelanggan.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Karena setiap metode di halaman ini hanya dapat digunakan untuk pembayaran satu kali, checkout langganan yang hanya mencantumkan e-wallet lokal tidak memiliki opsi untuk ditampilkan. Selalu sertakan `credit` dan `debit` untuk paket berulang.
  </Accordion>

  <Accordion title="Match currency to region">
    Metode-metode ini memerlukan mata uang penagihan lokal masing-masing. Jika katalog Anda menetapkan harga dalam USD atau EUR, aktifkan Adaptive Currency agar pelanggan mendapatkan penawaran dan ditagihkan dalam PHP, HKD, CNY, atau MYR.
  </Accordion>
</AccordionGroup>

## Pemecahan Masalah

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **Periksa:**

    1. Apakah negara penagihan diatur ke `PH`, `HK`, atau `MY` sesuai dengan metodenya?
    2. Apakah mata uang penagihan diatur ke PHP, HKD, CNY, atau MYR sesuai dengan metodenya?
    3. Apakah ini pembayaran satu kali? Tidak satu pun metode ini muncul pada langganan.
    4. Apakah metode tersebut (`gcash`, `ali_pay_hk`, `fps`, atau `touch_n_go`) disertakan dalam `allowed_payment_method_types`?
    5. Jika harga ditetapkan dalam mata uang lain: apakah Adaptive Currency diaktifkan?

    **Solusi:** Hapus `allowed_payment_method_types` untuk sementara guna melihat semua metode yang memenuhi syarat, lalu tentukan kondisi mana yang gagal.
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **Penyebab:** Alipay HK hanya diselesaikan dalam HKD. Checkout yang ditagihkan ke Hong Kong dalam CNY menawarkan FPS, tetapi tidak pernah menawarkan Alipay HK.

    **Solusi:** Gunakan HKD untuk menawarkan Alipay HK, atau sertakan `fps` untuk checkout CNY di Hong Kong.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **Penyebab:** GCash, Alipay HK, FPS, dan Touch 'n Go semuanya hanya dapat digunakan untuk pembayaran satu kali dan tidak pernah ditawarkan untuk penagihan berulang.

    **Solusi:** Gunakan `credit` dan `debit` untuk langganan di pasar-pasar ini.
  </Accordion>

  <Accordion title="Payment not confirming">
    **Penyebab:** Metode-metode ini mengarahkan pelanggan ke aplikasi e-wallet atau aplikasi perbankan. Jika pelanggan meninggalkan aplikasi tersebut, pembayaran tetap tidak selesai.

    **Solusi:** Pantau webhook untuk status pembayaran final, bukan hanya mengandalkan pengalihan kembali. Lihat [panduan Webhooks](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

## Halaman Terkait

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Lihat semua metode pembayaran yang didukung.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Tagih pelanggan dalam mata uang lokal mereka, termasuk PHP, HKD, CNY, dan MYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Panduan lengkap implementasi checkout.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Data pengujian dan panduan pengujian checkout.
  </Card>
</CardGroup>