Skip to main content
Consenti ai clienti cinesi di pagare scansionando un codice QR con l’app WeChat. WeChat Pay è il wallet di pagamento integrato in WeChat, la principale app mobile cinese, e Dodo Payments lo offre per i pagamenti una tantum fatturati in USD o CNY.

Perché Offrire WeChat Pay?

800M+ Users

WeChat ha oltre 1 miliardo di utenti attivi mensili e WeChat Pay ha oltre 800 milioni di utenti.

Mobile-First

Il cliente approva il pagamento all’interno dell’app WeChat, seguendo un flusso che i clienti cinesi già conoscono.

Dual Currency

Fattura in USD o CNY, a seconda dei clienti a cui vendi.

Panoramica

Come Funziona

Esperienza del Cliente

  1. Il cliente seleziona WeChat al checkout e fa clic su Paga.
  2. Un codice QR si apre in una sovrapposizione a schermo intero nella pagina di checkout.
  3. Il cliente apre WeChat sul telefono e scansiona il codice QR. Se il cliente sta già effettuando il pagamento dal telefono, il checkout mostra i passaggi per acquisire uno screenshot del codice QR e scansionarlo dall’album fotografico di WeChat.
  4. Il cliente conferma il pagamento nell’app WeChat.
  5. Il checkout rileva il completamento del pagamento e reindirizza il cliente alla pagina di successo.
I clienti pagano in USD o CNY, e ricevi il regolamento in USD.

Configurazione

WeChat Pay appare nei checkout per pagamenti una tantum fatturati in USD o CNY. Per fatturare in CNY, abilita Adaptive Currency e passa billing_currency: 'CNY'.

Tipo di metodo API

Test

1

Enable test mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e usa le chiavi API create in modalità di test.
2

Create a test checkout

Crea una sessione di checkout una tantum con we_chat_pay in allowed_payment_method_types.
3

Scan the QR code

Il checkout mostra un codice QR di test. Scansionalo con la fotocamera del telefono; non è necessaria l’app WeChat. Il codice QR apre una pagina di test in cui puoi autorizzare o rifiutare il pagamento.

Best practice

WeChat Pay è utilizzato soprattutto dai consumatori cinesi. Includilo quando tra i tuoi clienti ci sono acquirenti cinesi o quando vendi al mercato cinese.
Non tutti i clienti hanno WeChat. Includi credit e debit come metodi di pagamento alternativi.
La scansione è più semplice quando il checkout è aperto su un computer o un tablet e il cliente scansiona con il telefono. Sul telefono, il checkout guida il cliente ad acquisire uno screenshot del codice QR e a scansionarlo dall’album fotografico di WeChat; assicurati quindi che la pagina di checkout sia responsive.
WeChat Pay supporta USD e CNY. Scegli la valuta di fatturazione più adatta ai tuoi clienti: USD se definisci i prezzi in USD oppure CNY per mostrare ai clienti cinesi un prezzo nella loro valuta. In entrambi i casi, il regolamento avviene in USD.

Risoluzione dei problemi

Verifica:
  1. we_chat_pay è incluso in allowed_payment_method_types?
  2. La valuta di fatturazione è USD o CNY?
  3. L’importo raggiunge il minimo richiesto ($0.50 o 4.00 CNY)?
  4. Si tratta di un pagamento una tantum? WeChat Pay non è disponibile per gli abbonamenti.
Soluzione: verifica il tipo di metodo di pagamento e la valuta nella richiesta API.
Causa: Il codice QR potrebbe essere scaduto oppure la versione di WeChat del cliente potrebbe essere obsoleta. Il codice QR scade dopo un periodo di tempo limitato.Soluzione: Se il codice QR è scaduto, il cliente deve avviare un nuovo checkout dal tuo sito oppure puoi creare una nuova sessione di checkout per lui. Se il codice è ancora valido, chiedi al cliente di aggiornare WeChat a una versione recente.
Causa: WeChat Pay di solito conferma entro pochi secondi, ma possono verificarsi ritardi di rete.Soluzione: usa i webhook per la conferma del pagamento. Se il pagamento non viene confermato entro pochi minuti, potrebbe essere necessario che il cliente riprovi.

Pagine correlate

Payment Methods Overview

Consulta tutti i metodi di pagamento supportati.

Checkout Guide

Guida completa all’implementazione del checkout.

Webhooks

Gestisci le conferme dei pagamenti in modo asincrono.

Asia-Pacific

GCash (Filippine), Alipay HK e FPS (Hong Kong) e Touch ‘n Go (Malesia).

Testing Process

Guida completa ai test per tutti i metodi di pagamento.
Ultima modifica il 26 settembre 2026