# Collega il tuo account Xendit

> Incassa con carte, QRIS, portafogli elettronici e bonifici bancari nel Sud-est asiatico con il tuo account Xendit. In Impostazioni > Pagamenti, clicca su Configura Xendit, incolla la tua chiave API segreta e il token di verifica del webhook, scegli il tuo paese, aggiungi il nostro URL webhook in Xendit, attivalo e clicca su Salva impostazioni.

Centro assistenza / Pagamenti - Aggiornato il 19 novembre 2026

Xendit è un fornitore di pagamenti per le aziende di Indonesia, Filippine, Vietnam, Thailandia, Singapore e Malesia. Quando colleghi il tuo account Xendit, i tuoi clienti possono pagare con carta, scansionando un codice QRIS, con portafogli elettronici come OVO, DANA, GoPay, ShopeePay, GCash e Maya, con bonifico bancario su un conto virtuale o in un punto vendita, a seconda dei metodi di pagamento che hai attivato in Xendit. I pagamenti vanno direttamente sul tuo account Xendit e Shoprocket prende lo 0 %.

Quando un cliente clicca su **Paga ora**, va alla pagina di pagamento sicura di Xendit per scegliere come pagare, poi torna nel tuo negozio. I dati della carta vanno direttamente a Xendit e non passano mai da Shoprocket.

## Prima di iniziare

Ti servono un account Xendit e tre cose dalla tua dashboard di Xendit:

1. La tua **chiave API segreta**, in **Settings > API keys**. Quando crei la chiave, dalle accesso in scrittura a **Money-in**, così può incassare pagamenti e fare rimborsi.
2. Il tuo **token di verifica del webhook**, in **Settings > Webhooks**.
3. Il paese in cui è registrato il tuo account Xendit.

## Collegare Xendit

1. Nella tua dashboard, vai in **Impostazioni > Pagamenti**.
2. Sulla scheda di Xendit, in **Gateway di pagamento**, clicca su **Configura Xendit**.
3. Incolla la tua **Secret API key** e il tuo **Webhook verification token** nei campi con lo stesso nome.
4. In **Country**, scegli il paese in cui è registrato il tuo account Xendit.
5. Copia l'**URL del webhook** mostrato sotto i campi.
6. Nella dashboard di Xendit, vai in **Settings > Webhooks**. Incolla l'URL nei campi webhook per **Payment Session**, **Payments** e **Refunds**, e salvali.
7. Tornato in Shoprocket, porta l'interruttore di Xendit su **Attivo** e clicca su **Salva impostazioni**.

![La scheda Xendit in Impostazioni > Pagamenti: i campi per la chiave segreta, il token del webhook e il paese, con l'URL del webhook da copiare sotto](https://shoprocket.io/img/help/connect-xendit/xendit-setup.webp)

Quando salvi, Shoprocket controlla la tua chiave segreta con Xendit. Se Xendit la rifiuta, non viene salvato nulla e un messaggio in alto sullo schermo ne spiega il motivo. L'errore più comune è incollare la chiave pubblica, che inizia con `xnd_public_`. La chiave segreta inizia con `xnd_development_` o `xnd_production_`.

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

## Perché l'URL del webhook è importante

Molti clienti nel Sud-est asiatico completano il pagamento fuori dal tuo negozio. Un cliente potrebbe scansionare un codice QRIS con l'app della sua banca, approvare un pagamento con portafoglio elettronico sul telefono o pagare un conto virtuale ore dopo. Xendit informa Shoprocket di ogni pagamento tramite l'URL del webhook. Shoprocket controlla poi il pagamento con Xendit prima di segnare l'ordine come pagato.

Senza il webhook, un ordine pagato in questo modo può restare **In elaborazione** finché il cliente non torna nel tuo negozio. Aggiungi l'URL in Xendit prima di iniziare a vendere.

## La valuta accettata dal tuo account

Ogni account Xendit accetta pagamenti nella valuta del proprio paese: rupia indonesiana, peso filippino, dong vietnamita, baht thailandese, dollaro di Singapore o ringgit malese. Il paese che scegli determina la valuta, e la scheda la mostra dopo il salvataggio.

Se il tuo negozio ha i prezzi in un'altra valuta, la scheda ti avvisa. Xendit non può allora essere il tuo gateway per carte principale, ma puoi comunque offrirlo ai clienti che pagano nella sua valuta. Per farlo, aggiungi quella valuta in **Gateway carte per valuta**, come spiega [Scegliere un gateway di pagamento](https://shoprocket.io/it/aiuto/scegliere-un-gateway-di-pagamento.md).

Xendit accetta la rupia in importi interi. Se un prezzo ha dei centesimi, viene arrotondato alla rupia più vicina quando il cliente paga.

## Provalo in modalità di test

Xendit dà a ogni account una modalità di test con la propria chiave segreta, che inizia con `xnd_development_`. Incolla la chiave di test per provare il tuo checkout senza muovere denaro reale. La scheda mostra allora **Credenziali di test: nessun denaro reale si muove**. Sulla pagina di pagamento di test di Xendit puoi simulare un pagamento riuscito per ogni metodo di pagamento.

Quando sei pronto a vendere, clicca su **Modifica le credenziali di Xendit**, incolla la tua chiave segreta live (inizia con `xnd_production_`), scegli di nuovo il tuo paese e clicca su **Salva impostazioni**. Il token di verifica del webhook e gli URL del webhook si impostano separatamente per la modalità di test e quella live in Xendit, quindi aggiungi l'URL anche in modalità live.

## Come pagano i tuoi clienti

- **Con carta**: il cliente inserisce la carta sulla pagina di Xendit. Se la sua banca deve verificare il pagamento, la verifica si apre lì.
- **Con QRIS o un portafoglio elettronico**: il cliente scansiona il codice o approva il pagamento nell'app del suo portafoglio. L'ordine viene confermato non appena Xendit ci comunica che il pagamento è andato a buon fine.
- **Con un conto virtuale o in un punto vendita**: il cliente riceve un numero su cui pagare. L'ordine resta **In elaborazione** finché non paga, e gli articoli restano riservati finché la pagina di pagamento di Xendit è aperta.

Se un cliente lascia la pagina di Xendit senza pagare, può cliccare di nuovo su **Paga ora** dal carrello per tornare alla stessa pagina. Quando la pagina scade, ne viene aperta una nuova.

## Rimborsi

Quando rimborsi un ordine pagato con Xendit, il denaro torna automaticamente al cliente, per intero o in parte. Vedi [Rimborsa un ordine](https://shoprocket.io/it/aiuto/rimborsare-un-ordine.md). Alcuni portafogli elettronici e metodi di pagamento tramite bonifico bancario non possono essere rimborsati in parte, o per niente, tramite Xendit. In quel caso il rimborso risulta non riuscito con il motivo. Puoi allora rimborsare l'importo intero o restituire tu stesso il denaro al cliente. Un rimborso che fai nella dashboard di Xendit compare anche sull'ordine in Shoprocket.

I rimborsi vengono prelevati dal tuo saldo Xendit, quindi tieni abbastanza fondi per coprirli.

## Abbonamenti

Xendit non può ancora rinnovare gli abbonamenti su Shoprocket. Se vendi abbonamenti, tieni per quei prodotti un altro gateway per carte che li rinnovi, come Stripe.

## Cambiare le credenziali o disattivarlo

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

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