Documentazione API
API RESTful per integrare NEXFY PAY nel tuo software
Base URL: https://nexfypay.com/api/v1
Autenticazione
L'API usa JWT Bearer Token. Includi l'header in ogni richiesta:
Authorization: Bearer YOUR_ACCESS_TOKEN
Auth
POST/auth/register
Registra un nuovo utente
POST/auth/login
Login e ottenimento token
POST/auth/refresh
Rinnova access token
GET/auth/me
Profilo utente + wallet + carte
Wallet
GET/wallets
Lista wallet con IBAN e saldi
POST/wallets/:id/sepa-transfer
Esegui bonifico SEPA / SEPA Instant
Carte
GET/cards
Lista carte
POST/cards
Emetti nuova carta virtuale/fisica
POST/cards/:id/freeze
Congela/riattiva carta
Transazioni
GET/transactions
Storico movimenti con filtri
GET/transactions/stats
Statistiche periodo
POS Digitale
POST/pos/payment-link
Crea link di pagamento
GET/pos/payment-links
Lista link + stats
Fatturazione
POST/invoices
Crea fattura elettronica
POST/invoices/:id/send
Invia a SDI
GET/invoices/:id/xml
Scarica XML FatturaPA
Rewards & Savings
GET/rewards/overview
Panoramica referral + cashback
GET/savings/overview
Salvadanai + interessi
AI Commercialista
GET/ai/dashboard
Scadenze, IVA, cash flow, insights
GET/ai/calendar
Calendario fiscale completo
Accesso API
L'API è disponibile per i clienti Piano Scale. Contattaci per ottenere le credenziali API: [email protected]