아시아 태평양 결제 수단

아시아 태평양 지역의 쇼핑객은 국제 카드보다 현지 e-wallet 및 실시간 bank transfer를 훨씬 더 자주 사용하여 결제합니다. Dodo Payments는 GCash(필리핀), Alipay HK 및 FPS(홍콩), Touch ‘n Go(말레이시아)를 지원하며, 각 결제 수단은 해당 지역의 현지 통화로 청구됩니다.

이 페이지에서는 필리핀, 홍콩 및 말레이시아를 다룹니다. 다른 아시아 시장에 대해서는 UPI 및 Rupay를 지원하는 인도, Kakao Pay, Naver Pay 및 PAYCO를 지원하는 대한민국, 중국 고객을 위한 WeChat Pay를 참조하세요.

아시아 태평양 wallet이 중요한 이유

Wallet-First Markets

GCash와 Touch ‘n Go는 필리핀과 말레이시아에서 온라인 결제 시 기본 결제 수단이며, 카드 정보를 직접 입력하는 방식보다 훨씬 앞서 있습니다.

Low Card Penetration

이 지역 대부분에서는 카드 보유율이 제한적입니다. 현지 wallet과 bank rail을 사용하면 카드만 지원하는 checkout으로는 도달하기 어려운 고객에게도 접근할 수 있습니다.

Instant Settlement

FPS는 홍콩에서 은행 간 거래를 실시간으로 처리하므로 결제가 몇 시간 후가 아니라 checkout 중에 확인됩니다.

지원되는 결제 수단

결제 수단	국가	청구 통화	구독	최소 금액
GCash	필리핀	PHP	아니요	50.00 PHP
Alipay HK	홍콩	HKD	아니요	4.00 HKD
FPS	홍콩	HKD, CNY	아니요	4.00 HKD / 4.00 CNY
Touch ‘n Go	말레이시아	MYR	아니요	4.00 MYR

네 가지 결제 수단 모두 일회성 결제만 지원합니다. 어느 결제 수단도 구독 또는 기타 recurring charge를 지원하지 않습니다. 이러한 시장의 고객이 계속 가입할 수 있도록 구독 checkout에는 항상 credit 및 debit를 포함하세요.

고객은 현지 통화로 결제하고, 다른 모든 non-USD 결제 수단과 마찬가지로 귀하는 USD로 settlement를 받습니다.

결제 수단 세부 정보

GCash (Philippines)

GCash는 필리핀 최대의 e-wallet으로, 공과금 납부부터 온라인 쇼핑까지 다양한 용도로 사용됩니다. 고객은 GCash 앱에서 결제를 승인한 후 귀사의 success page로 돌아옵니다.**필리핀 (PH)**으로 청구되며 PHP로 결제되는 일회성 checkout에서 제공됩니다.

Alipay HK (Hong Kong)

Alipay HK는 홍콩 현지 시장을 대상으로 운영되며 홍콩 달러로 settlement되는 Alipay의 홍콩 버전입니다. 중국 본토의 Alipay product와는 별도의 결제 수단입니다.**홍콩 (HK)**으로 청구되며 HKD로 결제되는 일회성 checkout에서 제공됩니다. Alipay HK는 HKD로만 settlement되므로 청구 국가가 홍콩이어도 CNY checkout에는 표시되지 않습니다.

FPS (Hong Kong)

FPS(Faster Payment System)는 홍콩 금융관리국이 운영하는 홍콩의 실시간 은행 간 transfer network입니다. 고객은 은행 계좌에서 직접 결제하며 transfer가 즉시 처리됩니다.HKD 또는 CNY로 결제되며 **홍콩 (HK)**으로 청구되는 일회성 checkout에서 제공됩니다.

Touch 'n Go (Malaysia)

Touch ‘n Go는 말레이시아의 대표적인 e-wallet입니다. 고객은 Touch ‘n Go 앱에서 결제를 확인한 후 귀사의 success page로 돌아옵니다.**말레이시아 (MY)**으로 청구되며 MYR로 결제되는 일회성 checkout에서 제공됩니다.

구성

API Method Types

유형	설명
`gcash`	GCash wallet (필리핀)
`ali_pay_hk`	Alipay HK wallet (홍콩)
`fps`	FPS 실시간 bank transfer (홍콩)
`touch_n_go`	Touch ‘n Go wallet (말레이시아)

예시: 필리핀 Checkout

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

예시: 홍콩 Checkout

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

예시: 말레이시아 Checkout

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

요구 사항

checkout에 이러한 결제 수단이 표시되려면 다음 조건을 충족해야 합니다:

청구 국가가 결제 수단의 시장과 일치해야 합니다 — GCash는 PH, Alipay HK 및 FPS는 HK, Touch ‘n Go는 MY
통화가 결제 수단과 일치해야 합니다 — PHP, HKD(FPS의 경우 CNY도 가능) 또는 MYR
결제 유형이 구독이 아닌 일회성 결제여야 합니다
다른 통화로 가격을 책정하는 merchant의 경우: 고객에게 현지 통화로 청구되도록 **Adaptive Currency**를 활성화해야 합니다

다른 통화로 가격을 책정하면서 Adaptive Currency를 활성화하지 않으면 해당 시장의 고객에게 현지 통화로 청구되지 않으며 이러한 결제 수단은 사용할 수 없습니다.

테스트

Enable test mode

Dodo Payments test API keys를 사용하세요.

Set the billing country and currency

테스트할 결제 수단에 맞는 청구 주소 국가와 청구 통화를 사용하여 일회성 checkout을 생성하세요:

결제 수단	청구 국가	청구 통화
GCash	`PH`	`PHP`
Alipay HK	`HK`	`HKD`
FPS	`HK`	`HKD` 또는 `CNY`
Touch ‘n Go	`MY`	`MYR`

allowed_payment_method_types에 결제 수단 유형을 포함하세요. 이러한 결제 수단은 구독 checkout에서 제공되지 않습니다.

Select the method and confirm

checkout에서 결제 수단을 선택하고 Pay를 클릭하세요. QR code가 전체 화면 overlay로 열리고 checkout은 결제를 기다립니다.

Verify the checkout behavior

결제 수단이 일치하는 국가와 통화에서만 표시되고 QR code가 정상적으로 렌더링되는지 확인하세요.

test-mode QR code는 wallet provider의 test environment에서 발급되며 live payment와 다르게 작동할 수 있습니다.

모범 사례

Lead with the local wallet

필리핀과 말레이시아에서는 고객이 현지 wallet을 주요 결제 수단으로 기대합니다. 카드와 함께 GCash 또는 Touch ‘n Go를 제공하면 checkout 이탈을 크게 줄일 수 있습니다.

Offer both Hong Kong methods

Alipay HK와 FPS는 서로 다른 고객, 즉 wallet 사용자와 bank-transfer 사용자를 대상으로 합니다. HKD checkout에는 두 결제 수단을 모두 포함하여 Dodo Payments가 고객이 선호하는 결제 수단을 제시할 수 있도록 하세요.

Keep cards on subscription checkouts

이 페이지의 모든 결제 수단은 일회성 결제만 지원하므로 현지 wallet만 표시하는 구독 checkout에는 표시할 결제 수단이 없습니다. recurring plan에는 항상 credit 및 debit를 포함하세요.

Match currency to region

이러한 결제 수단은 현지 청구 통화를 필요로 합니다. catalog의 가격이 USD 또는 EUR로 책정되어 있다면 Adaptive Currency를 활성화하여 고객에게 PHP, HKD, CNY 또는 MYR로 견적을 제시하고 청구하세요.

문제 해결

Method not appearing at checkout

확인 사항:

결제 수단에 맞게 청구 국가가 PH, HK 또는 MY로 설정되어 있나요?
결제 수단에 맞게 청구 통화가 PHP, HKD, CNY 또는 MYR로 설정되어 있나요?
일회성 결제인가요? 이러한 결제 수단은 구독에 표시되지 않습니다.
결제 수단( gcash, ali_pay_hk, fps 또는 touch_n_go)이 allowed_payment_method_types에 포함되어 있나요?
다른 통화로 가격이 책정된 경우: Adaptive Currency가 활성화되어 있나요?

해결 방법: allowed_payment_method_types를 일시적으로 제거하여 자격이 있는 모든 결제 수단을 확인한 다음, 어떤 조건이 충족되지 않는지 범위를 좁혀 확인하세요.

Alipay HK missing on a CNY checkout

원인: Alipay HK는 HKD로만 settlement됩니다. CNY로 홍콩에 청구되는 checkout에서는 FPS가 제공되지만 Alipay HK는 제공되지 않습니다.해결 방법: Alipay HK를 제공하려면 HKD로 청구하거나, 홍콩의 CNY checkout에 fps를 포함하세요.

Wallet missing on a subscription

원인: GCash, Alipay HK, FPS 및 Touch ‘n Go는 모두 일회성 결제만 지원하며 recurring billing에는 절대 제공되지 않습니다.해결 방법: 해당 시장의 구독에는 credit 및 debit를 사용하세요.

Payment not confirming

원인: 이러한 결제 수단은 고객을 wallet app 또는 banking app으로 redirect합니다. 고객이 app을 종료하면 결제는 incomplete 상태로 남습니다.해결 방법: return redirect에 의존하지 말고 최종 payment status를 webhooks로 모니터링하세요. Webhooks 가이드를 참조하세요.

Payment Methods Overview

지원되는 모든 결제 수단을 확인하세요.

Adaptive Currency

PHP, HKD, CNY 및 MYR를 포함한 현지 통화로 고객에게 청구하세요.

Checkout Guide

완전한 checkout 구현 가이드입니다.

Testing Process

테스트 데이터 및 checkout 테스트 가이드입니다.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

아시아 태평양 wallet이 중요한 이유

Wallet-First Markets

Low Card Penetration

Instant Settlement

지원되는 결제 수단

결제 수단 세부 정보

구성

API Method Types

예시: 필리핀 Checkout

예시: 홍콩 Checkout

예시: 말레이시아 Checkout

요구 사항

테스트

모범 사례

문제 해결

관련 페이지

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

​아시아 태평양 wallet이 중요한 이유

Wallet-First Markets

Low Card Penetration

Instant Settlement

​지원되는 결제 수단

​결제 수단 세부 정보

​구성

​API Method Types

​예시: 필리핀 Checkout

​예시: 홍콩 Checkout

​예시: 말레이시아 Checkout

​요구 사항

​테스트

​모범 사례

​문제 해결

​관련 페이지

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

아시아 태평양 wallet이 중요한 이유

지원되는 결제 수단

결제 수단 세부 정보

구성

API Method Types

예시: 필리핀 Checkout

예시: 홍콩 Checkout

예시: 말레이시아 Checkout

요구 사항

테스트

모범 사례

문제 해결

관련 페이지