Canali di pagamento
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
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
| 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). |
| 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. |
I canali
| Canale | Cosa vede il cliente | Configurato in | Articolo |
|---|---|---|---|
| Carta (Stripe) | Modulo carta, carta salvata | Payment channels › Stripe | Stripe |
| Apple Pay, Google Pay, Link | Pulsanti digitali (Stripe Express Checkout) | Stripe, più registrazione del dominio | Stripe |
| Alipay | Reindirizzamento ad Alipay (addebitato in JPY da Stripe) | Stripe, più Fees & limits | Stripe |
| PayPal | Pulsanti PayPal, account PayPal salvato | Payment channels › PayPal | PayPal |
| USDT | Indirizzo di deposito e importo esatto | Payment channels › USDT | USDT |
| Bonifico bancario VN | Codice QR e dettagli di bonifico (solo interfaccia in vietnamita) | Payment channels › VN bank transfer | Bonifico bancario (Vietnam) |
Prepara l'infrastruttura
Non richiesto. Tutto è configurato nell'amministrazione; non c'è nulla da installare sul server.
Collega in NexCMP
- Apri Finance › Payment channels (
/payments). La tabella di panoramica elenca ogni canale con il suo stato. - 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.
- 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.
Interruttori e commissioni (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).
Limiti di ricarica
L'importo minimo e massimo per ricarica si trovano nella stessa pagina — vedi Minimum top-up.
Verifica
- 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.
- Accedi al portale come cliente di test e apri Billing › Deposit. Il pulsante del canale è presente.
- 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
- 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.
- 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
| 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). |
| 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. |