# Collega il tuo account Airwallex

> Incassa con carte e metodi di pagamento locali come Alipay, WeChat Pay, GrabPay e FPX con il tuo account Airwallex. In Impostazioni > Pagamenti, clicca su Configura Airwallex, incolla il tuo Client ID e la chiave API, aggiungi il nostro URL webhook in Airwallex e incolla il suo segreto, scegli Demo o Live, attivalo e clicca su Salva impostazioni.

Centro assistenza / Pagamenti - Aggiornato il 19 novembre 2026

Airwallex è un fornitore di pagamenti per le aziende di Asia-Pacifico, Europa e Nord America. Quando colleghi il tuo account Airwallex, i tuoi clienti possono pagare con carta o con i metodi di pagamento locali che hai attivato in Airwallex, come Alipay, WeChat Pay, GrabPay, FPX e PayNow. I pagamenti vanno direttamente sul tuo account Airwallex e Shoprocket prende lo 0 %.

Quando un cliente clicca su **Paga ora**, il modulo di pagamento sicuro di Airwallex si apre direttamente nel tuo checkout. Il cliente paga lì, senza lasciare il tuo negozio. I dati della carta vanno direttamente ad Airwallex e non passano mai da Shoprocket.

## Prima di iniziare

Ti serve un account Airwallex con i pagamenti online attivi. Ti servono anche tre cose:

1. Un **Client ID** e una **API key**. In Airwallex, vai in **Developer > API keys** e crea una chiave con restrizioni. Dalle accesso in lettura e scrittura a **Payment Acceptance** e a nient'altro. Airwallex mostra la chiave API una sola volta, quindi copiala subito.
2. Un **segreto del webhook**. Il webhook lo crei in Airwallex con un URL fornito da Shoprocket, quindi il segreto lo ottieni durante i passaggi di configurazione qui sotto.
3. Sapere se le tue chiavi vengono dal tuo account **demo** (per fare prove) o dal tuo account **live**.

## Collegare Airwallex

1. Nella tua dashboard, vai in **Impostazioni > Pagamenti**.
2. Sulla scheda di Airwallex, in **Gateway di pagamento**, clicca su **Configura Airwallex**.
3. Incolla il tuo **Client ID** e la tua **API key** nei campi con lo stesso nome.
4. In **Environment**, scegli **Demo** per le chiavi del tuo account demo, o **Live** per il tuo account live.
5. Copia l'**URL del webhook** mostrato sotto i campi.
6. In Airwallex, vai in **Developer > Webhooks** e aggiungi un webhook con quell'URL. Iscrivilo agli eventi **Payment Intent** e **Refund**, poi salvalo.
7. Airwallex mostra allora il segreto del webhook. Copialo nel campo **Webhook secret** in Shoprocket.
8. Porta l'interruttore di Airwallex su **Attivo** e clicca su **Salva impostazioni**.

![La scheda Airwallex in Impostazioni > Pagamenti: i campi per Client ID, chiave API, segreto del webhook e ambiente, con l'URL del webhook da copiare sotto](https://shoprocket.io/img/help/connect-airwallex/airwallex-setup.webp)

Quando salvi, Shoprocket accede ad Airwallex con il tuo Client ID e la tua chiave API. Se Airwallex li rifiuta, non viene salvato nulla e un messaggio in alto sullo schermo ne spiega il motivo. L'errore più comune è scegliere l'ambiente sbagliato. Le chiavi demo funzionano solo con **Demo** e le chiavi live solo con **Live**.

La scheda mostra allora **Collegato** e Airwallex compare nel tuo checkout.

## Perché il webhook è importante

Alcuni metodi di pagamento si concludono dopo che il cliente ha lasciato il tuo checkout, per esempio un codice QR pagato in un'app bancaria. Airwallex informa Shoprocket di ogni pagamento e rimborso tramite il webhook. Shoprocket controlla poi il pagamento con Airwallex prima di segnare l'ordine come pagato. Il webhook è anche il modo in cui un rimborso fatto in Airwallex compare sull'ordine in Shoprocket.

I pagamenti con carta vengono confermati subito anche senza il webhook, ma aggiungilo prima di iniziare a vendere.

## Le valute che puoi accettare

Quando salvi, Shoprocket legge le valute in cui il tuo account Airwallex accetta pagamenti con carta. Se un cliente va al checkout in una valuta in cui il tuo account non accetta carte, il pagamento non può passare da Airwallex. Il checkout gli chiede allora di scegliere un altro modo di pagare. Per accettare più valute, attivale in Airwallex, poi salva di nuovo le tue credenziali Airwallex in Shoprocket.

Se il tuo account accetta carte in una sola valuta e il tuo negozio ha i prezzi in un'altra, la scheda ti avvisa. Puoi comunque offrire Airwallex ai clienti che pagano in quella valuta. Per farlo, aggiungi la valuta in **Gateway carte per valuta**, come spiega [Scegliere un gateway di pagamento](https://shoprocket.io/it/aiuto/scegliere-un-gateway-di-pagamento.md).

## Provalo in modalità demo

Airwallex ti dà un account demo con le sue chiavi. Per provare il tuo checkout senza muovere denaro reale, scegli **Demo** e incolla le tue chiavi demo. La scheda mostra allora **Credenziali di test: nessun denaro reale si muove**. La documentazione di Airwallex elenca i numeri di carta di prova che puoi usare.

Quando sei pronto a vendere, clicca su **Modifica le credenziali di Airwallex**, incolla il tuo Client ID e la tua chiave API live, scegli **Live** e incolla il segreto di un webhook creato nel tuo account live. Poi clicca su **Salva impostazioni**.

## Come pagano i tuoi clienti

- **Con carta**: il cliente inserisce la carta nel modulo di Airwallex nel tuo checkout. Se la sua banca deve verificare il pagamento, la verifica si apre anche lì. Se la carta viene rifiutata, può provarne un'altra nello stesso modulo.
- **Con un metodo di pagamento locale**: il cliente lo sceglie nello stesso modulo e segue i passaggi, per esempio scansionare un codice QR o approvare il pagamento nella sua app. L'ordine viene confermato non appena Airwallex ci comunica che il pagamento è andato a buon fine.

Un cliente che cambia idea può cliccare su **Scegli un altro modo di pagare** sotto il modulo per tornare al carrello.

Apple Pay e Google Pay non sono ancora disponibili tramite Airwallex.

## Rimborsi

Quando rimborsi un ordine pagato con Airwallex, il denaro torna automaticamente al cliente, per intero o in parte. Vedi [Rimborsa un ordine](https://shoprocket.io/it/aiuto/rimborsare-un-ordine.md). I rimborsi vengono prelevati dal tuo saldo Airwallex, quindi tieni abbastanza fondi per coprirli.

## Abbonamenti

Airwallex può rinnovare gli abbonamenti. Quando un cliente acquista un abbonamento, la carta con cui paga viene salvata nel tuo account Airwallex. Ogni rinnovo viene poi addebitato su quella carta secondo la cadenza dell'abbonamento.

## Cambiare le credenziali o disattivarlo

Una volta collegato Airwallex, il suo pulsante dice **Modifica le credenziali di Airwallex**. Le credenziali salvate sono conservate cifrate e non vengono più mostrate. Per tenerle, lascia i campi vuoti. Per sostituirle, compila tutti i campi e clicca su **Salva impostazioni**.

Per smettere di offrire Airwallex, porta il suo interruttore su **Disattivo** e clicca su **Salva impostazioni**. Le credenziali restano salvate, quindi puoi riattivarlo quando vuoi. I pagamenti che i clienti avevano già avviato vengono comunque completati.

## Articoli correlati

- [Scegliere un gateway di pagamento](https://shoprocket.io/it/aiuto/scegliere-un-gateway-di-pagamento.md)
- [Rimborsare un ordine](https://shoprocket.io/it/aiuto/rimborsare-un-ordine.md)
- [Effettua un ordine di test](https://shoprocket.io/it/aiuto/effettuare-un-ordine-di-test.md)

[Apri Pagamenti nella tua dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/it/aiuto/collega-airwallex
- Language: Italiano (it)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-airwallex.md), [Deutsch](https://shoprocket.io/de/hilfe/airwallex-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-airwallex.md), [English](https://shoprocket.io/help/connect-airwallex.md), [Español](https://shoprocket.io/es/ayuda/conectar-airwallex.md), [Français](https://shoprocket.io/fr/aide/connecter-airwallex.md), [עברית](https://shoprocket.io/he/help/connect-airwallex.md), [हिन्दी](https://shoprocket.io/hi/help/connect-airwallex.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-airwallex.md), [日本語](https://shoprocket.io/ja/help/connect-airwallex.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-airwallex-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-airwallex-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/airwallex-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-airwallex.md), [Português](https://shoprocket.io/pt/ajuda/conectar-airwallex.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-airwallex.md), [Русский](https://shoprocket.io/ru/help/connect-airwallex.md), [ไทย](https://shoprocket.io/th/help/connect-airwallex.md), [Türkçe](https://shoprocket.io/tr/yardim/airwallex-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-airwallex.md)
