Passa al contenuto principale
In questa pagina

DEUNA supporta i pagamenti ricorrenti tramite il motore di abbonamenti DEUNA, un sistema di fatturazione di proprietà del commerciante, o caricamenti di batch ricorrenti. Inizia scegliendo chi decide cosa addebitare e quando; questa decisione determina il modello di integrazione e di funzionamento.

Scegli chi gestisce la fatturazione#

Il proprietario della fatturazione calcola ogni importo e decide quando è dovuto. L'elaborazione dei pagamenti esegue questa istruzione. Scegli un proprietario primario per evitare che due sistemi invino la stessa richiesta di addebito.

ApproccioLa soluzione miglioreproprietario di fatturazioneCome un addebito raggiunge DEUNA
Motore di abbonamento DEUNAImporti fissi o basati su piani che DEUNA deve programmareDEUNA, in base al piano configuratoIl motore crea ogni addebito programmato
Motore abbonato MerchantImporti variabili o logica di abbonamento esistenteIl tuo sistema di fatturazioneIl tuo backend chiama l'API di pagamento DEUNA
Caricamento in batchSistemi legacy che preparano i file di addebitoIl tuo sistema di fatturazione o il sistema legacyFornisci un batch concordato contenente token di sicurezza DEUNA appropriati
Motore di abbonamento DEUNAPianificazione basata su piani

Configura l'importo, la valuta, la frequenza, il comportamento di rinnovo, l'opzione di addebito iniziale differito e la politica di retry. Associa un cliente e un metodo di pagamento supportato a un piano; DEUNA quindi programma gli addebiti.

È necessario abilitare il motore e la classificazione dei pagamenti ricorrenti per il commerciante e il negozio richiesti. Il supporto del processore, la portabilità del token, il collegamento delle transazioni di rete e i requisiti di autenticazione possono limitare le connessioni idonee per gli addebiti successivi.

Motore abbonato MerchantIl tuo sistema programma ogni pagamento

Mantenere la logica di fatturazione e utilizzare API di pagamento DEUNA per ogni addebito. Il tuo sistema rimane responsabile del calcolo degli importi, dell'applicazione dell'accordo, della programmazione degli addebiti e della prevenzione di duplicati.

DEUNA può conservare identificatori di transazioni di rete supportati per collegamenti di transazioni avviati dal commerciante in seguito. Un token di archiviazione identifica le credenziali della carta; un identificatore di transazione di rete fa riferimento alla cronologia delle transazioni. Nessuno sostituisce il consenso del cliente e la portabilità dipende dal fornitore e dalla rete.

Caricamento in batchRaccolta basata su file

Utilizza questo modello quando una piattaforma esistente prepara gli addebiti programmati come file. Concorda con DEUNA sul formato di batch, sulla consegna sicura, sull'idoneità del token, sui processori supportati e sullo scambio dei risultati per ogni pagamento prima dell'implementazione.

Il batch di ricevimento non è un'approvazione di pagamento e l'autorizzazione non è il completamento. Concilia ogni elemento con il suo risultato di pagamento finale.

Ciclo di vita condiviso dei pagamenti ricorrenti#

Tutti e tre gli approcci richiedono la stessa base: accordo del cliente, credenziale riutilizzabile supportato, decisione esplicita di fatturazione, elaborazione dei pagamenti e riconciliazione.

Diagramma di flusso
1Customer agreement2Card capture andsetup3Billing ownercalculates amountand due date4DEUNA processespayment5Merchant reconcilesfinal result
Commerciante o clienteRisultatoDEUNA
Pagamenti ricorrenti, CIT e MITTerminologia di base
  • Pagamento ricorrente: un addebito raccolto ripetutamente in base a un accordo. L'importo può essere fisso, come un abbonamento, o variabile, come la fatturazione basata sull'utilizzo.
  • Transazione avviata dal cliente (CIT): un pagamento effettuato attivamente dal cliente, inclusa la prima transazione completata durante la registrazione.
  • Transazione avviata dal commerciante (MIT): un successivo pagamento con carta che la tua attività avvia in base all'accordo precedente senza la partecipazione attiva del cliente a tale pagamento.

"Recurring" descrive il modello di addebito; "MIT" descrive chi avvia il pagamento e con quale autorità. Salvare una carta da sola non autorizza addebiti successivi.

Ad esempio, un cliente può effettuare attivamente il primo addebito per un abbonamento mensile come "CIT" e autorizzare rinnovi successivi. Un successivo rinnovo automatico è un "MIT". In alternativa, è possibile tokenizzare la carta per un primo addebito differito.

Addebiti fissi e variabiliDefinire l'importo
ScenarioAccordo con il clienteDecisione di fatturazione
Affiliazione fissaUn importo definito su un programma ricorrenteIl programma configurato fornisce l'importo e l'intervallo di addebito
Variabile fatturaUn importo calcolato da un utilizzo o un prezzo divulgatoIl sistema di fatturazione del commerciante calcola l'importo prima di ogni addebito

Se l'importo può variare, verificare quale sistema lo calcola e che il modello selezionato supporti tali regole.

Motore di abbonamento DEUNA#

Il motore DEUNA organizza gli addebiti ricorrenti attorno a piani e abbonamenti dei clienti.

Ciclo di vita in sintesi

Diagramma di flusso
Activation succeedsPause policy takeseffectResumeCancellation takeseffectTerm completes1Plan available2Subscription pending3Active4Paused5Canceled6Expired or ended
Revisione o in sospesoEccezione o arresto

Le transizioni applicabili dipendono dal piano, dalla politica di cancellazione o di sospensione e dalla configurazione dell'account. Verificare il risultato del pagamento prima di considerare un pending abbonamento come attivo.

Riferimento al pianoCampi e periodi di fatturazione

Un piano definisce i termini commerciali e di programmazione utilizzati per le nuove abbonamenti.

ConfigurazioneOggetto
Nome, descrizione e gruppoIdentificare e organizzare l'offerta
Codice del pianoMappare il piano all'identificatore nel tuo sistema
Importo e valutaDefinire la tariffa fissa per ogni ciclo di fatturazione
Periodo di fatturazioneSelezionare la frequenza con cui DEUNA programma una fattura
Rinnovo automaticoDeterminare se l'abbonamento si rinnova dopo il termine
Inizio differitoProgrammare la prima fattura per una data successiva
StatoDeterminare se il piano è disponibile per nuovi abbonamenti

I periodi di fatturazione supportati sono DAILY, WEEKLY, BIWEEKLY, THIRTY_DAYS, SIXTY_DAYS, NINETY_DAYS, MONTHLY, BIMESTRIAL, QUARTERLY, ANNUAL, BIENNIAL, TRIANNUALe BIANNUAL.

Riferimento dell'abbonamentoStato e relazione con il cliente

Un abbonamento collega un cliente a un piano e registra il suo ciclo di vita, il metodo di pagamento, le date di fatturazione e le transazioni elaborate.

StatoSignificato
pendingCreato, ma l'attivazione o la prima fattura non sono state completate
activeAttivato dopo che il pagamento richiesto è stato completato con successo
pausedLe fatture programmate future sono sospese fino alla riattivazione dell'abbonamento
canceledL'annullamento è stato completato in base alla politica selezionata
expired o endedIl termine configurato è scaduto
Posticipo della prima fatturaGiorno specifico o numero di giorni

Un piano può programmare il primo addebito invece di addebitare immediatamente. Scegliere una delle modalità supportate:

  • Giorno specifico del mese: addebito nel giorno configurato del calendario. Ad esempio, un abbonamento creato il 3 ottobre con il primo giorno selezionato il 10, il primo addebito sarà effettuato il 10 ottobre.
  • Numero di giorni dopo l'acquisizione: addebito dopo il ritardo configurato. Ad esempio, un abbonamento creato il 5 ottobre con un ritardo di sette giorni effettuerà il primo addebito il 12 ottobre.

La carta viene tokenizzata al momento della creazione dell'abbonamento, anche se il pagamento inizia successivamente. La regola di inizio differita si applica agli abbonamenti creati con quel piano.

Politica di retryTentativi, tempi e stato finale

Configura il comportamento di riprova da Configurazione dell'abbonamento Scheda nell'area Amministrazione:

  • numero massimo di tentativi;
  • intervallo di ripetizione e la sua unità di misura: minuti, ore o giorni.
  • retroazione lineare o esponenziale; e
  • Passaggio a paused o canceled dopo aver esaurito i tentativi configurati.

La visualizzazione nel pannello di amministrazione mostra lo schema di tentativi calcolato prima del salvataggio. Coordinare la gestione del recupero con qualsiasi processo di riprova lato merchant per evitare di addebitare la stessa fattura due volte.

Utilizzare l'API per gli Abbonamenti#

Utilizzare l'autenticazione tramite chiave privata per le operazioni relative agli abbonamenti. L'API gestisce piani, abbonamenti clienti, modifiche delle carte memorizzate, azioni di ciclo di vita e storico.

AttivitàFine
Creare o elencare pianiCreare un piano · Elencare i piani
Recuperare o aggiornare un pianoOttenere un piano · Aggiornare un piano
Creare o elencare abbonamentiCrea un abbonamento · Elenco abbonamenti
Recuperare o aggiornare un abbonamentoOttenere un abbonamento · Aggiorna un abbonamento
Sostituire la carta memorizzataAggiornare la carta dell'abbonamento
Mettere in pausa o riattivare il pagamentoPausa · Riprendi
Annullare un abbonamentoAnnullamento
Visualizzare gli eventi del ciclo di vitaOttenere la cronologia degli abbonamenti

Gestisci l'Admin#

Apri Abbonamenti nella DEUNA AdminL'utente deve avere accesso al modulo Abbonamenti; la creazione di un piano richiede anche l'autorizzazione "Crea piano".

Creare un pianoProcedura di amministrazione
  1. Apri Abbonamenti e selezionare il Piani tab.
  2. Seleziona Creare un piano.
  3. Inserire il nome, il codice, la descrizione, il gruppo, l'importo, la valuta, la frequenza e il comportamento di rinnovo del piano.
  4. Configurare un avvio differito se la prima transazione deve avvenire in un momento successivo.
  5. Visualizzare le impostazioni e selezionare Salvare il piano.

Verificare che il piano salvato sia attivo e visualizzato nell'elenco dei Piani prima di assegnare nuovi abbonamenti.

Visualizzare abbonamenti e transazioniFiltri e dettagli
  1. Aprire Abbonamenti tab.
  2. Filtrare per indirizzo email del cliente, data di creazione, piano o stato.
  3. Aprire un abbonamento per visualizzare i dettagli del cliente, il piano associato, le date di fatturazione, l'importo, il metodo di pagamento, le transazioni e la cronologia del ciclo di vita.

Utilizzare i risultati delle transazioni, e non solo la presenza di una riga di abbonamento, per verificare se il pagamento è andato a buon fine.

Mettere in pausa, riprendere o annullareModifiche immediate o programmate

Aprire l'abbonamento, selezionare Azionie scegliere l'operazione desiderata.

PoliticaEffetto
ImmediatamenteApplica la pausa o l'annullamento ora
Fine del periodo di fatturazioneMantenere l'abbonamento attivo durante il periodo corrente, quindi applicare la modifica
Data specificaProgramma la modifica per la data futura selezionata

Aggiungi una motivazione, se disponibile, per preservare il contesto operativo. Un abbonamento messo in pausa può essere ripreso dal menu Azioni. Dopo qualsiasi azione, verifica lo stato e la data di effetto nei dettagli dell'abbonamento.

Recupera i pagamenti falliti in modo sicuro#

Innanzitutto, distingue un risultato non risolto da un fallimento confermato. Non avviare una nuova raccolta mentre il pagamento originale potrebbe ancora essere completato.

Diagramma di flusso
Unknown or pendingCustomer actionrequiredConfirmed failureNoEligible providerEligible later attempt1Collection result2Reconcile originalpayment3Return customer tosupported flow4Recovery allowed?5Stop automaticrecovery6Use configuredprovider fallback7Retry under oneowner and policy
RisultatoCommerciante o clienteEccezione o arrestoProvider o processoreRevisione o in sospeso
  • L'autenticazione del cliente deve riportare il cliente nel flusso supportato; i tentativi automatici non possono sostituirlo.
  • Il fallback del provider richiede una connessione valida e un credential utilizzabile su quel percorso.
  • Un successivo tentativo deve rispettare l'accordo con il cliente, le regole del processore e la politica di retry configurata.
  • Per i fallimenti di comunicazione, verifica il pagamento originale e segui le regole tecniche di retry documentate.

Utilizza la funzionalità di acquisizione carte di DEUNA e Vault di pagamento per tokenizzare i credential e mantenere i dati delle carte grezzi fuori dai sistemi del commerciante. L'esternalizzazione dell'acquisizione delle carte non elimina le responsabilità di conformità del commerciante.

Valida prima dell'implementazione#

Per i risultati asincroni, utilizza webhooks e recupera la risorsa originale prima di aggiornare i tuoi record.

Prossimo passo#