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

# Zahlungsmethoden im asiatisch-pazifischen Raum

> Akzeptieren Sie GCash auf den Philippinen, Alipay HK und FPS in Hongkong sowie Touch 'n Go in Malaysia. Erfahren Sie mehr über Währungsanforderungen, Unterstützung für Einmalzahlungen und Konfiguration.

Kundinnen und Kunden im asiatisch-pazifischen Raum bezahlen beim Checkout deutlich häufiger mit lokalen E-Wallets und Echtzeit-Banküberweisungen als mit internationalen Karten. Dodo Payments unterstützt **GCash** (Philippinen), **Alipay HK** und **FPS** (Hongkong) sowie **Touch 'n Go** (Malaysia), jeweils mit Abrechnung in der lokalen Währung.

<Note>
  Diese Seite behandelt die Philippinen, Hongkong und Malaysia. Für andere asiatische Märkte finden Sie unter [Indien](/features/payment-methods/india) Informationen zu UPI und Rupay, unter [Südkorea](/features/payment-methods/south-korea) Informationen zu Kakao Pay, Naver Pay und PAYCO sowie unter [WeChat Pay](/features/payment-methods/wechat) Informationen zu chinesischen Kundinnen und Kunden.
</Note>

## Warum Wallets im asiatisch-pazifischen Raum wichtig sind

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash und Touch 'n Go sind auf den Philippinen und in Malaysia die bevorzugte Zahlungsmethode im Internet und liegen deutlich vor der Karteneingabe.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    Der Kartenbesitz ist in weiten Teilen der Region begrenzt. Lokale Wallets und Banknetzwerke erreichen Kundinnen und Kunden, die bei einem ausschließlich kartenbasierten Checkout nicht erreicht werden.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS wickelt in Hongkong Bank-zu-Bank-Überweisungen in Echtzeit ab, sodass Zahlungen während des Checkouts und nicht erst Stunden später bestätigt werden.
  </Card>
</CardGroup>

## Unterstützte Methoden

| Methode         | Land        | Abrechnungswährung | Abonnements | Mindestbetrag       |
| :-------------- | :---------- | :----------------- | :---------: | :------------------ |
| **GCash**       | Philippinen | PHP                |     Nein    | 50.00 PHP           |
| **Alipay HK**   | Hongkong    | HKD                |     Nein    | 4.00 HKD            |
| **FPS**         | Hongkong    | HKD, CNY           |     Nein    | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | Malaysia    | MYR                |     Nein    | 4.00 MYR            |

<Warning>
  **Alle vier Methoden sind ausschließlich für Einmalzahlungen verfügbar.** Keine von ihnen unterstützt Abonnements oder andere wiederkehrende Gebühren. Fügen Sie bei Abonnement-Checkouts immer `credit` und `debit` hinzu, damit sich Kundinnen und Kunden in diesen Märkten weiterhin anmelden können.
</Warning>

<Info>
  Kundinnen und Kunden zahlen in ihrer lokalen Währung, und Sie erhalten die Auszahlung in **USD**, wie bei jeder anderen Nicht-USD-Methode.
</Info>

### Methodendetails

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash ist das größte E-Wallet der Philippinen und wird für alles verwendet – von Rechnungen bis zum Online-Shopping. Kundinnen und Kunden genehmigen die Zahlung in der GCash-App und werden zu Ihrer Erfolgsseite zurückgeleitet.

    Verfügbar bei **Einmalzahlungen**, die den **Philippinen (`PH`)** in **PHP** zugeordnet sind.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK ist die Hongkong-Variante von Alipay, die für den lokalen Markt betrieben wird und in Hongkong-Dollar abrechnet. Es handelt sich um eine separate Methode vom Alipay-Produkt für Festlandchina.

    Verfügbar bei **Einmalzahlungen**, die **Hongkong (`HK`)** in **HKD** zugeordnet sind. Alipay HK rechnet ausschließlich in HKD ab und erscheint daher auch dann nicht bei einem CNY-Checkout, wenn das Abrechnungsland Hongkong ist.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS (Faster Payment System) ist das Echtzeit-Überweisungsnetzwerk für Interbank-Überweisungen in Hongkong und wird von der Hong Kong Monetary Authority betrieben. Kundinnen und Kunden zahlen direkt von ihrem Bankkonto, und die Überweisung wird sofort abgewickelt.

    Verfügbar bei **Einmalzahlungen**, die **Hongkong (`HK`)** in **HKD** oder **CNY** zugeordnet sind.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go ist das führende E-Wallet Malaysias. Kundinnen und Kunden bestätigen die Zahlung in der Touch 'n Go-App und kehren zu Ihrer Erfolgsseite zurück.

    Verfügbar bei **Einmalzahlungen**, die **Malaysia (`MY`)** in **MYR** zugeordnet sind.
  </Accordion>
</AccordionGroup>

## Konfiguration

### API-Methodentypen

| Typ          | Beschreibung                       |
| :----------- | :--------------------------------- |
| `gcash`      | GCash-Wallet (Philippinen)         |
| `ali_pay_hk` | Alipay-HK-Wallet (Hongkong)        |
| `fps`        | FPS-Echtzeitüberweisung (Hongkong) |
| `touch_n_go` | Touch-'n-Go-Wallet (Malaysia)      |

### Beispiel: Checkout für die Philippinen

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

### Beispiel: Checkout für Hongkong

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

### Beispiel: Checkout für 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'
});
```

### Anforderungen

Damit diese Methoden beim Checkout angezeigt werden:

1. **Abrechnungsland** entspricht dem Markt der Methode – `PH` für GCash, `HK` für Alipay HK und FPS sowie `MY` für Touch 'n Go
2. **Währung** entspricht der Methode – PHP, HKD (oder CNY für FPS) oder MYR
3. **Zahlungstyp** ist eine Einmalzahlung, kein Abonnement
4. Für Händler, die in einer anderen Währung abrechnen: **[Adaptive Currency](/features/adaptive-currency)** muss aktiviert sein, damit Kundinnen und Kunden in der lokalen Währung belastet werden

<Warning>
  Wenn Sie in einer anderen Währung abrechnen und Adaptive Currency nicht aktiviert ist, werden Kundinnen und Kunden in diesen Märkten nicht in der lokalen Währung belastet, und keine dieser Methoden ist verfügbar.
</Warning>

## Testen

<Steps>
  <Step title="Enable test mode">
    Verwenden Sie Ihre Dodo Payments-Test-API-Schlüssel.
  </Step>

  <Step title="Set the billing country and currency">
    Erstellen Sie einen Checkout für eine Einmalzahlung mit dem Abrechnungsland und der Abrechnungswährung der Methode, die Sie testen:

    | Methode     | Abrechnungsland | Abrechnungswährung |
    | :---------- | :-------------- | :----------------- |
    | GCash       | `PH`            | `PHP`              |
    | Alipay HK   | `HK`            | `HKD`              |
    | FPS         | `HK`            | `HKD` oder `CNY`   |
    | Touch 'n Go | `MY`            | `MYR`              |

    Fügen Sie den Methodentyp in `allowed_payment_method_types` ein. Diese Methoden werden bei Abonnement-Checkouts nicht angeboten.
  </Step>

  <Step title="Select the method and confirm">
    Wählen Sie die Zahlungsmethode beim Checkout aus und klicken Sie auf **Bezahlen**. Ein QR-Code wird in einer Vollbildüberlagerung geöffnet, und der Checkout wartet auf die Zahlung.
  </Step>

  <Step title="Verify the checkout behavior">
    Bestätigen Sie, dass die Methode nur für das passende Land und die passende Währung angezeigt wird und dass der QR-Code gerendert wird.
  </Step>
</Steps>

<Note>
  QR-Codes im Testmodus werden von der Testumgebung des Wallet-Anbieters ausgestellt und können sich anders verhalten als eine Live-Zahlung.
</Note>

## Best Practices

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    Auf den Philippinen und in Malaysia ist das lokale Wallet die wichtigste Zahlungsmethode, die Kundinnen und Kunden erwarten. Wenn Sie GCash oder Touch 'n Go neben Karten anbieten, verringert sich die Abbruchrate deutlich.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK und FPS bedienen unterschiedliche Kundengruppen – Wallet-Nutzer und Nutzer von Banküberweisungen. Bieten Sie beide bei HKD-Checkouts an, damit Dodo Payments die bevorzugte Methode der Kundinnen und Kunden anzeigen kann.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Da jede Methode auf dieser Seite ausschließlich für Einmalzahlungen verfügbar ist, gibt es bei einem Abonnement-Checkout, der nur lokale Wallets aufführt, nichts anzuzeigen. Fügen Sie bei wiederkehrenden Plänen immer `credit` und `debit` hinzu.
  </Accordion>

  <Accordion title="Match currency to region">
    Diese Methoden erfordern ihre lokale Abrechnungswährung. Wenn Ihr Katalog in USD oder EUR bepreist ist, aktivieren Sie Adaptive Currency, damit Kundinnen und Kunden Preise in PHP, HKD, CNY oder MYR angezeigt bekommen und in dieser Währung belastet werden.
  </Accordion>
</AccordionGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **Prüfen Sie:**

    1. Ist das Abrechnungsland auf `PH`, `HK` oder `MY` gesetzt, passend zur Methode?
    2. Ist die Abrechnungswährung passend zur Methode auf PHP, HKD, CNY oder MYR gesetzt?
    3. Handelt es sich um eine Einmalzahlung? Keine dieser Methoden wird bei Abonnements angezeigt.
    4. Ist die Methode (`gcash`, `ali_pay_hk`, `fps` oder `touch_n_go`) in `allowed_payment_method_types` enthalten?
    5. Bei einer Preisangabe in einer anderen Währung: Ist Adaptive Currency aktiviert?

    **Lösung:** Entfernen Sie `allowed_payment_method_types` vorübergehend, um jede geeignete Methode anzuzeigen. Grenzen Sie anschließend ein, welche Bedingung nicht erfüllt ist.
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **Ursache:** Alipay HK rechnet ausschließlich in HKD ab. Ein Checkout, der Hongkong in CNY belastet, bietet FPS, aber niemals Alipay HK an.

    **Lösung:** Rechnen Sie in HKD ab, um Alipay HK anzubieten, oder fügen Sie `fps` für CNY-Checkouts in Hongkong hinzu.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **Ursache:** GCash, Alipay HK, FPS und Touch 'n Go sind ausschließlich für Einmalzahlungen verfügbar und werden niemals für wiederkehrende Abrechnungen angeboten.

    **Lösung:** Verwenden Sie `credit` und `debit` für Abonnements in diesen Märkten.
  </Accordion>

  <Accordion title="Payment not confirming">
    **Ursache:** Diese Methoden leiten Kundinnen und Kunden zu einer Wallet- oder Banking-App weiter. Wenn die App geschlossen wird, bleibt die Zahlung unvollständig.

    **Lösung:** Überwachen Sie Webhooks auf den endgültigen Zahlungsstatus, anstatt sich auf die Rückleitungs-Weiterleitung zu verlassen. Siehe den [Webhooks-Leitfaden](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

## Verwandte Seiten

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Alle unterstützten Zahlungsmethoden anzeigen.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Kundinnen und Kunden in ihrer lokalen Währung belasten, einschließlich PHP, HKD, CNY und MYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Vollständiger Leitfaden zur Checkout-Implementierung.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Testdaten und Anleitung zum Testen des Checkouts.
  </Card>
</CardGroup>