> ## 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 untuk pembayaran satu kali, yang ditagihkan dalam mata uang lokal setiap pasar.

Biarkan pelanggan di Filipina, Hong Kong, dan Malaysia membayar dengan wallet atau transfer bank yang mereka gunakan setiap hari. Dodo Payments mendukung **GCash** (Filipina), **Alipay HK** dan **FPS** (Hong Kong), serta **Touch 'n Go** (Malaysia) untuk pembayaran satu kali. Setiap metode ditagihkan dalam mata uang lokalnya, dan pelanggan membayar dengan memindai kode QR yang ditampilkan saat checkout.

<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 adalah digital wallet paling populer di Filipina, dan Touch 'n Go adalah e-wallet terbesar di Malaysia.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    Penggunaan kartu kredit di Filipina rendah dibandingkan dengan pasar yang mengutamakan kartu. Wallet lokal dan transfer bank menjangkau pelanggan yang terlewatkan oleh checkout khusus kartu.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS beroperasi 24 jam sehari di Hong Kong, dan dana sampai ke penerima hampir seketika, sehingga checkout dapat mengonfirmasi pembayaran saat pelanggan menunggu.
  </Card>
</CardGroup>

## Metode yang Didukung

Tabel ini mencantumkan pasar, mata uang penagihan, dan jumlah minimum untuk setiap metode. Jumlah minimum adalah minimum checkout untuk mata uang tersebut, sehingga berlaku untuk setiap metode pembayaran pada checkout dalam mata uang itu.

| Metode | Negara | Mata Uang Penagihan | Subscriptions | 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 hanya dapat digunakan untuk pembayaran satu kali.** Tidak ada yang muncul pada subscription checkout atau mendukung recurring charge lainnya. Sertakan `credit` dan `debit` pada subscription checkout agar pelanggan di pasar ini tetap dapat mendaftar.
</Warning>

<Info>
  Pelanggan membayar dalam mata uang lokal mereka. Pembayaran yang dilakukan dengan keempat metode ini diselesaikan ke wallet **USD** Anda. Pembayaran kartu pada checkout yang sama juga diselesaikan dalam USD.
</Info>

### Detail Metode

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash adalah e-wallet paling populer di Filipina. Saat checkout, pelanggan memilih **GCash**, mengeklik **Pay**, lalu memindai kode QR dengan aplikasi GCash untuk menyetujui pembayaran.

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

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK adalah edisi Alipay untuk Hong Kong. Metode ini melayani pasar lokal dan diselesaikan dalam dolar Hong Kong. Metode ini berbeda dari produk Alipay untuk Tiongkok daratan. Checkout menampilkannya sebagai **AlipayHK**.

    Ditawarkan 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 sistem pembayaran real-time Hong Kong yang diluncurkan oleh Hong Kong Monetary Authority. Sistem ini menghubungkan bank dan e-wallet, beroperasi 24 jam sehari, serta mendukung dolar Hong Kong dan yuan Tiongkok. Pelanggan memindai kode QR dengan aplikasi perbankan atau e-wallet, dan dana sampai hampir seketika.

    Ditawarkan 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 terbesar di Malaysia. Pelanggan memindai kode QR dengan aplikasi Touch 'n Go dan mengonfirmasi pembayaran di sana.

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

## Konfigurasi

### Jenis Metode API

Teruskan nilai-nilai ini dalam `allowed_payment_method_types`:

| Jenis | Deskripsi |
| :- | :- |
| `gcash` | Wallet GCash (Filipina) |
| `ali_pay_hk` | Wallet Alipay HK (Hong Kong) |
| `fps` | Transfer bank real-time FPS (Hong Kong) |
| `touch_n_go` | 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

Sebuah metode hanya muncul saat checkout jika semua kondisi berikut terpenuhi:

1. **Negara penagihan** cocok dengan pasar metode tersebut: `PH` untuk GCash, `HK` untuk Alipay HK dan FPS, serta `MY` untuk Touch 'n Go.
2. **Mata uang penagihan** cocok dengan metode tersebut: PHP, HKD (atau CNY untuk FPS), atau MYR.
3. Checkout adalah **pembayaran satu kali**, bukan subscription.
4. **[Adaptive Currency](/features/adaptive-currency)** diaktifkan. Tanpanya, `billing_currency` diabaikan, dan checkout tidak dapat menagih dalam PHP, HKD, CNY, atau MYR.

<Warning>
  Jika Adaptive Currency dinonaktifkan, pelanggan di pasar ini tidak ditagihkan dalam mata uang lokal mereka, dan tidak satu pun dari metode ini muncul.
</Warning>

## Pengujian

<Steps>
  <Step title="Enable test mode">
    Nonaktifkan tombol **Live Mode** di sidebar dashboard, lalu gunakan API keys yang dibuat dalam test mode.
  </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 dalam `allowed_payment_method_types`. Metode ini tidak ditawarkan pada subscription checkout.
  </Step>

  <Step title="Select the method and confirm">
    Pilih metode pembayaran saat checkout dan klik **Pay**. Kode QR terbuka dalam overlay layar penuh dengan hitung mundur 10 menit, dan checkout memeriksa status pembayaran selama overlay terbuka.
  </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 test mode berasal dari lingkungan pengujian penyedia wallet dan mungkin berperilaku berbeda dari pembayaran live.
</Note>

## Praktik Terbaik

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    Di Filipina dan Malaysia, banyak pelanggan mengharapkan pembayaran dengan wallet lokal. Tampilkan GCash atau Touch 'n Go di sebelah kartu pada checkout untuk pasar-pasar ini.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK dan FPS melayani pelanggan yang berbeda: pengguna wallet dan pengguna transfer bank. Sertakan keduanya pada checkout HKD agar setiap pelanggan melihat metode yang mereka pilih.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Setiap metode di halaman ini hanya dapat digunakan untuk pembayaran satu kali, sehingga subscription checkout yang hanya mencantumkan wallet lokal tidak memiliki metode untuk ditampilkan. Sertakan `credit` dan `debit` untuk recurring plan.
  </Accordion>

  <Accordion title="Match currency to region">
    Metode ini memerlukan mata uang penagihan lokalnya. Jika katalog Anda menggunakan 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 adalah `PH`, `HK`, atau `MY`, sesuai dengan metodenya?
    2. Apakah mata uang penagihan adalah PHP, HKD, CNY, atau MYR, sesuai dengan metodenya?
    3. Apakah ini pembayaran satu kali? Tidak satu pun metode ini muncul pada subscription.
    4. Apakah metode (`gcash`, `ali_pay_hk`, `fps`, atau `touch_n_go`) disertakan dalam `allowed_payment_method_types`?
    5. Apakah Adaptive Currency diaktifkan?
    6. Apakah jumlahnya memenuhi minimum mata uang di [Metode yang Didukung](#supported-methods)?

    **Solusi:** Hapus `allowed_payment_method_types` untuk sementara agar semua metode yang memenuhi syarat terlihat, lalu cari kondisi yang tidak terpenuhi.
  </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 hanya dapat digunakan untuk pembayaran satu kali dan tidak ditawarkan untuk recurring billing.

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

  <Accordion title="Payment not confirming">
    **Penyebab:** Pelanggan harus memindai kode QR dan menyetujui pembayaran di aplikasi wallet atau perbankan. Jika pelanggan menutup aplikasi sebelum menyetujui pembayaran, pembayaran tetap berstatus belum selesai.

    **Solusi:** Gunakan webhooks untuk status pembayaran final, bukan return redirect. 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">
    Tagihkan 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.