> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# v1.106.0 (7 luglio 2026)
> Prezzi localizzati con regole di prezzo per valuta e per paese, tre nuovi metodi di pagamento (Satispay, BLIK e Klarna per abbonamenti), abilitazioni tramite feature flag, registrazione del dominio Apple Pay e componenti aggiuntivi modificabili al checkout — oltre all'estensione del periodo di abbonamento e alla rimozione delle immagini dei componenti aggiuntivi.
## Nuove Funzionalità
### 1. **Prezzi Localizzati**
Ora puoi impostare **prezzi fissi per valuta o per paese** invece di lasciare che i tassi di cambio decidano l'importo che un cliente vede. Attivalo impostando un `pricing_mode` su un prodotto, quindi collega una regola di prezzo per mercato:
| Modo | Cosa fa | Esempio |
| ------------- | ----------------------------------------------------------------------------- | --------------------------------------------- |
| `by_currency` | Un prezzo fisso per valuta, indipendentemente dal paese | Chiunque paghi in EUR vede **€9,99** |
| `by_country` | Un prezzo specifico a un paese, anche quando più paesi condividono una valuta | **₹999 in India** su un prodotto base da \$20 |
Gestisci le regole tramite i nuovi endpoint `/products/{product_id}/localized-prices` (crea, elenca, ottieni, modifica, archivia). Ogni `amount` di regola è un numero intero nell'unità più piccola della valuta — un prezzo che imposti, mai un valore convertito.
Quando nessuna regola corrisponde, il prodotto mantiene il suo comportamento esistente: i clienti nella tua valuta base pagano direttamente il prezzo base e tutti gli altri vengono convertiti tramite Adaptive Currency. Quando una regola **corrisponde**, il cliente paga **esattamente** l'importo che imposti — la commissione FX di Adaptive Currency è assorbita anziché aggiunta in aggiunta.
Questo è il modo consigliato e nativo per eseguire il **Purchasing Power Parity (PPP)**, i prezzi di charme (€9,99, ¥1000, ₹499), le promozioni di ingresso sul mercato reversibili e l'abbinamento competitivo dei prezzi.
Per saperne di più: [Prezzi Localizzati](/features/localized-pricing) | [Adaptive Currency](/features/adaptive-currency) | [Purchasing Power Parity](/features/purchasing-power-parity)
### 2. **Nuovi Metodi di Pagamento: Satispay, BLIK & Klarna per Abbonamenti**
Tre aggiunte ampliano la copertura locale in Europa e portano Buy Now, Pay Later alla fatturazione ricorrente.
| Metodo | Tipo di API | Regione | Valuta | Abbonamenti |
| ------------ | ----------- | --------------- | ------ | --------------- |
| **Satispay** | `satispay` | Europa (Italia) | EUR | Sì |
| **BLIK** | `blik` | Polonia | PLN | No (una tantum) |
| **Klarna** | `klarna` | Stati Uniti | USD | **Sì (nuovo)** |
* **Satispay** appare sui checkout in EUR per entrambi i pagamenti una tantum e in abbonamento all'interno dell'intervallo di importo supportato.
* **BLIK**, il metodo di pagamento online più popolare in Polonia (\~60% di quota di mercato), liquida in `PLN` e supporta pagamenti una tantum.
* **Klarna** può ora essere utilizzato per **abbonamenti** sui checkout in USD con fatturazione negli Stati Uniti sopra i \$50 di minimo — in precedenza era limitato a pagamenti una tantum.
Per saperne di più: [Metodi di Pagamento Europei](/features/payment-methods/europe) | [Buy Now, Pay Later](/features/payment-methods/bnpl) | [Panoramica Metodi di Pagamento](/features/payment-methods)
### 3. **Abilitazioni tramite Feature Flag**
Un nuovo tipo di abilitazione **feature flag** trasforma Dodo Payments in uno store di feature-flag consapevole della fatturazione. Collega una flag come `advanced_reports` a un prodotto, e ogni cliente pagante ottiene immediatamente una concessione che la tua applicazione può verificare — nessuna piattaforma esterna, nessun OAuth e nessun passaggio di consegna che può fallire.
* Al momento dell'acquisto, la concessione viene creata e passa direttamente a `delivered`. Non c'è fase `pending` e nessuna azione del cliente.
* La concessione trasporta un payload digitato `feature` — `{ "feature_type": "boolean", "feature_id": "advanced_reports" }` — e la tua applicazione legge `feature_id` per decidere cosa sbloccare.
* Annullamento, rimborso o revoca manuale spostano la concessione a `revoked`, e la flag scompare automaticamente.
Puoi leggere le concessioni di un cliente con il nuovo endpoint **`GET /customers/{customer_id}/entitlement-grants`** (filtri per stato e tipo di integrazione, paginati), o mantenerle sincronizzate tramite webhooks. I metadati delle abilitazioni ora supportano anche una unione scalare `string | number | boolean`, quindi puoi collegare limiti e quote insieme alla flag.
Per saperne di più: [Abilitazione tramite Feature Flag](/features/entitlements/feature-flags) | [Abilitazioni](/features/entitlements/introduction)
### 4. **Registrazione del Dominio Apple Pay**
Ora puoi registrare e verificare **i tuoi domini** per Apple Pay direttamente dalla dashboard, abilitando Apple Pay con un solo tocco su checkout inline (embedded) ospitato sul tuo sito.
Configuralo da **Impostazioni → Metodi di Pagamento**: sulla riga **Apple Pay**, clicca su **Gestisci domini**, scarica il file di associazione del dominio, ospitalo sul tuo dominio, quindi registra e verifica. La verifica del dominio è necessaria solo per il checkout inline (embedded) — il checkout overlay, il checkout ospitato e i link di pagamento funzionano senza di essa.
Disabilitare un dominio è un interruttore di emergenza che impedisce a Dodo di offrire Apple Pay su quel dominio al checkout — non deregistra il dominio con Apple.
Per saperne di più: [Portafogli Digitali](/features/payment-methods/digital-wallets)
### 5. **Componenti Aggiuntivi Modificabili al Checkout**
Un nuovo feature flag `allow_editing_addons` sulle sessioni di checkout consente ai clienti di **aggiungere o rimuovere componenti aggiuntivi su un prodotto in abbonamento durante il checkout**, anziché bloccare il carrello su un set fisso di componenti aggiuntivi.
```typescript theme={null}
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
feature_flags: {
allow_editing_addons: true // customers can edit add-ons at checkout
},
return_url: 'https://yoursite.com/return'
});
```
La flag predefinita è `false` e si applica solo ai prodotti in abbonamento. Inoltre è emersa su `GET /checkouts/{id}` in modo che il tuo front-end sappia se la modifica dei componenti aggiuntivi è abilitata per una sessione.
Per saperne di più: [Sessione di Checkout](/developer-resources/checkout-session) | [Componenti Aggiuntivi](/features/addons)
## Miglioramenti & Correzioni di Bug
### 6. **Estensione del Periodo di un Abbonamento tramite `PATCH /subscriptions`**
`PATCH /subscriptions/{id}` ora accetta `subscription_period_count` e `subscription_period_interval`, quindi puoi **estendere** il periodo corrente di un abbonamento — ad esempio, per concedere tempo extra. La scadenza dell'abbonamento (`expires_at`) viene ricalcolata dal nuovo conteggio e intervallo e mantenuta.
Il periodo di un abbonamento può solo essere **aumentato**, mai abbreviato.
Per saperne di più: [Aggiorna Abbonamento](/api-reference/subscriptions/patch-subscriptions)
### 7. **Rimozione delle Immagini dai Componenti Aggiuntivi**
`PATCH /addons/{id}` ora supporta la cancellazione dell'immagine di un componente aggiuntivo inviando `image_id: null`. Un `null` esplicito rimuove l'immagine, mentre omettere il campo la lascia invariata — in conformità alla stessa convenzione utilizzata per prodotti e collezioni di prodotti.
Per saperne di più: [Aggiorna Componente Aggiuntivo](/api-reference/addons/update-addon)
### Altre Correzioni e Miglioramenti
* Correzioni di bug minori e miglioramenti della stabilità su tutta la piattaforma.