> ## 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.105.0 (22 giugno 2026)

> Porta il tuo processore (BYOP), rilascio ufficiale dell'SDK Rust, metodi di pagamento coreani (Kakao Pay, Naver Pay, PAYCO) e Przelewy24, brand_id su ogni payload di webhook, gestione delle valute con decimali, limiti di attribuzione più alti, oltre a miglioramenti in checkout, analytics e dashboard.

## Nuove Funzionalità

### 1. **Porta il tuo processore (BYOP)**

Ora puoi connettere il tuo processore di pagamento — **Stripe** o **Adyen** — e instradare i pagamenti attraverso di esso per paese del cliente, mentre Dodo Payments continua a gestire tutto ciò che riguarda la transazione: prodotti, abbonamenti, chiavi di licenza e diritti, fatturazione, portale clienti e analisi. I paesi che non indirizzi esplicitamente ricadono su Dodo come Merchant of Record completo.

<Frame>
  <img src="https://mintcdn.com/dodopayments/DNTF2guUc26Fj2yI/images/byop/overview.png?fit=max&auto=format&n=DNTF2guUc26Fj2yI&q=85&s=aeb8dfda155edde6d9084a4a03d7b15f" alt="Impostazioni BYOP che mostrano le opzioni del Mercante di Riferimento e Porta il Tuo Processore con un confronto delle funzionalità" style={{ maxHeight: '500px', width: 'auto' }} width="1391" height="1010" data-path="images/byop/overview.png" />
</Frame>

Configuralo da **Impostazioni → BYOP** nel dashboard: scegli un processore, connetti il tuo account, definisci le regole di instradamento per paese e aggiungi i dettagli del tuo emettitore di fattura.

**Cosa cambia su un percorso BYOP**

* **Sei il Mercante di Riferimento.** Dodo **non** calcola o addebita tasse sulle transazioni BYOP — i dettagli del tuo emettitore di fattura (nome dell'attività, ID fiscale e indirizzo) sostituiscono il blocco Dodo su fatture e ricevute di rimborso.
* **Le dispute e i rimborsi sono gestiti nel tuo processore.** Le dispute BYOP sono in sola lettura nel dashboard Dodo, poiché l'accettazione/sfida avviene all'interno di Stripe o Adyen.
* I pagamenti sono instradati attraverso Hyperswitch e attualmente supportano **solo carte di credito e debito**.

**Per gli sviluppatori**

Le risposte relative ai pagamenti e alle contestazioni ora includono un discriminatore `payment_provider` (`stripe`, `adyen` o `dodo`), così puoi identificare come è stata instradata ogni transazione; inoltre, la risposta di anteprima della sessione di checkout restituisce `is_byop`. I campi sono aggiuntivi: il traffico Merchant-of-Record continua a riportare `payment_provider: dodo`.

Maggiori informazioni: [Bring Your Own Processor](/features/byop) | [BYOP con Stripe](/features/byop/stripe) | [BYOP con Adyen](/features/byop/adyen)

### 2. **Rilascio Ufficiale SDK Rust**

L'**SDK Rust di Dodo Payments** ufficiale è ora disponibile come crate `dodopayments` su crates.io. La linea di lancio è allineata alla serie di versioni dell'API Dodo Payments, con `v1.105.0` come primo rilascio pubblico della linea API e `v1.106.0` già pubblicato con l'ultima rigenerazione OpenAPI.

Installalo con Cargo:

```bash theme={null}
cargo add dodopayments
```

L'SDK richiede **Rust 1.75+** ed è costruito per applicazioni Rust asincrone con Tokio e reqwest. Include:

* Modelli di richiesta e risposta fortemente tipizzati su tutta la superficie dell'API Dodo Payments.
* `Client::from_env()` per leggere `DODO_PAYMENTS_API_KEY` dall'ambiente.
* Aiutanti di paginazione tipizzati, inclusi `get_next_page()` e `into_stream()` per endpoint di elenco.
* Ambienti e timeout configurabili, incluso il supporto della modalità test.
* Decodifica delle risposte binarie per risposte in stile PDF come fatture, fatture di pagamento e fatture di rimborso.
* Un'API di builder di catene di risorse fluent per siti di chiamata Rust ergonomici.

Maggiori informazioni: [SDK Rust](/developer-resources/sdks/rust) | [Crates.io](https://crates.io/crates/dodopayments) | [GitHub](https://github.com/dodopayments/dodopayments-rust)

### 3. **Nuovi Metodi di Pagamento: Wallet Coreani e Przelewy24**

Quattro nuovi metodi di pagamento locali sono ora disponibili, espandendo la copertura in Corea del Sud e Polonia.

**Corea del Sud (KRW)** — tre wallet coreani sono ora visibili nei checkout KRW:

| Metodo        | Tipo API    | Abbonamenti         |
| ------------- | ----------- | ------------------- |
| **Kakao Pay** | `kakao_pay` | Sì                  |
| **Naver Pay** | `naver_pay` | Sì                  |
| **PAYCO**     | `payco`     | No (solo una volta) |

I wallet coreani richiedono un paese di fatturazione `KR` e una fatturazione `KRW` — se il tuo prodotto è prezzato in un'altra valuta, abilita la Valuta Adattiva in modo che il cliente sia addebitato in KRW.

**Polonia (PLN)** — **Przelewy24 (P24)**, il principale metodo di pagamento online della Polonia, ora regola in `PLN` (non EUR) e supporta i pagamenti una tantum. Passa `przelewy24` in `allowed_payment_method_types`.

Maggiori informazioni: [Metodi di Pagamento Corea del Sud](/features/payment-methods/south-korea) | [Metodi di Pagamento Europei](/features/payment-methods/europe) | [Panoramica Metodi di Pagamento](/features/payment-methods)

### 4. **`brand_id` su Ogni Payload di Webhook**

Ogni payload di evento webhook ora include un `brand_id`, quindi puoi attribuire pagamenti, abbonamenti, rimborsi, dispute, chiavi di licenza, voci nel libro mastro dei crediti, concessioni di diritti, tentativi di dunning e carrelli abbandonati a un marchio specifico. Dove un'entità non ha un marchio proprio, `brand_id` ritorna al marchio principale dell'azienda.

Non sono richieste modifiche all'integrazione — il campo è additivo e appare automaticamente sugli endpoint webhook esistenti.

Maggiori informazioni: [Marchi Multipli](/features/multi-brands) | [Eventi Webhook](/developer-resources/webhooks/intents/webhook-events-guide)

### 5. **Gestione Valutaria con Decimali**

La gestione delle valute è stata rielaborata in modo che gli importi siano calcolati e visualizzati con la precisione corretta per ciascuna valuta, invece di presumere due decimali ovunque. Le **16 valute a zero decimali** — tra cui **JPY**, **KRW**, **VND**, **CLP**, **XAF**, e **XOF** — sono ora gestite accuratamente attraverso pagamenti, fatture, pagamenti, email e analisi, e le conversioni di presentazione (Valuta Adattiva) sono precise da un capo all'altro.

Questo elimina una classe di errori di arrotondamento e visualizzazione per le valute a zero decimali e prepara il terreno per ulteriori precisazioni in futuro.

## Miglioramenti

### 6. **Limiti di Attribuzione del Prodotto e di Credito Maggiori**

* **Diritti del prodotto** per prodotto aumentati da **20 a 50**.
* **Attribuzioni di credito** (crediti collegati a un prodotto) aumentati da **3 a 5**.

Maggiori informazioni: [Diritti](/features/entitlements/introduction) | [Fatturazione Basata su Credito](/features/credit-based-billing)

### 7. **Crediti Cliente Firmati in Anteprima del Piano di Cambio**

L'anteprima del cambio piano ora restituisce `customer_credits` come valore **firmato**: **negativo** quando i crediti sono detratti per compensare un addebito (tipico negli upgrade) e **positivo** quando i crediti sono aggiunti (da un rimborso per proration downgrade o un ricarico del portafoglio), rendendo chiaro se i crediti sono utilizzati o concessi.

Maggiori informazioni: [Upgrade e Downgrade degli Abbonamenti](/developer-resources/subscription-upgrade-downgrade)

### 8. **`card_last_four` e `card_network` su List Payments**

La risposta **Elenco Pagamenti** ora include `card_last_four` e `card_network` su ogni pagamento, in modo che tu possa visualizzare i dettagli della carta negli elenchi senza dover recuperare ogni pagamento singolarmente.

Maggiori informazioni: [List Payments](/api-reference/payments/get-payments)

### 9. **Emails ACR & Dunning Personalizzati**

Le e-mail di recupero carrello abbandonato (ACR) e di recupero abbonamento in dunning ora utilizzano il nome e il logo del **marchio** rilevante invece del predefinito aziendale, quindi l'esperienza di recupero corrisponde al marchio da cui il cliente ha acquistato.

<Frame>
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="Email di recupero abbonamento in dunning reso con il nome e logo del marchio d'acquisto" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
</Frame>

Maggiori informazioni: [Subscription Dunning](/features/recovery/subscription-dunning) | [Abandoned Cart Recovery](/features/recovery/abandoned-cart-recovery)

### 10. **Miglioramento della Validazione del Codice Fiscale**

La validazione del codice fiscale al checkout è stata estesa con **rilevamento di notazione e controllo di registro** (tramite l'integrazione con Tax ID Pro), riducendo i rifiuti errati di ID validi. Il modulo di verifica aziendale ora include un **selettore di paese** per prevenire errori di validazione del codice fiscale e i caricamenti dei file sono più affidabili con un **indicatore di progresso** e un unico messaggio di errore consolidato.

### 11. **Miglioramenti negli Analytics**

Gli analytics del dashboard ora includono MRR di abbonamento corretto, conteggi di abbonamenti attivi e calcoli di retention/churn.

<Frame>
  <img src="https://mintcdn.com/dodopayments/r426DlzEVUSPZlYb/images/analytics/revenue-breakdown.png?fit=max&auto=format&n=r426DlzEVUSPZlYb&q=85&s=66d1c0d64e6a69e6e7f22ac26c89bed7" alt="Analytics dei ricavi con un toggle lordo/netto e una ripartizione del MRR" style={{ maxHeight: '500px', width: 'auto' }} width="1267" height="867" data-path="images/analytics/revenue-breakdown.png" />
</Frame>

* **Analytics per pagina** — nuove tessere evidenziano la performance dei ricavi e degli sconti per pagina di checkout.
* Un **toggle dei ricavi lordo/netto** e una **ripartizione MRR** nella vista dei ricavi.
* Le tooltip sui grafici ora mostrano le unità di valuta e percentuali, inclusi punti a valore zero.

### 12. **Rifiniture alla Dashboard e al Negozio**

* **Filtro del marchio** aggiunto alla lista dei prodotti, con filtri combinati in un singolo pulsante e marchi caricati in modo asincrono.
* **Raccolta di prodotti, addon e moduli di credito** rielaborati con flussi di creazione / modifica / duplicazione.
* **Pagina delle impostazioni del pagamento** ridisegnata, con la possibilità di recuperare un pagamento fallito al successo.
* **Badge dei fornitori di pagamento** (Stripe / Adyen / Dodo) visualizzati su tavole di transazioni e dispute.
* Il **banner del negozio** affinato.

### Altre Correzioni e Miglioramenti

* Le valute coreane e diverse altre (VND, PYG, XOF, XAF) ora predefinite sulla valuta locale al checkout.
* Correzioni di bug minori e miglioramenti della stabilità su tutta la piattaforma.
