Cosa ti serve
| Campo | Cosa fa |
|---|---|
| API key ID | Identifica la tua chiave API MakePay così chiamiamo il tuo account. |
| API key secret | Ci permette di creare i checkout MakePay sul tuo account. Segreta. |
| Webhook secret | Conferma che un webhook provenga davvero da MakePay. Segreta. |
| URL di conferma | Dove arriva il cliente dopo un pagamento completato. |
| URL di annullamento | Dove arriva il cliente se il pagamento fallisce o lo cancellano. |
MakePay emette l'API key ID e il secret insieme quando generi una chiave; il webhook secret è un valore separato dalle impostazioni di callback.
Perché chiediamo ogni campo
API key ID
Nomina quale chiave MakePay autentichiamo. Non segreto da solo, ma è abbinato al secret qui sotto.
API key secret
Autorizza la creazione del checkout, così il pagamento passa per il tuo account MakePay e si regola nel tuo wallet. MakePay lo mostra una sola volta, subito dopo aver generato la chiave.
Webhook secret
Dimostra che un webhook in arrivo provenga davvero da MakePay, così nessuno può falsificare un evento "pagato". È un valore separato dalla chiave API.
URL di conferma e annullamento
Impostazioni semplici: dove arriva il cliente dopo aver pagato o dopo un pagamento fallito o cancellato. Non segreti.
Configurazione
- Genera una chiave API in MakePay
Accedi a MakePay e apri API & SDK → API integrations. Sotto API keys, fai clic su Generate API Key, dagli un nome tipo "Coin Moebius" e creala. MakePay mostra l'API key ID e il suo secret una sola volta, subito dopo la generazione — copia entrambi adesso, perché il secret non si mostra di nuovo.
MakePay → API & SDK → API integrations → Generate API Key Tratta il secret della chiave API come una password. Se lo perdi, genera una nuova chiave piuttosto che cercare di recuperare la vecchia.
- Trova l'id del tuo progetto Coin Moebius
In una scheda separata, apri il tuo progetto nella dashboard Coin Moebius e copia l'id del progetto da sotto il nome del progetto. L'URL del callback di MakePay è quell'id inserito nell'indirizzo qui sotto — lo incollerai in MakePay nel passo prossimo.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → il tuo progetto → id del progetto La card del provider collegato (ultimo passo) mostra lo stesso URL, così puoi ricopiarlo in qualsiasi momento.
- Imposta l'URL di callback e copia il webhook secret
Tornato in MakePay, scorri a Delivery → Callback URL configuration. Fai clic su Edit Callback URL, incolla il tuo URL di webhook Coin Moebius come destinazione attiva e salva. Poi, sotto Webhook signing, copia il signing secret (usa Regenerate secret se non c'è ancora un valore) — quello è il Webhook secret che Coin Moebius chiede.
MakePay → Delivery → Callback URL configuration MakePay pubblica gli aggiornamenti di consegna a questo indirizzo dopo ogni cambio di stato visibile al merchant. Il signing secret è separato dalla chiave API — ti serve entrambi.
- Collega nella dashboard Coin Moebius
In Coin Moebius, apri Aggiungi provider → MakePay. Incolla il tuo API key ID, API key secret e Webhook secret, poi imposta l'URL di conferma e l'URL di annullamento (dove i clienti arrivano dopo aver pagato o dopo un pagamento fallito). Fai clic su Salva.
Coin Moebius → Aggiungi provider → MakePay I segreti salvati restano nascosti. Per cambiarne uno in seguito, scegli Replace e inserisci il nuovo valore.
- Sei collegato
MakePay ora appare nella scheda Provider con la data di collegamento e l'URL di webhook che si aspetta. Se non l'hai già fatto, incolla quell'URL nelle impostazioni di callback di MakePay. Usa Modifica per ruotare le chiavi o Scollega per rimuoverlo, e il toggle Modalità test per completare un ordine senza influire sui tuoi numeri reali.
Coin Moebius → Provider → MakePay (collegato)
Dopo aver collegato
Completa un ordine prima di andare in produzione:
- Attiva il toggle Modalità test sulla card MakePay collegata per completare un ordine senza influire sui tuoi numeri reali.
- Crea un prodotto e metti il pulsante di acquisto su una pagina (un file HTML locale va bene) puntato al tuo progetto.
- Completa il checkout attraverso MakePay.
- Apri la scheda Transazioni. Quando lo stato della nuova riga raggiunge succeeded, le tue chiavi e il webhook funzionano entrambi da capo a fondo.
Spegni la Modalità test quando sei pronto per i pagamenti reali.
Risoluzione dei problemi
Inizia dal dashboard: conferma che la card MakePay mostri collegato e che l'URL del webhook corrisponda alla destinazione di callback salvata in MakePay.
Il pagamento si completa ma l'ordine resta in sospeso.
Il webhook non arriva o non si verifica. Conferma che l'URL di callback in MakePay corrisponda esattamente all'URL del webhook del tuo progetto, e che il Webhook secret in Coin Moebius corrisponda al signing secret in MakePay.
Il salvataggio del provider viene rifiutato.
L'API key ID, API key secret e Webhook secret sono tutti obbligatori. Ricopia tutti da MakePay — il secret si mostra una sola volta, quindi genera una nuova chiave se non lo hai più.
Un ordine di prova non appare mai in Transazioni.
Attiva il toggle Modalità test per la card MakePay prima di eseguire il pulsante di acquisto, e assicurati che il prodotto punti allo stesso progetto.
Buono a sapersi
Non-custodiale. MakePay regola la cripto dritto nel tuo wallet. Coin Moebius non detiene mai i fondi e non può muoverli.
Ruotare i segreti. Genera una nuova chiave API o rigenera il webhook signing secret in qualsiasi momento, poi scegli Replace nella dashboard e incolla il nuovo valore. I campi segreti restano vuoti in modifica.
Domande? Join our Discord