Cosa ti serve
| Campo | Cosa fa |
|---|---|
| API key | Ci permette di chiamare NOWPayments per creare il pagamento. Segreta. |
| IPN secret | Conferma che una notifica di pagamento provenga davvero da NOWPayments. Segreta. |
| URL di conferma / URL di annullamento | Dove arriva il cliente dopo aver pagato o essersi tirato indietro. |
IPN (Instant Payment Notification) è il nome che NOWPayments dà al webhook che invia quando lo stato di un pagamento cambia.
Perché chiediamo ogni campo
API key
Autorizza la creazione del pagamento, così i fondi incassano sul tuo account.
IPN secret
Dimostra che una notifica in arrivo provenga davvero da NOWPayments, così nessuno può falsificare un evento "pagato". È un valore separato dall'API key.
URL di conferma e annullamento
Impostazioni semplici: dove arriva il cliente dopo aver pagato o essersi tirato indietro. Non segrete.
Configurazione
- Test: non c'è sandbox
NOWPayments non ha sandbox o ambiente di test. Per verificare da capo a fondo, invia un piccolo pagamento reale in una moneta a bassa commissione e conferma che appaia nella tua dashboard. Tratta quel primo piccolo pagamento come il tuo test. Un account NOWPayments è gratuito; paghi solo le normali commissioni di rete e di servizio sui pagamenti reali.
- Apri Impostazioni pagamenti in NOWPayments
Accedi su account.nowpayments.io e vai su Settings → Payments. Questa singola schermata contiene le tre cose di cui hai bisogno: Payout wallets (dove arrivano i fondi), API keys e Instant payment notifications. Le visiterai una per una.
NOWPayments → Settings → Payments - Aggiungi un payout wallet
NOWPayments sblocca l'API solo quando hai un payout wallet registrato. Nella sezione Payout wallets, fai clic su Add new wallet, scegli una valuta, incolla l'indirizzo di un wallet che controlli e fai clic su Add wallet. È l'indirizzo su cui si regola la tua crypto.
NOWPayments → Payout wallets → Add new wallet - Crea una API key
Apri API keys e fai clic su Add new API key. Le tue chiavi sono elencate qui, ognuna con un'icona di copia, così puoi tornare e ricopiare una chiave in qualsiasi momento.
NOWPayments → Settings → API keys - Copia la tua API key
NOWPayments mostra la nuova chiave in una finestra "API key created". Fai clic sull'icona di copia accanto a Your API key e mettila da parte. (La public key sotto di essa non è necessaria per Coin Moebius.) Puoi aggiungere un'etichetta opzionale, poi fai clic su Save.
NOWPayments → API key created Questa è la tua API key segreta. Trattala come una password.
- Configura la callback IPN e copia il secret IPN
Apri Instant payment notifications. IPN (Instant Payment Notification) è il nome che NOWPayments dà al webhook inviato quando cambia lo stato di un pagamento.
- Nel campo Webhook URL, incolla l'indirizzo del webhook NOWPayments del tuo progetto (sotto), poi fai clic su Save.
- Copia la chiave IPN secret mostrata in cima (usa Regenerate se non c'è ancora un valore).
- Sotto Choose webhook format, seleziona Classic way così gli importi e gli ID restano nel loro normale formato numerico.
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → Instant payment notifications Il tuo id progetto si trova sotto il nome del progetto nella dashboard di Coin Moebius; inseriscilo nell'indirizzo sopra. La card del provider collegato (ultimo passaggio) mostra lo stesso URL, così puoi ricopiarlo in qualsiasi momento.
- Torna in Coin Moebius: Aggiungi provider → NOWPayments
Nel tuo progetto, apri la scheda Provider, fai clic su Aggiungi provider, scegli Collega un servizio e seleziona NOWPayments. Incolla la tua API key e il tuo IPN secret, imposta l'URL di conferma e l'URL di annullamento (dove i clienti arrivano dopo aver pagato o essere usciti), poi fai clic su Salva.
Coin Moebius → Aggiungi provider → NOWPayments - Sei collegato
NOWPayments ora appare nella scheda Provider con la data di collegamento. La card mostra lo stesso URL di webhook che hai incollato in NOWPayments, più Modifica e Scollega. Poiché NOWPayments non ha sandbox, non possiamo verificare automaticamente il secret IPN, quindi la card offre un test con micro-pagamento: invia un piccolo pagamento reale per confermare che tutto funzioni da capo a fondo.
Coin Moebius → Provider → NOWPayments (collegato)
Dopo aver collegato
Non c'è sandbox, quindi il tuo primo piccolo pagamento reale è il test:
- Crea un prodotto e metti il pulsante di acquisto su una pagina (un file HTML locale va bene) puntato sul tuo progetto.
- Paga un piccolo importo in una moneta a bassa commissione.
- Apri la scheda Transazioni. Quando lo stato della nuova riga raggiunge succeeded, la tua API key e l'IPN secret funzionano entrambi da capo a fondo.
Risoluzione dei problemi
Il pagamento si completa ma l'ordine resta in sospeso.
L'IPN non arriva o non si verifica. Conferma che l'URL di callback corrisponda e che l'IPN secret nella dashboard corrisponda all'IPN Secret Key nelle tue impostazioni NOWPayments.
Nessun modo di testare senza pagare.
Esatto, non c'è sandbox. Invia un piccolo pagamento reale in una moneta a bassa commissione per far scattare un IPN genuino, poi guarda l'ordine aggiornarsi.
Lo stato cambia solo con attività reale.
Lo stato di NOWPayments riflette le consegne IPN, quindi un account silenzioso non mostra alcuno stato finché un pagamento reale non si muove.
Buono a sapersi
Nessuna modalità test. Verifica con un piccolo pagamento reale, non con un sandbox.
Ruotare i secret. Genera una nuova API key o IPN secret quando vuoi, poi incolla il nuovo valore.
Domande? Join our Discord