Ir al contenido
SanPay Docs

Tipos de Cambio y Conversión

Tipos de Cambio y Conversión

SanPay maneja automáticamente la conversión fiat-a-crypto en tiempo real. Establece precios en tu moneda local, y calculamos el monto exacto en crypto al checkout.

Cómo Funciona la Conversión

  1. Tú Estableces el Precio Fiat

    Crea un pago con monto en EUR, USD u otra moneda fiat.

  2. El Cliente Selecciona Crypto

    Al checkout, el cliente elige su criptomoneda preferida.

  3. La Tasa Se Bloquea

    El tipo de cambio se bloquea por la duración del pago (típicamente 30 minutos).

  4. Monto Exacto Calculado

    Mostramos el monto preciso en crypto requerido, incluyendo cualquier comisión.

Spread y Tasas Efectivas

Un pequeño spread se aplica a las tasas de mercado para asegurar liquidación confiable:

Term Description
Tasa Raw Tipo de cambio de mercado de fuentes agregadas
Spread Pequeño porcentaje (típicamente 0.5%) añadido para protección de precio
Tasa Efectiva La tasa real usada para conversión (raw + spread)

Bloqueo de Precio

Una vez que el cliente selecciona una criptomoneda, la tasa se bloquea por un período configurable:

Por defecto: 30 minutos

  • El cliente sabe exactamente cuánto enviar
  • El comerciante recibe el valor fiat esperado
  • Protegido de volatilidad a corto plazo

Obtener Tasas Actuales

Obtén tipos de cambio en tiempo real a través de la API de activos:

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 }
    }
  ]
}

Manejo de la Volatilidad

Los precios de criptomonedas pueden moverse significativamente. Nuestro sistema maneja estos escenarios:

Tasa Bloqueada

Una vez iniciado el checkout, la tasa es fija independientemente del movimiento del mercado.

Pago Expirado

Si el período de bloqueo expira, el cliente debe reiniciar con las tasas actuales.

Subpago

Si el cliente envía menos de lo requerido, te notificamos para que manejes apropiadamente.