---
title: Canali di pagamento
description: Come i clienti ricaricano il proprio portafoglio in NexCMP: i canali disponibili, come abilitarli,commissioni, limiti e monitoraggio.
url: https://nexcmp.com/it/docs/billing/payment-channels/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Canali di pagamento {#payment-channels}

> **Dove si trova nell'amministrazione:** Finance › Payment channels (`/payments`). Interruttori e commissioni: Finance › Payment channels › Fees & limits (`/payments/fees`).

NexCMP utilizza un **portafoglio USD prepagato**. I clienti aggiungono fondi al portafoglio tramite un canale di pagamento; ogni servizio viene quindi pagato dal portafoglio. Un canale viene mostrato ai clienti solo quando è sia **abilitato** che **configurato**.

## Descrizione {#what-it-does}

I canali di pagamento collegano i tuoi conti di pagamento (Stripe, PayPal, Binance, una banca vietnamita) al portafoglio del cliente. Un pagamento confermato diventa esattamente un accredito sul portafoglio — ogni accredito è identificato dall'ID di pagamento del gateway, in modo che un webhook duplicato non possa mai aggiungere fondi due volte. Usa questa pagina per verificare quali canali sono pronti, le loro prestazioni negli ultimi 30 giorni e quali richiedono attenzione.

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Indirizzo HTTPS pubblico | I gateway inviano i webhook a `https://<domain>/v1/billing/...`, quindi il tuo pannello deve essere raggiungibile da Internet tramite TLS valido (vedi [DNS and Cloudflare](https://nexcmp.com/it/docs/getting-started/dns-and-cloudflare/)). |
| Account | Il tuo account personale presso ciascun provider che desideri utilizzare. Le credenziali vengono inserite nell'amministrazione e non vengono mai più mostrate (solo gli ultimi 4 caratteri). |
| Ruolo amministratore | Un account amministratore. |
| Dipendenze | Nessuno. Il canale bancario VN richiede inoltre un [tasso di cambio](https://nexcmp.com/it/docs/catalog/currency-and-exchange-rates/). |

## I canali {#the-channels}

| Canale | Cosa vede il cliente | Configurato in | Articolo |
|---|---|---|---|
| Carta (Stripe) | Modulo carta, carta salvata | Payment channels › Stripe | [Stripe](https://nexcmp.com/it/docs/billing/stripe/) |
| Apple Pay, Google Pay, Link | Pulsanti digitali (Stripe Express Checkout) | Stripe, più registrazione del dominio | [Stripe](https://nexcmp.com/it/docs/billing/stripe/#apple-pay-google-pay-and-link) |
| Alipay | Reindirizzamento ad Alipay (addebitato in JPY da Stripe) | Stripe, più Fees & limits | [Stripe](https://nexcmp.com/it/docs/billing/stripe/#alipay) |
| PayPal | Pulsanti PayPal, account PayPal salvato | Payment channels › PayPal | [PayPal](https://nexcmp.com/it/docs/billing/paypal/) |
| USDT | Indirizzo di deposito e importo esatto | Payment channels › USDT | [USDT](https://nexcmp.com/it/docs/billing/usdt/) |
| Bonifico bancario VN | Codice QR e dettagli di bonifico (solo interfaccia in vietnamita) | Payment channels › VN bank transfer | [Bonifico bancario (Vietnam)](https://nexcmp.com/it/docs/billing/bank-transfer-vn/) |

## Prepara l'infrastruttura {#prepare-the-infrastructure}

Non richiesto. Tutto è configurato nell'amministrazione; non c'è nulla da installare sul server.

## Collega in NexCMP {#connect-in-nexcmp}

1. Apri **Finance › Payment channels** (`/payments`). La tabella di panoramica elenca ogni canale con il suo stato.
2. Apri la scheda specifica del canale (**Stripe**, **PayPal**, **USDT**, **VN bank transfer**) e segui il relativo articolo. Ogni scheda termina con un pulsante **Save** e, dove disponibile, un pulsante **Test**.
3. Apri **Fees & limits** (`/payments/fees`), individua la voce **Payment gateways & fees (wallet top-up)** delle carte, attiva il canale con il relativo interruttore e fai clic su **Save channels & fees**.

![Panoramica dei canali di pagamento che elenca i gateway con il loro stato di attivazione, configurazione e le statistiche a 30 giorni](https://nexcmp.com/it/docs/images/billing/payment-channels-01-overview.webp)

![Pagina Commissioni e limiti con gli interruttori dei canali e i campi delle commissioni](https://nexcmp.com/it/docs/images/billing/payment-channels-02-fees.webp)

### Interruttori e commissioni (Fees & limits) {#switches-and-fees-fees-limits}

| Impostazione | Predefinito | Significato |
|---|---|---|
| Carta (Stripe) | On | Modulo carta nella schermata di deposito. Nascondono finché Stripe non dispone di una chiave segreta. |
| Apple Pay, Google Pay, Link | On | Pulsanti di portafoglio. Vengono visualizzati solo quando il dominio è verificato su Stripe. |
| Alipay | Disattivato | Richiede Alipay attivato nella Dashboard di Stripe. |
| PayPal | Disattivato | Mostrato solo quando PayPal è configurato. |
| USDT (Binance) | Disattivato | L'interruttore è bloccato finché l'indirizzo di deposito non viene verificato con Binance. |
| Commissione Stripe % / fissa (centesimi) | 3.6 % e 0 | Utilizzato per mostrare al cliente la commissione e calcolare l'importo accreditato. Impostalo sulla tua tariffa Stripe effettiva. |
| Commissione PayPal % / fissa | 4.4 % e 30 cents | Lo stesso, per PayPal. |
| Commissione USDT % | 1 % | Lo stesso, per USDT. |
| Il cliente paga la commissione di ricarica | Disattivato | **On**: il cliente paga l'importo + la commissione e il portafoglio riceve l'importo completo. **Off**: la commissione viene detratta e il portafoglio riceve l'importo meno la commissione. |

Il cliente vede sempre la commissione e il credito finale del portafoglio prima di pagare. Disattivando un canale, il pulsante viene nascosto e il server rifiuta i nuovi pagamenti con `method_disabled` (HTTP 403).

::: tip Limiti di ricarica
L'importo minimo e massimo per ricarica si trovano nella stessa pagina — vedi [Minimum top-up](https://nexcmp.com/it/docs/billing/minimum-top-up/).
:::

## Verifica {#verify}

1. Nella tabella di panoramica il canale mostra **Enabled** e **Configured**; la colonna **Last test** viene compilata dopo aver cliccato su **Test** nella scheda del canale.
2. Accedi al portale come cliente di test e apri **Billing › Deposit**. Il pulsante del canale è presente.
3. Effettua un piccolo pagamento (vedi l'articolo del canale per le carte di test o gli account sandbox). Il saldo aumenta, viene visualizzata una notifica di **Top-up received** e il pagamento è elencato in **Finance › Billing › Top-ups** (`/billing/deposits`).

## Limiti e note {#limits-notes}

- **Colonne della panoramica:** *30 days* (numero di pagamenti, successi, fallimenti e volume), *Stuck 24h* (pagamenti ancora in sospeso dopo un giorno) e *Unmatched* (USDT o bonifici bancari arrivati ma non associati ad alcun ordine). La riga dei KPI aggiunge il volume a 30 giorni, il numero di canali difettosi (abilitati ma non configurati o con pagamenti bloccati) e il totale non abbinato.
- **Eventi webhook** sono elencati in **Payment channels › Gateway events** (`/payments/events`). Stripe ha la sua scheda; PayPal e USDT ne condividono una. Un evento non riuscito può essere rieseguito: il registro del portafoglio è idempotente, quindi la riesecuzione non accredita mai due volte.
- I **Resellers** possono avere i propri canali Stripe, PayPal, USDT e bancari. Le loro righe compaiono anche qui e il selettore del sito nell'intestazione li filtra. Vedi [Resellers](https://nexcmp.com/it/docs/customers/resellers/).
- **Rimborsi:** i pagamenti Stripe e PayPal possono essere rimborsati dall'elenco dei pagamenti; i pagamenti USDT non possono essere rimborsati alla fonte (il server risponde con `usdt_no_refund`).
- **Modalità di manutenzione:** accetta comunque i webhook del gateway, quindi un pagamento effettuato poco prima della manutenzione non va perso.

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| Canale mancante nella schermata di deposito del cliente | Disattivato, non configurato o (banca vietnamita) l'interfaccia non è in vietnamita | Controlla **Fees & limits** e la scheda del canale; vedi [Bank transfer (Vietnam)](https://nexcmp.com/it/docs/billing/bank-transfer-vn/). |
| Il KPI **Faulty channels** è superiore a 0 | Un canale è abilitato senza credenziali oppure i pagamenti sono in sospeso da più di 24 ore | Apri la riga e clicca su **Configure**; per i pagamenti bloccati apri **Gateway events** ed esegui nuovamente. |
| Il cliente ha pagato ma il saldo non è cambiato | Il webhook non è arrivato | Controlla l'URL del webhook nella scheda del canale, quindi riesegui l'evento in **Gateway events**. |
| Il server risponde con `method_disabled` | L'interruttore è disattivato | Attivalo in **Fees & limits** e salva. |
| L'interruttore USDT è disabilitato (grigio) | Indirizzo di deposito non verificato | Clicca su **Test & verify address** nella scheda USDT. |
