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

# 아시아 태평양 결제 수단

> 필리핀에서 GCash, 홍콩에서 Alipay HK 및 FPS, 말레이시아에서 Touch 'n Go를 사용한 결제를 수락하세요. 통화 요건, 일회성 결제 지원 및 구성 방법을 알아보세요.

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

<Note>
  이 페이지에서는 필리핀, 홍콩 및 말레이시아를 다룹니다. 다른 아시아 시장에 대해서는 UPI 및 Rupay를 지원하는 [인도](/features/payment-methods/india), Kakao Pay, Naver Pay 및 PAYCO를 지원하는 [대한민국](/features/payment-methods/south-korea), 중국 고객을 위한 [WeChat Pay](/features/payment-methods/wechat)를 참조하세요.
</Note>

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

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash와 Touch 'n Go는 필리핀과 말레이시아에서 온라인 결제 시 기본 결제 수단이며, 카드 정보를 직접 입력하는 방식보다 훨씬 앞서 있습니다.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    이 지역 대부분에서는 카드 보유율이 제한적입니다. 현지 wallet과 bank rail을 사용하면 카드만 지원하는 checkout으로는 도달하기 어려운 고객에게도 접근할 수 있습니다.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS는 홍콩에서 은행 간 거래를 실시간으로 처리하므로 결제가 몇 시간 후가 아니라 checkout 중에 확인됩니다.
  </Card>
</CardGroup>

## 지원되는 결제 수단

| 결제 수단           | 국가    | 청구 통화    |  구독 | 최소 금액               |
| :-------------- | :---- | :------- | :-: | :------------------ |
| **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            |

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

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

### 결제 수단 세부 정보

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash는 필리핀 최대의 e-wallet으로, 공과금 납부부터 온라인 쇼핑까지 다양한 용도로 사용됩니다. 고객은 GCash 앱에서 결제를 승인한 후 귀사의 success page로 돌아옵니다.

    \*\*필리핀 (`PH`)\*\*으로 청구되며 **PHP**로 결제되는 **일회성** checkout에서 제공됩니다.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK는 홍콩 현지 시장을 대상으로 운영되며 홍콩 달러로 settlement되는 Alipay의 홍콩 버전입니다. 중국 본토의 Alipay product와는 별도의 결제 수단입니다.

    \*\*홍콩 (`HK`)\*\*으로 청구되며 **HKD**로 결제되는 **일회성** checkout에서 제공됩니다. Alipay HK는 HKD로만 settlement되므로 청구 국가가 홍콩이어도 CNY checkout에는 표시되지 않습니다.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS(Faster Payment System)는 홍콩 금융관리국이 운영하는 홍콩의 실시간 은행 간 transfer network입니다. 고객은 은행 계좌에서 직접 결제하며 transfer가 즉시 처리됩니다.

    **HKD** 또는 **CNY**로 결제되며 \*\*홍콩 (`HK`)\*\*으로 청구되는 **일회성** checkout에서 제공됩니다.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go는 말레이시아의 대표적인 e-wallet입니다. 고객은 Touch 'n Go 앱에서 결제를 확인한 후 귀사의 success page로 돌아옵니다.

    \*\*말레이시아 (`MY`)\*\*으로 청구되며 **MYR**로 결제되는 **일회성** checkout에서 제공됩니다.
  </Accordion>
</AccordionGroup>

## 구성

### API Method Types

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

### 예시: 필리핀 Checkout

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

### 예시: 홍콩 Checkout

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

### 예시: 말레이시아 Checkout

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

### 요구 사항

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

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

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

## 테스트

<Steps>
  <Step title="Enable test mode">
    Dodo Payments test API keys를 사용하세요.
  </Step>

  <Step title="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에서 제공되지 않습니다.
  </Step>

  <Step title="Select the method and confirm">
    checkout에서 결제 수단을 선택하고 **Pay**를 클릭하세요. QR code가 전체 화면 overlay로 열리고 checkout은 결제를 기다립니다.
  </Step>

  <Step title="Verify the checkout behavior">
    결제 수단이 일치하는 국가와 통화에서만 표시되고 QR code가 정상적으로 렌더링되는지 확인하세요.
  </Step>
</Steps>

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

## 모범 사례

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    필리핀과 말레이시아에서는 고객이 현지 wallet을 주요 결제 수단으로 기대합니다. 카드와 함께 GCash 또는 Touch 'n Go를 제공하면 checkout 이탈을 크게 줄일 수 있습니다.
  </Accordion>

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

  <Accordion title="Keep cards on subscription checkouts">
    이 페이지의 모든 결제 수단은 일회성 결제만 지원하므로 현지 wallet만 표시하는 구독 checkout에는 표시할 결제 수단이 없습니다. recurring plan에는 항상 `credit` 및 `debit`를 포함하세요.
  </Accordion>

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

## 문제 해결

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **확인 사항:**

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

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

  <Accordion title="Alipay HK missing on a CNY checkout">
    **원인:** Alipay HK는 HKD로만 settlement됩니다. CNY로 홍콩에 청구되는 checkout에서는 FPS가 제공되지만 Alipay HK는 제공되지 않습니다.

    **해결 방법:** Alipay HK를 제공하려면 HKD로 청구하거나, 홍콩의 CNY checkout에 `fps`를 포함하세요.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **원인:** GCash, Alipay HK, FPS 및 Touch 'n Go는 모두 일회성 결제만 지원하며 recurring billing에는 절대 제공되지 않습니다.

    **해결 방법:** 해당 시장의 구독에는 `credit` 및 `debit`를 사용하세요.
  </Accordion>

  <Accordion title="Payment not confirming">
    **원인:** 이러한 결제 수단은 고객을 wallet app 또는 banking app으로 redirect합니다. 고객이 app을 종료하면 결제는 incomplete 상태로 남습니다.

    **해결 방법:** return redirect에 의존하지 말고 최종 payment status를 webhooks로 모니터링하세요. [Webhooks 가이드](/developer-resources/webhooks)를 참조하세요.
  </Accordion>
</AccordionGroup>

## 관련 페이지

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    지원되는 모든 결제 수단을 확인하세요.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    PHP, HKD, CNY 및 MYR를 포함한 현지 통화로 고객에게 청구하세요.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    완전한 checkout 구현 가이드입니다.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    테스트 데이터 및 checkout 테스트 가이드입니다.
  </Card>
</CardGroup>