Skip to main content
Permite que los clientes chinos paguen escaneando un código QR con la aplicación WeChat. WeChat Pay es la billetera de pago dentro de WeChat, la principal aplicación móvil de China, y Dodo Payments lo ofrece para pagos únicos facturados en USD o CNY.

¿Por qué Ofrecer WeChat Pay?

800M+ Users

WeChat tiene más de 1.000 millones de usuarios activos mensuales, y WeChat Pay tiene más de 800 millones de usuarios.

Mobile-First

El cliente aprueba el pago dentro de la aplicación WeChat, un flujo que los clientes chinos ya conocen.

Dual Currency

Factura en USD o CNY, según los clientes a los que vendas.

Resumen

¿Cómo Funciona?

Experiencia del Cliente

  1. El cliente selecciona WeChat en el checkout y hace clic en Pagar.
  2. Se abre un código QR en una superposición de pantalla completa en la página de checkout.
  3. El cliente abre WeChat en su teléfono y escanea el código QR. Si el cliente ya está pagando desde su teléfono, el checkout muestra los pasos para tomar una captura de pantalla del código QR y escanearlo desde el álbum de fotos de WeChat.
  4. El cliente confirma el pago en la aplicación WeChat.
  5. El checkout detecta que el pago se ha completado y redirige al cliente a tu página de éxito.
Los clientes pagan en USD o CNY, y recibes la liquidación en USD.

Configuración

WeChat Pay aparece en checkouts de pago único facturados en USD o CNY. Para facturar en CNY, habilita Adaptive Currency y pasa billing_currency: 'CNY'.

Tipo de método de API

Pruebas

1

Enable test mode

Desactiva el interruptor Live Mode en la barra lateral del dashboard y usa las claves de API creadas en el modo de prueba.
2

Create a test checkout

Crea una sesión de checkout de pago único con we_chat_pay en allowed_payment_method_types.
3

Scan the QR code

El checkout muestra un código QR de prueba. Escanéalo con la cámara de tu teléfono; no necesitas la aplicación WeChat. El código QR abre una página de prueba donde puedes autorizar o rechazar el pago.

Prácticas recomendadas

WeChat Pay es utilizado principalmente por consumidores chinos. Inclúyelo cuando tus clientes incluyan compradores chinos o cuando vendas en el mercado chino.
No todos los clientes tienen WeChat. Incluye credit y debit como métodos de pago alternativos.
Escanear es más fácil cuando el checkout está abierto en una computadora o tableta y el cliente escanea con su teléfono. En un teléfono, el checkout guía al cliente para tomar una captura de pantalla del código QR y escanearlo desde el álbum de fotos de WeChat, así que mantén tu página de checkout adaptable.
WeChat Pay admite USD y CNY. Elige la moneda de facturación que mejor se adapte a tus clientes: USD si estableces los precios en USD, o CNY para mostrar a los clientes chinos un precio en su propia moneda. La liquidación se realiza en USD en ambos casos.

Solución de problemas

Comprueba lo siguiente:
  1. ¿Está we_chat_pay incluido en allowed_payment_method_types?
  2. ¿La moneda de facturación es USD o CNY?
  3. ¿El importe alcanza el mínimo ($0.50 o 4.00 CNY)?
  4. ¿Se trata de un pago único? WeChat Pay no está disponible para suscripciones.
Solución: Comprueba el tipo de método de pago y la moneda en tu solicitud de API.
Causa: Es posible que el código QR haya caducado o que la versión de WeChat del cliente esté desactualizada. El código QR caduca después de un tiempo limitado.Solución: Si el código QR ha caducado, el cliente debe iniciar un nuevo checkout desde tu sitio, o puedes crear una nueva sesión de checkout para él. Si el código sigue siendo válido, pide al cliente que actualice WeChat a una versión actual.
Causa: WeChat Pay suele confirmar en cuestión de segundos, pero pueden producirse retrasos de red.Solución: Usa webhooks para confirmar el pago. Si el pago no se confirma en unos minutos, es posible que el cliente tenga que volver a intentarlo.

Páginas relacionadas

Payment Methods Overview

Consulta todos los métodos de pago compatibles.

Checkout Guide

Guía completa de implementación del checkout.

Webhooks

Gestiona las confirmaciones de pago de forma asíncrona.

Asia-Pacific

GCash (Filipinas), Alipay HK y FPS (Hong Kong), y Touch ‘n Go (Malasia).

Testing Process

Guía completa de pruebas para todos los métodos de pago.
Última modificación el 26 de septiembre de 2026