Gestire i pacchetti eSIM ricorrenti

Usa un abbonamento ricorrente per acquistare pacchetti dati secondo un ciclo di fatturazione. Servono i permessi per acquistare il servizio eSIM, fondi nel wallet dell'organizzazione e un subscriber per la persona che usa la eSIM. La disponibilità dipende dall'offerta e dal profilo selezionati.

Questa guida copre i nuovi acquisti e l'iscrizione su una eSIM esistente. La eSIM API non fornisce un'operazione per passare da un abbonamento attivo a un altro piano.

1. Esaminare le condizioni ricorrenti

Per una nuova eSIM, ottieni le opzioni di checkout. Proponi il rinnovo automatico quando recurrence.available è true e usa il suo quote per i termini accettati. Se non disponibile, ispeziona unavailable_reason e proponi un'opzione di acquisto supportata.

Per una eSIM esistente, elenca le offerte compatibili con recurring_only=true, poi ottieni i termini ricorrenti dell'offerta selezionata. L'iscrizione verifica nuovamente la compatibilità prima di accettare l'acquisto.

Mostra il prezzo ricorrente, la valuta pubblicata, la cadenza e la modalità di consegna prima dell'accettazione. Il preventivo è al netto delle imposte; lo storico dei periodi registra il totale addebitato e le imposte. calendar_month segue i mesi di calendario; fixed_days usa il numero indicato di giorni da 24 ore. Il wallet dell'organizzazione paga il servizio; il subscriber non ha un wallet separato.

Verifica se il pacchetto copre l'intervallo pagato (exact_period) o se ogni rinnovo acquista un pacchetto standard (recurring_top_up). Con le ricariche ricorrenti, attivazione e scadenza seguono i termini del pacchetto e possono differire dai limiti del ciclo di fatturazione. Non promettere dati ininterrotti solo perché il rinnovo è pianificato.

2. Assegnare l'abbonato

Nella dashboard, apri il profilo da eSIMs, apri More eSIM actions, seleziona Assign person, scegli il contatto e conferma Assign person. Non è possibile cambiare la persona assegnata in seguito.

Con la API, crea un subscriber usando il contact_id di un contatto nel tuo spazio di lavoro. Sono necessari email_marketing:read per Contacts e esim:write. La risposta restituisce il subscriber esistente quando il contatto ne ha già uno.

La creazione dell'associazione impedisce l'eliminazione del contatto, anche dopo la fine della eSIM. Le associazioni subscriber non possono attualmente essere rimosse, scollegate o anonimizzate. Valuta se questa conservazione è compatibile con il tuo processo cliente prima di crearne una.

Per un profilo esistente, assegna la eSIM usando subscriber_id. Ripetere la stessa assegnazione restituisce il record esistente; assegnare una persona diversa restituisce 409. Per un nuovo profilo, includi subscriber_id nell'acquisto in modo che l'assegnazione si completi con la consegna.

L'assegnazione non concede accesso allo spazio di lavoro né il permesso di leggere le credenziali di installazione. Gestisci la raccolta dei dati identificativi separatamente usando i requisiti dell'offerta e la guida all'integrazione.

3. Iscrivere e verificare la consegna

Per una eSIM esistente già assegnata nella dashboard, apri Automatic renewal e seleziona Set up renewal. Scegli un Package, seleziona Check recurring price e verifica il prezzo, la cadenza e i termini di consegna del pacchetto. Seleziona Buy first package and renew per acquistare il primo periodo e attivare il rinnovo.

Per una nuova eSIM tramite API, crea un ordine con l'offerta selezionata offer_id, lo spazio di lavoro subscriber_id e questi termini di checkout accettati:

• Imposta offer_revision a recurrence.quote.offer_revision.
• Imposta recurrence.recurrence_revision a recurrence.quote.recurrence_revision.
• Imposta recurrence.accepted_price all'oggetto recurrence.quote.price completo.

Invia un Idempotency-Key; ometti esim_id e expected_price per questo acquisto. Salva l'ID dell'ordine e il suo recurring_subscription_id. Il primo periodo di fatturazione inizia quando il pagamento è finanziato. Segui l'ordine fino al completamento o al fallimento, usando i passaggi di recupero dell'acquisto se necessario.

Per una eSIM esistente già assegnata, crea un abbonamento ricorrente con esim_id, offer_id, il revision dell'offerta come offer_revision e il revision dei termini ricorrenti come recurrence_revision. Invia l'oggetto price completo dei termini ricorrenti come accepted_price. È richiesto un Idempotency-Key; riutilizzalo con la stessa richiesta per recuperare l'iscrizione. L'iscrizione acquista immediatamente il primo periodo; non attende l'esaurimento di un pacchetto esistente.

Ottieni l'abbonamento e elenca i suoi periodi. Conferma il pagamento e la consegna del pacchetto separatamente. Per una nuova eSIM, consegna i dettagli di installazione dopo il completamento dell'ordine.

4. Monitorare il rinnovo

Apri Subscriptions per verificare i termini accettati, lo stato e il prossimo rinnovo. In API, leggi next_renewal_at, stop_reason e la cronologia dei periodi. Una variazione del prezzo pubblicato richiede una nuova accettazione; un rinnovo non finanziato interrompe gli acquisti futuri.

Se status è needs_attention, ispeziona l'ultimo periodo e l'ordine associato. Una consegna non risolta può restare pagabile e blocca una nuova iscrizione sostitutiva. Contatta il supporto con quei riferimenti prima di acquistare una sostituzione.

5. Interrompere il rinnovo futuro

Nella sezione Automatic renewal della eSIM, seleziona Cancel renewal. Verifica la fine del periodo pagato corrente, quindi conferma Cancel renewal nella finestra di dialogo. Controlla l'abbonamento aggiornato per la data di cancellazione.

Con API, cancella l'abbonamento, quindi rileggilo. Controlla cancel_at_period_end, cancellation_effective_at e next_renewal_at per confermare quando termina il rinnovo. Un periodo già confermato resta pagabile. I pacchetti consegnati mantengono la propria validità e il profilo installato viene preservato.

Rimuovere il profilo dal telefono non annulla il rinnovo. Rilasciare un'eSIM la ritira in modo permanente, comporta la perdita dei dati residui e non prevede rimborso. Usa le azioni di servizio quando intendi modificare la connettività oltre al rinnovo.

Risoluzione dei problemi

Aggiungere fondi al wallet non riavvia automaticamente un abbonamento interrotto. Controlla stop_reason e lo stato finale del servizio precedente prima di accettare una nuova iscrizione. Una consegna a pagamento non riuscita e il relativo credito hanno esiti separati: verifica order_status e refund_transaction_id nello storico dei periodi.

Verifica il percorso del cliente

Conferma che il cliente possa trovare il traffico acquistato, la scadenza del pacchetto, il prossimo rinnovo, la data di cancellazione e il contatto di supporto. Verifica la consegna del primo pacchetto e testa la connessione dati mobile su un dispositivo compatibile. Controlla il pagamento e la consegna di un periodo successivo separatamente dalla data di rinnovo programmata.

Prossimi passi

• Leggere i saldi e acquistare una ricarica una tantum.
• Preparare l'installazione sul dispositivo.
• Indagare problemi di pagamento o consegna.