Un retreat da 2.000 USD è una richiesta pesante in anticipo. Le rate permettono a chi prenota di impegnarsi con un primo addebito più piccolo e pagare il resto su un calendario legato alla data di inizio del retreat. La piattaforma gestisce gli addebiti off-session automaticamente.
Solo piano Premium. Solo prenotazioni con carta via Stripe (i metodi off-platform non si possono addebitare off-session).
Come funziona
Definisci un template una volta sola quando crei il retreat. Ogni utente che fa opt-in riceve il proprio ledger di rate risolto a partire da quel template.
Il template è una lista di step. Ogni step ha:
offsetDays: quando addebitare, relativo alla data di inizio del retreat. Negativo significa prima (per esempio -30 = trenta giorni prima dell'inizio). 0 = all'iscrizione.percentageBps: la percentuale in punti base (5000 = 50%, 3333 = 33,33%).
Le percentuali devono sommare esattamente a 10000 (= 100%). L'offset del primo step deve essere <= 0 in modo che chi prenota paghi al checkout.
Tre forme comuni
Due step, 50/50:
- Step 1: offsetDays 0, 50%
- Step 2: offsetDays -30, 50%
Tre step, 50/25/25:
- Step 1: offsetDays 0, 50%
- Step 2: offsetDays -60, 25%
- Step 3: offsetDays -14, 25%
Quattro step, quarti uguali:
- 25% all'iscrizione, 25% a -90, 25% a -60, 25% a -14.
Cosa succede al checkout
Chi prenota sceglie "Paga a rate" sulla pagina di prenotazione. Addebitamo la rata n. 1 subito via Stripe e salviamo la carta per i passaggi futuri (il setup_future_usage: off_session di Stripe).
Cosa succede dopo
Un cron giornaliero alle 07:00 UTC scorre ogni rata SCHEDULED il cui scheduledFor è passato. Ognuna viene addebitata sulla carta salvata. In caso di successo: marcata PAID, email di ricevuta inviata. In caso di fallimento: ritentata dopo una grace di 3 giorni (default), fino a 2 volte in più. Una volta esaurito il limite di retry: la rata passa a FAILED, la prenotazione viene cancellata, le rate SCHEDULED rimanenti diventano CANCELLED, e chi prenota riceve un'email.
Le rate precedenti NON vengono rimborsate al fallimento finale. È il contratto pubblicato; chi prenota perde quanto versato.
Cosa vede chi prenota
Sulla sua pagina di conferma prenotazione: ogni riga di rata con la data programmata, l'importo e lo stato (Paid / Scheduled / Failed / Cancelled). L'agent può anche elencarle via il tool MCP list_my_installments.
Rimborsi per prenotazioni a rate
Quando cancelli e rimborsi la prenotazione, la base ammissibile è la SOMMA delle rate già PAID (non il totale contrattuale; non puoi rimborsare soldi che non sono stati incassati). Le righe SCHEDULED rimanenti vengono cancellate nella stessa transazione, così il cron smette di provare. Vedi Accettare i pagamenti per il flow completo di rimborso.