Zahlungsmethoden im asiatisch-pazifischen Raum

Ermöglichen Sie Kunden auf den Philippinen, in Hongkong und Malaysia, mit der Wallet oder Banküberweisung zu bezahlen, die sie täglich verwenden. Dodo Payments unterstützt GCash (Philippinen), Alipay HK und FPS (Hongkong) sowie Touch ‘n Go (Malaysia) für einmalige Zahlungen. Jede Zahlungsmethode wird in ihrer lokalen Währung abgerechnet, und der Kunde bezahlt durch Scannen eines beim Checkout angezeigten QR-Codes.

Diese Seite behandelt die Philippinen, Hongkong und Malaysia. Für andere asiatische Märkte finden Sie unter Indien Informationen zu UPI und Rupay, unter Südkorea Informationen zu Kakao Pay, Naver Pay und PAYCO sowie unter WeChat Pay Informationen zu chinesischen Kundinnen und Kunden.

Warum Wallets im asiatisch-pazifischen Raum wichtig sind

Wallet-First Markets

GCash ist die beliebteste digitale Wallet auf den Philippinen, und Touch ‘n Go ist die größte E-Wallet in Malaysia.

Low Card Penetration

Die Nutzung von Kreditkarten ist auf den Philippinen im Vergleich zu Märkten mit vorrangiger Kartennutzung gering. Lokale Wallets und Banküberweisungen erreichen Kunden, die ein reiner Karten-Checkout nicht erreicht.

Instant Settlement

FPS ist in Hongkong rund um die Uhr verfügbar, und Gelder erreichen den Zahlungsempfänger nahezu sofort. Dadurch kann der Checkout die Zahlung bestätigen, während der Kunde wartet.

Unterstützte Methoden

Die Tabelle enthält für jede Zahlungsmethode den Markt, die Abrechnungswährung und den Mindestbetrag. Der Mindestbetrag ist der Checkout-Mindestbetrag für diese Währung und gilt daher für jede Zahlungsmethode bei einem Checkout in dieser Währung.

Zahlungsmethode	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

Alle vier Zahlungsmethoden sind ausschließlich für einmalige Zahlungen verfügbar. Keine von ihnen erscheint bei Subscription-Checkouts oder unterstützt andere wiederkehrende Zahlungen. Fügen Sie credit und debit bei Subscription-Checkouts hinzu, damit sich Kunden in diesen Märkten weiterhin anmelden können.

Kunden bezahlen in ihrer lokalen Währung. Zahlungen mit diesen vier Zahlungsmethoden werden in Ihrer USD-Wallet abgerechnet. Kartenzahlungen beim selben Checkout werden ebenfalls in USD abgerechnet.

Details zu den Zahlungsmethoden

GCash (Philippines)

GCash ist die beliebteste E-Wallet auf den Philippinen. Beim Checkout wählt der Kunde GCash, klickt auf Pay und scannt den QR-Code mit der GCash-App, um die Zahlung zu bestätigen.Verfügbar bei einmaligen Checkouts, die den Philippinen (PH) in PHP zugeordnet sind.

Alipay HK (Hong Kong)

Alipay HK ist die Hongkong-Variante von Alipay. Sie richtet sich an den lokalen Markt und wird in Hongkong-Dollar abgerechnet. Sie ist eine separate Zahlungsmethode vom Alipay-Produkt für Festlandchina. Beim Checkout wird sie als AlipayHK bezeichnet.Verfügbar bei einmaligen Checkouts, die Hongkong (HK) in HKD zugeordnet sind. Alipay HK wird ausschließlich in HKD abgerechnet und erscheint daher nicht bei einem CNY-Checkout, selbst wenn das Abrechnungsland Hongkong ist.

FPS (Hong Kong)

FPS (Faster Payment System) ist das Echtzeit-Zahlungssystem Hongkongs, das von der Hong Kong Monetary Authority eingeführt wurde. Es verbindet Banken und E-Wallets, ist rund um die Uhr verfügbar und unterstützt Hongkong-Dollar sowie chinesische Yuan. Der Kunde scannt den QR-Code mit einer Banking- oder E-Wallet-App, und die Gelder treffen nahezu sofort ein.Verfügbar bei einmaligen Checkouts, die Hongkong (HK) entweder in HKD oder CNY zugeordnet sind.

Touch 'n Go (Malaysia)

Touch ‘n Go ist die größte E-Wallet in Malaysia. Der Kunde scannt den QR-Code mit der Touch ‘n Go-App und bestätigt die Zahlung dort.Verfügbar bei einmaligen Checkouts, die Malaysia (MY) in MYR zugeordnet sind.

Konfiguration

API-Methodentypen

Übergeben Sie diese Werte in allowed_payment_method_types:

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 auf den Philippinen

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 in Hongkong

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

Voraussetzungen

Eine Zahlungsmethode erscheint beim Checkout nur, wenn alle folgenden Bedingungen erfüllt sind:

Das Abrechnungsland entspricht dem Markt der Zahlungsmethode: PH für GCash, HK für Alipay HK und FPS sowie MY für Touch ‘n Go.
Die Abrechnungswährung entspricht der Zahlungsmethode: PHP, HKD (oder CNY für FPS) oder MYR.
Beim Checkout handelt es sich um eine einmalige Zahlung, nicht um ein Abonnement.
Adaptive Currency ist aktiviert. Andernfalls wird billing_currency ignoriert, und der Checkout kann nicht in PHP, HKD, CNY oder MYR abrechnen.

Wenn Adaptive Currency deaktiviert ist, werden Kunden in diesen Märkten nicht in ihrer lokalen Währung abgerechnet, und keine dieser Zahlungsmethoden erscheint.

Testen

Enable test mode

Deaktivieren Sie den Schalter Live Mode in der Seitenleiste des Dashboards und verwenden Sie im Testmodus erstellte API-Schlüssel.

Set the billing country and currency

Erstellen Sie einen einmaligen Checkout mit dem Abrechnungsland und der Abrechnungswährung der zu testenden Zahlungsmethode:

Zahlungsmethode	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 Zahlungsmethoden werden bei Subscription-Checkouts nicht angeboten.

Select the method and confirm

Wählen Sie die Zahlungsmethode beim Checkout aus und klicken Sie auf Pay. Ein QR-Code wird in einer Vollbild-Overlay mit einem 10-minütigen Countdown geöffnet. Während das Overlay geöffnet ist, prüft der Checkout den Zahlungsstatus.

Verify the checkout behavior

Bestätigen Sie, dass die Zahlungsmethode nur für das passende Land und die passende Währung erscheint und dass der QR-Code angezeigt wird.

QR-Codes im Testmodus stammen aus der Testumgebung des Wallet-Anbieters und können sich anders verhalten als bei einer Live-Zahlung.

Best Practices

Lead with the local wallet

Auf den Philippinen und in Malaysia erwarten viele Kunden, mit einer lokalen Wallet zu bezahlen. Platzieren Sie bei Checkouts für diese Märkte GCash oder Touch ‘n Go neben den Karten.

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 jeder Kunde seine bevorzugte Zahlungsmethode sieht.

Keep cards on subscription checkouts

Jede Zahlungsmethode auf dieser Seite ist ausschließlich für einmalige Zahlungen verfügbar. Ein Subscription-Checkout, der nur lokale Wallets auflistet, hat daher keine anzuzeigende Zahlungsmethode. Fügen Sie credit und debit für wiederkehrende Pläne hinzu.

Match currency to region

Diese Zahlungsmethoden erfordern ihre lokale Abrechnungswährung. Wenn Ihr Katalog in USD oder EUR bepreist ist, aktivieren Sie Adaptive Currency, damit Kunden Preise in PHP, HKD, CNY oder MYR angezeigt und berechnet werden.

Fehlerbehebung

Method not appearing at checkout

Prüfen Sie:

Ist das Abrechnungsland PH, HK oder MY und stimmt es mit der Zahlungsmethode überein?
Ist die Abrechnungswährung PHP, HKD, CNY oder MYR und stimmt sie mit der Zahlungsmethode überein?
Handelt es sich um eine einmalige Zahlung? Keine dieser Zahlungsmethoden erscheint bei Abonnements.
Ist die Zahlungsmethode (gcash, ali_pay_hk, fps oder touch_n_go) in allowed_payment_method_types enthalten?
Ist Adaptive Currency aktiviert?
Erfüllt der Betrag den Währungsmindestbetrag unter Unterstützte Zahlungsmethoden?

Lösung: Entfernen Sie allowed_payment_method_types vorübergehend, um jede geeignete Zahlungsmethode anzuzeigen, und ermitteln Sie anschließend, welche Bedingung nicht erfüllt ist.

Alipay HK missing on a CNY checkout

Ursache: Alipay HK wird ausschließlich in HKD abgerechnet. Ein Checkout, der Hongkong in CNY zugeordnet ist, 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.

Wallet missing on a subscription

Ursache: GCash, Alipay HK, FPS und Touch ‘n Go sind ausschließlich für einmalige Zahlungen verfügbar und werden nicht für wiederkehrende Abrechnungen angeboten.Lösung: Verwenden Sie credit und debit für Abonnements in diesen Märkten.

Payment not confirming

Ursache: Der Kunde muss den QR-Code scannen und die Zahlung in einer Wallet- oder Banking-App bestätigen. Wenn der Kunde die App vor der Bestätigung schließt, bleibt die Zahlung unvollständig.Lösung: Verwenden Sie Webhooks für den finalen Zahlungsstatus statt der Weiterleitung nach der Rückkehr. Siehe den Webhooks-Leitfaden.

Payment Methods Overview

Alle unterstützten Zahlungsmethoden anzeigen.

Adaptive Currency

Kunden in ihrer lokalen Währung abrechnen, einschließlich PHP, HKD, CNY und MYR.

Checkout Guide

Vollständiger Leitfaden zur Checkout-Implementierung.

Testing Process

Testdaten und Anleitung zum Testen des Checkouts.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Zahlungsmethoden im asiatisch-pazifischen Raum

Warum Wallets im asiatisch-pazifischen Raum wichtig sind

Wallet-First Markets

Low Card Penetration

Instant Settlement

Unterstützte Methoden

Details zu den Zahlungsmethoden

Konfiguration

API-Methodentypen

Beispiel: Checkout auf den Philippinen

Beispiel: Checkout in Hongkong

Beispiel: Checkout in Malaysia

Voraussetzungen

Testen

Best Practices

Fehlerbehebung

Verwandte Seiten

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

​Warum Wallets im asiatisch-pazifischen Raum wichtig sind

Wallet-First Markets

Low Card Penetration

Instant Settlement

​Unterstützte Methoden

​Details zu den Zahlungsmethoden

​Konfiguration

​API-Methodentypen

​Beispiel: Checkout auf den Philippinen

​Beispiel: Checkout in Hongkong

​Beispiel: Checkout in Malaysia

​Voraussetzungen

​Testen

​Best Practices

​Fehlerbehebung

​Verwandte Seiten

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

Warum Wallets im asiatisch-pazifischen Raum wichtig sind

Unterstützte Methoden

Details zu den Zahlungsmethoden

Konfiguration

API-Methodentypen

Beispiel: Checkout auf den Philippinen

Beispiel: Checkout in Hongkong

Beispiel: Checkout in Malaysia

Voraussetzungen

Testen

Best Practices

Fehlerbehebung

Verwandte Seiten