← Tutti i tutorial

GUIDA 13 / 13

Aggiungi i pagamenti con carta al tuo checkout crypto.

Collega il tuo conto provider, provalo e abilita le carte nei negozi che scegli.

Cosa otterrai

Checkout con carta insieme ai pagamenti wallet, con USDC su Base ricevuto nel wallet della fattura.

1. Controlla il tuo conto Coinflow

Usa Wholly Crypto 9.0.0 o successivo. Chiedi a Coinflow di approvare la tua attività e abilitare gli accrediti USDC su Base a indirizzi diversi per fattura. In produzione, il cliente deve pagare le commissioni del provider e non devono esserci riserve o trattenute sugli accrediti.

Disponibilità, verifiche d’identità, limiti e commissioni dipendono dal conto Coinflow e dalla posizione del cliente. Controlla il prezzo finale su Coinflow prima di pagare.

Documentazione Coinflow · Provider on-ramp attuale

2. Collega e prova nella sandbox

Apri Settings → Fiat payments. Salva merchant ID Coinflow, API key e Webhook Validation Key. Aggiungi in Coinflow l’URL di callback mostrato e controlla la connessione. Tieni le credenziali sul server; non condividere mai le chiavi dei wallet.

Il checkout sandbox dell’amministratore è un test separato da 10 USD con indirizzo di ricezione sandbox. Non paga una fattura di produzione. Una connessione riuscita da sola non conferma l’idoneità dell’attività o del pagamento.

3. Abilita USDC su Base nel negozio

Fai il backup del wallet del progetto e controlla lo scanner Base. In Store → Payment methods, accetta USDC nativo su Base e abilita le carte. Usa USDC, non USDbC o USDC su Ethereum. Una fattura senza USDC su Base non offrirà le carte.

4. Prova un piccolo pagamento reale

Dopo l’approvazione di Coinflow, abilita la produzione e crea una normale fattura manualmente o via API. Scegli la carta al checkout. La fattura mantiene valuta, quotazione e spread originali; Coinflow mostra al cliente commissioni finali e cambio prima del pagamento.

5. Verifica la ricezione prima di consegnare

Una fattura è saldata solo quando arriva l’USDC e rispetta la tua politica di conferme blockchain. Un’autorizzazione della carta o il ritorno al checkout non prova il pagamento.

Controlla i dettagli Card payment della fattura e la transazione USDC su Base. Mantieni il normale flusso con IPN o webhook firmati. Agisci su invoice.settled e controlla requires_review; non consegnare mai solo per il ritorno del browser. Pagamenti tardivi o contrastanti possono richiedere revisione.

API, IPN e webhook

6. Trasferisci i fondi e gestisci le eccezioni

Tieni ETH su Base per inviare l’USDC ricevuto al tuo cold wallet, oppure configura finanziamento gas e sweep automatici. Gestisci rimborsi carta e chargeback in Coinflow. Non rimborsare mai crypto al mittente della transazione del provider. Controlla le contestazioni in Needs attention.

Invio automatico dei fondi