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

# Métodos de pago de Asia-Pacífico

> Acepta GCash en Filipinas, Alipay HK y FPS en Hong Kong, y Touch 'n Go en Malasia para pagos únicos, facturados en la moneda local de cada mercado.

Permite que los clientes de Filipinas, Hong Kong y Malasia paguen con la wallet o la transferencia bancaria que usan a diario. Dodo Payments admite **GCash** (Filipinas), **Alipay HK** y **FPS** (Hong Kong), y **Touch 'n Go** (Malasia) para pagos únicos. Cada método se factura en su moneda local y el cliente paga escaneando un código QR que se muestra durante el checkout.

<Note>
  Esta página cubre Filipinas, Hong Kong y Malasia. Para otros mercados asiáticos, consulta [India](/features/payment-methods/india) para UPI y Rupay, [Corea del Sur](/features/payment-methods/south-korea) para Kakao Pay, Naver Pay y PAYCO, y [WeChat Pay](/features/payment-methods/wechat) para clientes chinos.
</Note>

## Por qué son importantes las billeteras de Asia-Pacífico

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash es la wallet digital más popular de Filipinas y Touch 'n Go es la e-wallet más grande de Malasia.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    El uso de tarjetas de crédito es bajo en Filipinas en comparación con los mercados donde predominan las tarjetas. Las wallets locales y las transferencias bancarias permiten llegar a clientes que un checkout que solo acepta tarjetas no alcanza.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS funciona las 24 horas del día en Hong Kong y los fondos llegan al beneficiario casi de inmediato, por lo que el checkout puede confirmar el pago mientras el cliente espera.
  </Card>
</CardGroup>

## Métodos compatibles

La tabla muestra el mercado, la moneda de facturación y el importe mínimo de cada método. El mínimo es el importe mínimo del checkout para esa moneda, por lo que se aplica a todos los métodos de pago de un checkout en dicha moneda.

| Método | País | Moneda de facturación | Suscripciones | Importe mínimo |
| :- | :- | :- | :-: | :- |
| **GCash** | Filipinas | PHP | No | 50.00 PHP |
| **Alipay HK** | Hong Kong | HKD | No | 4.00 HKD |
| **FPS** | Hong Kong | HKD, CNY | No | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | Malasia | MYR | No | 4.00 MYR |

<Warning>
  **Los cuatro métodos solo admiten pagos únicos.** Ninguno aparece en los checkouts de suscripción ni admite ningún otro cargo recurrente. Incluye `credit` y `debit` en los checkouts de suscripción para que los clientes de estos mercados puedan registrarse.
</Warning>

<Info>
  Los clientes pagan en su moneda local. Los pagos realizados con estos cuatro métodos se liquidan en tu wallet de **USD**. Los pagos con tarjeta del mismo checkout también se liquidan en USD.
</Info>

### Detalles de los métodos

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash es la e-wallet más popular de Filipinas. Durante el checkout, el cliente selecciona **GCash**, hace clic en **Pay** y escanea el código QR con la aplicación GCash para aprobar el pago.

    Disponible en checkouts de **pago único** facturados a **Filipinas (`PH`)** en **PHP**.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK es la edición de Alipay para Hong Kong. Atiende al mercado local y liquida los pagos en dólares de Hong Kong. Es un método diferente del producto Alipay de China continental. El checkout lo muestra como **AlipayHK**.

    Disponible en checkouts de **pago único** facturados a **Hong Kong (`HK`)** en **HKD**. Alipay HK solo liquida en HKD, por lo que no aparece en un checkout en CNY, aunque el país de facturación sea Hong Kong.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS (Faster Payment System) es el sistema de pagos en tiempo real de Hong Kong, creado por la Autoridad Monetaria de Hong Kong. Conecta bancos y e-wallets, funciona las 24 horas del día y admite dólares de Hong Kong y yuanes chinos. El cliente escanea el código QR con una aplicación bancaria o de e-wallet y los fondos llegan casi de inmediato.

    Disponible en checkouts de **pago único** facturados a **Hong Kong (`HK`)** en **HKD** o **CNY**.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go es la e-wallet más grande de Malasia. El cliente escanea el código QR con la aplicación Touch 'n Go y confirma el pago allí.

    Disponible en checkouts de **pago único** facturados a **Malasia (`MY`)** en **MYR**.
  </Accordion>
</AccordionGroup>

## Configuración

### Tipos de métodos de API

Pasa estos valores en `allowed_payment_method_types`:

| Tipo | Descripción |
| :- | :- |
| `gcash` | Wallet GCash (Filipinas) |
| `ali_pay_hk` | Wallet Alipay HK (Hong Kong) |
| `fps` | Transferencia bancaria en tiempo real FPS (Hong Kong) |
| `touch_n_go` | Wallet Touch 'n Go (Malasia) |

### Ejemplo: checkout de Filipinas

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

### Ejemplo: checkout de Hong Kong

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

### Ejemplo: checkout de Malasia

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

### Requisitos

Un método aparece durante el checkout solo cuando se cumplen todas estas condiciones:

1. El **país de facturación** coincide con el mercado del método: `PH` para GCash, `HK` para Alipay HK y FPS, e `MY` para Touch 'n Go.
2. La **moneda de facturación** coincide con el método: PHP, HKD (o CNY para FPS) o MYR.
3. El checkout es un **pago único**, no una suscripción.
4. **[Adaptive Currency](/features/adaptive-currency)** está habilitado. Sin esta opción, `billing_currency` se ignora y el checkout no puede facturar en PHP, HKD, CNY o MYR.

<Warning>
  Si Adaptive Currency está deshabilitado, los clientes de estos mercados no reciben cargos en su moneda local y ninguno de estos métodos aparece.
</Warning>

## Pruebas

<Steps>
  <Step title="Enable test mode">
    Desactiva el interruptor de **Live Mode** en la barra lateral del dashboard y utiliza las claves de API creadas en modo de prueba.
  </Step>

  <Step title="Set the billing country and currency">
    Crea un checkout de pago único con el país de la dirección de facturación y la moneda de facturación del método que estás probando:

    | Método | País de facturación | Moneda de facturación |
    | :- | :- | :- |
    | GCash | `PH` | `PHP` |
    | Alipay HK | `HK` | `HKD` |
    | FPS | `HK` | `HKD` o `CNY` |
    | Touch 'n Go | `MY` | `MYR` |

    Incluye el tipo de método en `allowed_payment_method_types`. Estos métodos no se ofrecen en los checkouts de suscripción.
  </Step>

  <Step title="Select the method and confirm">
    Selecciona el método de pago durante el checkout y haz clic en **Pay**. Se abre un código QR en una superposición de pantalla completa con una cuenta regresiva de 10 minutos, y el checkout comprueba el estado del pago mientras la superposición está abierta.
  </Step>

  <Step title="Verify the checkout behavior">
    Confirma que el método aparece únicamente para el país y la moneda correspondientes y que el código QR se muestra correctamente.
  </Step>
</Steps>

<Note>
  Los códigos QR del modo de prueba proceden del entorno de prueba del proveedor de la wallet y pueden comportarse de forma diferente a un pago real.
</Note>

## Prácticas recomendadas

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    En Filipinas y Malasia, muchos clientes esperan pagar con una wallet local. Muestra GCash o Touch 'n Go junto a las tarjetas en los checkouts de estos mercados.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK y FPS atienden a clientes diferentes: usuarios de wallets y usuarios de transferencias bancarias. Incluye ambos en los checkouts en HKD para que cada cliente vea el método que prefiere.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Todos los métodos de esta página solo admiten pagos únicos, por lo que un checkout de suscripción que muestre únicamente wallets locales no tendrá ningún método disponible. Incluye `credit` y `debit` para los planes recurrentes.
  </Accordion>

  <Accordion title="Match currency to region">
    Estos métodos requieren su moneda de facturación local. Si tu catálogo tiene precios en USD o EUR, habilita Adaptive Currency para que los clientes reciban el precio y paguen en PHP, HKD, CNY o MYR.
  </Accordion>
</AccordionGroup>

## Solución de problemas

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **Comprueba:**

    1. ¿El país de facturación es `PH`, `HK` o `MY`, según el método?
    2. ¿La moneda de facturación es PHP, HKD, CNY o MYR, según el método?
    3. ¿Es un pago único? Ninguno de estos métodos aparece en las suscripciones.
    4. ¿El método (`gcash`, `ali_pay_hk`, `fps` o `touch_n_go`) está incluido en `allowed_payment_method_types`?
    5. ¿Adaptive Currency está habilitado?
    6. ¿El importe alcanza el mínimo de la moneda indicado en [Métodos admitidos](#supported-methods)?

    **Solución:** Elimina temporalmente `allowed_payment_method_types` para ver todos los métodos aptos y, a continuación, identifica la condición que no se cumple.
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **Causa:** Alipay HK solo liquida en HKD. Un checkout facturado a Hong Kong en CNY ofrece FPS, pero nunca Alipay HK.

    **Solución:** Factura en HKD para ofrecer Alipay HK o incluye `fps` en los checkouts en CNY para Hong Kong.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **Causa:** GCash, Alipay HK, FPS y Touch 'n Go solo admiten pagos únicos y no se ofrecen para la facturación recurrente.

    **Solución:** Usa `credit` y `debit` para las suscripciones de estos mercados.
  </Accordion>

  <Accordion title="Payment not confirming">
    **Causa:** El cliente debe escanear el código QR y aprobar el pago en una wallet o aplicación bancaria. Si cierra la aplicación antes de aprobarlo, el pago queda incompleto.

    **Solución:** Usa webhooks para obtener el estado final del pago en lugar de la redirección de retorno. Consulta la [guía de Webhooks](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Consulta todos los métodos de pago admitidos.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Factura a los clientes en su moneda local, incluidos PHP, HKD, CNY y MYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Guía completa de implementación del checkout.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Datos de prueba y guía para probar el checkout.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.