Tassi di Cambio e Conversione

Tassi di Cambio e Conversione

SanPay gestisce automaticamente la conversione fiat-to-crypto in tempo reale. Imposta i prezzi nella tua valuta locale, e noi calcoliamo l'importo esatto in crypto al checkout.

Consiglio

I tassi vengono bloccati quando il cliente seleziona una valuta, proteggendo entrambe le parti dalla volatilità durante il pagamento.

Come Funziona la Conversione

1. Tu Imposti il Prezzo Fiat

   Crea un pagamento con importo in EUR, USD o altra valuta fiat.

2. Il Cliente Seleziona la Crypto

   Al checkout, il cliente sceglie la sua criptovaluta preferita.

3. Il Tasso Viene Bloccato

   Il tasso di cambio viene bloccato per la durata del pagamento (tipicamente 30 minuti).

4. Importo Esatto Calcolato

   Mostriamo l'importo preciso in crypto richiesto, incluse eventuali commissioni.

Spread e Tassi Effettivi

Un piccolo spread viene applicato ai tassi di mercato per garantire un settlement affidabile:

Term	Description
Tasso Raw	Tasso di cambio di mercato da fonti aggregate
Spread	Piccola percentuale (tipicamente 0.5%) aggiunta per protezione prezzo
Tasso Effettivo	Il tasso effettivo usato per la conversione (raw + spread)

Nota

Gli spread variano per valuta e possono essere visualizzati tramite l'API assets.

Blocco Prezzo

Una volta che il cliente seleziona una criptovaluta, il tasso viene bloccato per un periodo configurabile:

Default: 30 minuti

• Il cliente sa esattamente quanto inviare
• Il merchant riceve il valore fiat atteso
• Protetto dalla volatilità a breve termine

Nota

Se il pagamento scade, deve essere creata una nuova sessione con i tassi correnti.

Ottieni Tassi Correnti

Ottieni i tassi di cambio in tempo reale tramite l'API assets:

Request

curl -X GET "https://api.sanpay.io/api/sdk/v1/assets?currency=EUR" \
  -H "X-Public-Key: pk_live_xxxx"

Response

{
  "assets": [
    {
      "symbol": "BTC",
      "chain": { "id": "BTC", "name": "Bitcoin" },
      "rate": {
        "raw": 89385.00,
        "effective": 88938.28
      },
      "spread": 0.5,
      "fee": { "type": "PERCENTAGE", "value": 1 }
    }
  ]
}

Gestione della Volatilità

I prezzi delle criptovalute possono muoversi significativamente. Il nostro sistema gestisce questi scenari:

Tasso Bloccato

Una volta iniziato il checkout, il tasso è fisso indipendentemente dal movimento del mercato.

Pagamento Scaduto

Se il periodo di blocco scade, il cliente deve ricominciare con i tassi correnti.

Sottopagamento

Se il cliente invia meno del richiesto, ti notifichiamo per gestire appropriatamente.