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.

Esta página cubre Filipinas, Hong Kong y Malasia. Para otros mercados asiáticos, consulta India para UPI y Rupay, Corea del Sur para Kakao Pay, Naver Pay y PAYCO, y WeChat Pay para clientes chinos.

​

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

Wallet-First Markets

GCash es la wallet digital más popular de Filipinas y Touch ‘n Go es la e-wallet más grande de Malasia.

Low Card Penetration

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.

Instant Settlement

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.

​

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

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.

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.

​

Detalles de los métodos

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.

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.

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.

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.

​

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

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

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

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 está habilitado. Sin esta opción, billing_currency se ignora y el checkout no puede facturar en PHP, HKD, CNY o MYR.

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

​

Pruebas

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

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

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

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

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.

​

Prácticas recomendadas

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.

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.

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.

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.

​

Solución de problemas

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?

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.

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.

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.

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.

​

Páginas relacionadas

Payment Methods Overview

Consulta todos los métodos de pago admitidos.

Adaptive Currency

Factura a los clientes en su moneda local, incluidos PHP, HKD, CNY y MYR.

Checkout Guide

Guía completa de implementación del checkout.

Testing Process

Datos de prueba y guía para probar el checkout.