아시아 태평양 결제 수단

필리핀, 홍콩, 말레이시아의 고객이 매일 사용하는 wallet 또는 bank transfer로 결제할 수 있도록 하세요. Dodo Payments는 일회성 결제에서 GCash(필리핀), Alipay HK 및 FPS(홍콩), Touch ‘n Go(말레이시아)를 지원합니다. 각 결제 수단은 해당 지역의 현지 통화로 청구되며, 고객은 checkout에 표시된 QR code를 스캔하여 결제합니다.

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

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

Wallet-First Markets

GCash는 필리핀에서 가장 인기 있는 digital wallet이며, Touch ‘n Go는 말레이시아에서 가장 큰 e-wallet입니다.

Low Card Penetration

필리핀은 card-first 시장에 비해 credit card 사용률이 낮습니다. 현지 wallet과 bank transfer를 지원하면 card-only checkout으로는 도달하지 못하는 고객에게 다가갈 수 있습니다.

Instant Settlement

FPS는 홍콩에서 하루 24시간 운영되며 자금이 수취인에게 거의 즉시 도착하므로, 고객이 기다리는 동안 checkout에서 결제를 확인할 수 있습니다.

지원되는 결제 수단

이 표에는 각 결제 수단의 시장, 청구 통화 및 최소 금액이 나와 있습니다. 최소 금액은 해당 통화의 checkout 최소 금액이므로, 해당 통화로 진행하는 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

네 가지 결제 수단은 모두 일회성 결제만 지원합니다. 어떤 결제 수단도 subscription checkout에 표시되지 않으며 다른 recurring charge를 지원하지 않습니다. 이 시장의 고객이 계속 가입할 수 있도록 subscription checkout에 credit 및 debit를 포함하세요.

고객은 현지 통화로 결제합니다. 이 네 가지 결제 수단으로 이루어진 결제는 귀사의 USD wallet으로 정산됩니다. 동일한 checkout의 card payment도 USD로 정산됩니다.

결제 수단 세부 정보

GCash (Philippines)

GCash는 필리핀에서 가장 인기 있는 e-wallet입니다. checkout에서 고객은 GCash를 선택하고 Pay를 클릭한 다음 GCash app으로 QR code를 스캔하여 결제를 승인합니다.**Philippines (PH)**로 청구되고 PHP로 결제되는 one-time checkout에서 제공됩니다.

Alipay HK (Hong Kong)

Alipay HK는 Alipay의 홍콩 버전입니다. 현지 시장을 대상으로 하며 홍콩 달러로 정산됩니다. 중국 본토의 Alipay product와는 별도의 결제 수단입니다. checkout에는 AlipayHK로 표시됩니다.**Hong Kong (HK)**으로 청구되고 HKD로 결제되는 one-time checkout에서 제공됩니다. Alipay HK는 HKD로만 정산되므로, billing country가 홍콩이어도 CNY checkout에는 표시되지 않습니다.

FPS (Hong Kong)

FPS(Faster Payment System)는 Hong Kong Monetary Authority가 출시한 홍콩의 real-time payment system입니다. 은행과 e-wallet을 연결하고 하루 24시간 운영되며 홍콩 달러와 중국 위안을 지원합니다. 고객은 banking app 또는 e-wallet app으로 QR code를 스캔하고, 자금은 거의 즉시 도착합니다.**Hong Kong (HK)**으로 청구되고 HKD 또는 CNY로 결제되는 one-time checkout에서 제공됩니다.

Touch 'n Go (Malaysia)

Touch ‘n Go는 말레이시아에서 가장 큰 e-wallet입니다. 고객은 Touch ‘n Go app으로 QR code를 스캔한 뒤 해당 app에서 결제를 확인합니다.**Malaysia (MY)**로 청구되고 MYR로 결제되는 one-time checkout에서 제공됩니다.

구성

API Method Types

다음 값을 allowed_payment_method_types에 전달하세요:

유형	설명
`gcash`	GCash wallet (필리핀)
`ali_pay_hk`	Alipay HK wallet (홍콩)
`fps`	FPS real-time 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에 결제 수단이 표시됩니다:

billing country가 해당 결제 수단의 시장과 일치해야 합니다. GCash는 PH, Alipay HK와 FPS는 HK, Touch ‘n Go는 MY입니다.
billing currency가 결제 수단과 일치해야 합니다. PHP, HKD(FPS는 CNY도 가능) 또는 MYR이어야 합니다.
checkout이 subscription이 아닌 one-time payment여야 합니다.
**Adaptive Currency**가 활성화되어 있어야 합니다. 이를 활성화하지 않으면 billing_currency가 무시되며 checkout에서 PHP, HKD, CNY 또는 MYR로 청구할 수 없습니다.

Adaptive Currency가 비활성화되어 있으면 해당 시장의 고객에게 현지 통화로 청구되지 않으며, 이러한 결제 수단도 표시되지 않습니다.

테스트

Enable test mode

dashboard sidebar에서 Live Mode 전환을 끄고 test mode에서 생성한 API key를 사용하세요.

Set the billing country and currency

테스트할 결제 수단에 맞는 billing address country와 billing currency를 사용하여 one-time checkout을 생성하세요:

결제 수단	Billing Country	Billing Currency
GCash	`PH`	`PHP`
Alipay HK	`HK`	`HKD`
FPS	`HK`	`HKD` 또는 `CNY`
Touch ‘n Go	`MY`	`MYR`

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

Select the method and confirm

checkout에서 결제 수단을 선택하고 Pay를 클릭하세요. 10분 카운트다운이 표시되는 full-screen overlay에서 QR code가 열리며, overlay가 열려 있는 동안 checkout에서 결제 상태를 확인합니다.

Verify the checkout behavior

일치하는 country와 currency에서만 결제 수단이 표시되고 QR code가 렌더링되는지 확인하세요.

Test-mode QR code는 wallet provider의 test environment에서 생성되므로 live payment와 다르게 작동할 수 있습니다.

모범 사례

Lead with the local wallet

필리핀과 말레이시아의 많은 고객은 현지 wallet으로 결제하기를 기대합니다. 해당 시장의 checkout에서 GCash 또는 Touch ‘n Go를 card와 함께 표시하세요.

Offer both Hong Kong methods

Alipay HK와 FPS는 서로 다른 고객을 대상으로 합니다. Alipay HK는 wallet 사용자, FPS는 bank transfer 사용자에게 적합합니다. HKD checkout에 두 결제 수단을 모두 포함하여 각 고객이 선호하는 결제 수단을 볼 수 있도록 하세요.

Keep cards on subscription checkouts

이 페이지의 모든 결제 수단은 one-time only이므로, local wallet만 나열된 subscription checkout에는 표시할 결제 수단이 없습니다. recurring plan에는 credit 및 debit를 포함하세요.

Match currency to region

이러한 결제 수단에는 현지 billing currency가 필요합니다. catalog의 가격이 USD 또는 EUR로 설정되어 있다면 Adaptive Currency를 활성화하여 고객에게 PHP, HKD, CNY 또는 MYR로 금액을 안내하고 청구하세요.

문제 해결

Method not appearing at checkout

확인 사항:

billing country가 해당 결제 수단에 맞는 PH, HK 또는 MY인가요?
billing currency가 해당 결제 수단에 맞는 PHP, HKD, CNY 또는 MYR인가요?
one-time payment인가요? 이러한 결제 수단은 subscription에 표시되지 않습니다.
결제 수단( gcash, ali_pay_hk, fps 또는 touch_n_go)이 allowed_payment_method_types에 포함되어 있나요?
Adaptive Currency가 활성화되어 있나요?
금액이 Supported Methods에 있는 currency minimum을 충족하나요?

해결 방법: allowed_payment_method_types를 일시적으로 제거하여 사용 가능한 모든 결제 수단을 확인한 다음, 충족되지 않는 조건을 찾으세요.

Alipay HK missing on a CNY checkout

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

Wallet missing on a subscription

원인: GCash, Alipay HK, FPS 및 Touch ‘n Go는 one-time only이며 recurring billing에는 제공되지 않습니다.해결 방법: 해당 시장의 subscription에는 credit 및 debit를 사용하세요.

Payment not confirming

원인: 고객은 QR code를 스캔하고 wallet 또는 banking app에서 결제를 승인해야 합니다. 고객이 승인하기 전에 app을 닫으면 결제는 완료되지 않은 상태로 남습니다.해결 방법: return redirect 대신 최종 결제 상태 확인에 webhooks를 사용하세요. Webhooks guide를 참조하세요.

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

요구 사항

테스트

모범 사례

문제 해결

관련 페이지