> ## 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.

# Stablecoin

> Accetta pagamenti in stablecoin da clienti in tutto il mondo (esclusa l'India). Scopri le stablecoin supportate, la fatturazione in USD e la configurazione per il pagamento in stablecoin.

I pagamenti in stablecoin consentono ai clienti di pagare utilizzando stablecoin da qualsiasi parte del mondo (esclusa l'India). Le transazioni vengono fatturate in USD, quindi ricevi valuta fiat mentre i clienti pagano con il loro portafoglio di stablecoin preferito.

## Perché Offrire Stablecoin?

<CardGroup cols={3}>
  <Card title="Global Reach" icon="globe">
    Accetta pagamenti da qualsiasi paese — non è necessaria un'infrastruttura bancaria dal lato del cliente.
  </Card>

  <Card title="No Chargebacks" icon="shield-check">
    Le transazioni in stablecoin sono irreversibili, eliminando completamente le frodi da chargeback.
  </Card>

  <Card title="USD Settlement" icon="dollar-sign">
    Ricevi USD — non è necessario gestire la volatilità o i portafogli.
  </Card>
</CardGroup>

## Panoramica

| Dettaglio                  | Valore               |
| :------------------------- | :------------------- |
| **Valuta di Fatturazione** | USD                  |
| **Paesi Supportati**       | Globale (Escluso IN) |
| **Sottoscrizioni**         | No                   |
| **Importo Minimo**         | \$0,50               |
| **Regolamento**            | USD                  |

## Come Funziona

```mermaid theme={null}
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant StablecoinProcessor
    participant Blockchain

    Customer->>Checkout: Select Stablecoins
    Checkout->>Dodo: Create payment
    Dodo->>StablecoinProcessor: Generate payment request
    StablecoinProcessor->>Customer: Display wallet address / QR code
    Customer->>Blockchain: Send stablecoins from wallet
    Blockchain->>StablecoinProcessor: Transaction confirmed
    StablecoinProcessor->>Dodo: Payment confirmed (USD)
    Dodo->>Checkout: Payment complete
```

## Esperienza del Cliente

1. Il cliente seleziona Stablecoin al checkout
2. Viene visualizzato un indirizzo di portafoglio e un codice QR con l'importo in stablecoin
3. Il cliente invia l'importo esatto dal proprio portafoglio di stablecoin
4. La transazione viene confermata sulla blockchain
5. Il cliente viene reindirizzato alla pagina di successo

<Info>
  I pagamenti in stablecoin sono fatturati in USD. L'importo in stablecoin visualizzato al checkout riflette il tasso di cambio in tempo reale al momento del pagamento.
</Info>

## Valute e Reti Supportate

| Valuta   | Reti                            |
| :------- | :------------------------------ |
| **USDC** | Ethereum, Solana, Polygon, Base |
| **USDP** | Ethereum, Solana                |
| **USDG** | Ethereum                        |

## Configurazione

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['crypto_currency', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

## Tipo di Metodo API

| Tipo     | Metodo     | Paese                |
| :------- | :--------- | :------------------- |
| `crypto` | Stablecoin | Globale (Escluso IN) |

## Test

<Steps>
  <Step title="Enable test mode">
    Utilizza le tue chiavi API di test Dodo Payments.
  </Step>

  <Step title="Create a test checkout">
    Crea una sessione di checkout con `crypto` nei metodi di pagamento consentiti.
  </Step>

  <Step title="Complete the test flow">
    Segui il flusso di pagamento simulato in stablecoin nell'ambiente di test.
  </Step>
</Steps>

## Migliori Pratiche

<AccordionGroup>
  <Accordion title="Always include card fallbacks">
    Non tutti i clienti hanno portafogli di stablecoin. Includi sempre `credit` e `debit` come metodi di pagamento di riserva.
  </Accordion>

  <Accordion title="Set clear expectations on confirmation time">
    Le conferme blockchain possono richiedere minuti a seconda della rete. Assicurati che il tuo checkout comunichi questo ai clienti.
  </Accordion>

  <Accordion title="Handle underpayments and overpayments">
    I pagamenti in stablecoin possono occasionalmente differire leggermente dall'importo esatto a causa delle commissioni di rete. Monitora i webhook per aggiornamenti sullo stato del pagamento.
  </Accordion>
</AccordionGroup>

## Risoluzione dei Problemi

<AccordionGroup>
  <Accordion title="Stablecoins not appearing at checkout">
    **Verifica:**

    1. `crypto` incluso in `allowed_payment_method_types`?
    2. L'importo della transazione soddisfa il minimo (\$0,50)?

    **Soluzione:** Verifica che il tipo di metodo di pagamento sia passato correttamente nella tua richiesta API.
  </Accordion>

  <Accordion title="Payment not confirming">
    **Causa:** I tempi di conferma della blockchain variano. Alcune reti impiegano più tempo di altre.

    **Soluzione:** Attendi la conferma del webhook. Non trattare il pagamento come fallito fino a quando la finestra di conferma non è trascorsa.
  </Accordion>

  <Accordion title="Amount mismatch">
    **Causa:** Le commissioni di rete possono causare una leggera differenza tra l'importo ricevuto e quello richiesto.

    **Soluzione:** Monitora i webhook per l'importo finale confermato. Le piccole discrepanze vengono gestite automaticamente.
  </Accordion>
</AccordionGroup>

## Pagine Correlate

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Vedi tutti i metodi di pagamento supportati.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Guida completa all'implementazione del checkout.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/developer-resources/webhooks">
    Gestisci le conferme di pagamento in modo asincrono.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Guida completa ai test per tutti i metodi di pagamento.
  </Card>
</CardGroup>