> ## 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. Conoce los requisitos de moneda, la compatibilidad con pagos únicos y la configuración.

Los compradores de la región de Asia-Pacífico pagan con billeteras electrónicas locales y transferencias bancarias en tiempo real con mucha más frecuencia que con tarjetas internacionales. Dodo Payments admite **GCash** (Filipinas), **Alipay HK** y **FPS** (Hong Kong), y **Touch 'n Go** (Malasia), cada uno facturado en su moneda local.

<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 y Touch 'n Go son la forma predeterminada de pagar en línea en Filipinas y Malasia, muy por delante de introducir los datos de una tarjeta.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    La tenencia de tarjetas es limitada en gran parte de la región. Las billeteras locales y las redes bancarias llegan a clientes que los procesos de pago que solo aceptan tarjetas no alcanzan.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS realiza transferencias bancarias en tiempo real en Hong Kong, por lo que los pagos se confirman durante el checkout en lugar de horas después.
  </Card>
</CardGroup>

## Métodos compatibles

| 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 están disponibles para pagos únicos.** Ninguno admite suscripciones ni ningún otro cargo recurrente. Incluye siempre `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 y tú recibes la liquidación en **USD**, igual que con cualquier otro método que no sea en USD.
</Info>

### Detalles de los métodos

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash es la billetera electrónica más grande de Filipinas y se utiliza para todo, desde pagar facturas hasta comprar en línea. Los clientes aprueban el pago en la aplicación de GCash y regresan a tu página de éxito.

    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, operada para el mercado local y liquidada en dólares de Hong Kong. Es un método independiente del producto Alipay de China continental.

    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 la red de transferencias interbancarias en tiempo real de Hong Kong, operada por la Autoridad Monetaria de Hong Kong. Los clientes pagan directamente desde su cuenta bancaria y la transferencia se liquida al instante.

    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 billetera electrónica predominante de Malasia. Los clientes confirman el pago en la aplicación de Touch 'n Go y regresan a tu página de éxito.

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

## Configuración

### Tipos de método de API

| Tipo         | Descripción                                           |
| :----------- | :---------------------------------------------------- |
| `gcash`      | Billetera GCash (Filipinas)                           |
| `ali_pay_hk` | Billetera Alipay HK (Hong Kong)                       |
| `fps`        | Transferencia bancaria en tiempo real FPS (Hong Kong) |
| `touch_n_go` | Billetera 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

Para que estos métodos aparezcan en el checkout:

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** coincide con el método: PHP, HKD (o CNY para FPS) o MYR
3. El **tipo de pago** es un pago único, no una suscripción
4. Para merchants cuyos precios están en otra moneda: **[Adaptive Currency](/features/adaptive-currency)** debe estar habilitado para que los clientes reciban el cobro en la moneda local

<Warning>
  Si estableces los precios en otra moneda y Adaptive Currency no está habilitado, los clientes de estos mercados no recibirán el cobro en la moneda local y ninguno de estos métodos estará disponible.
</Warning>

## Pruebas

<Steps>
  <Step title="Enable test mode">
    Utiliza tus claves de API de prueba de Dodo Payments.
  </Step>

  <Step title="Set the billing country and currency">
    Crea un checkout de pago único con el país y la moneda de facturación correspondientes al 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 checkouts de suscripción.
  </Step>

  <Step title="Select the method and confirm">
    Selecciona el método de pago en el checkout y haz clic en **Pagar**. Se abre un código QR en una superposición de pantalla completa y el checkout espera el pago.
  </Step>

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

<Note>
  Los códigos QR del modo de prueba los emite el entorno de prueba del proveedor de la billetera y pueden comportarse de manera diferente a un pago real.
</Note>

## Prácticas recomendadas

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    En Filipinas y Malasia, la billetera local es el principal método con el que los clientes esperan pagar. Mostrar GCash o Touch 'n Go junto con las tarjetas reduce considerablemente el abandono.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK y FPS atienden a clientes diferentes: usuarios de billeteras y usuarios de transferencias bancarias. Incluye ambos en los checkouts en HKD para que Dodo Payments pueda mostrar la opción que prefiera el cliente.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Como todos los métodos de esta página son únicamente para pagos únicos, un checkout de suscripción que solo muestre billeteras locales no tendrá nada que mostrar. Incluye siempre `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 cotizaciones y cargos 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 está establecido en `PH`, `HK` o `MY` para coincidir con el método?
    2. ¿La moneda de facturación está establecida en PHP, HKD, CNY o MYR para coincidir con 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. Si el precio está en otra moneda: ¿Adaptive Currency está habilitado?

    **Solución:** Elimina `allowed_payment_method_types` temporalmente para ver todos los métodos disponibles y, después, determina qué condición 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 están disponibles para pagos únicos y nunca se ofrecen para facturación recurrente.

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

  <Accordion title="Payment not confirming">
    **Causa:** Estos métodos redirigen al cliente a una aplicación de billetera o bancaria. Si el cliente abandona la aplicación, el pago queda incompleto.

    **Solución:** Supervisa los webhooks para consultar el estado final del pago en lugar de depender 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 compatibles.
  </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 para implementar el checkout.
  </Card>

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