DOCS

Retrieve an exchange rate

/

Obtener tipos de cambio

Aprende cómo obtener un tipo de rate.

Zonos admite la obtención de tipos de cambio actualizados entre dos monedas a través de nuestra API GraphQL. Garantizamos los tipos de cambio que calculamos entre monedas. Aunque actualizamos nuestras tasas cada 10 minutos, garantizamos el rate desde el momento en que se obtuvo durante 90 días.

Zonos solo garantiza tipos de cambio para casos en los que manejamos pagos internacionales, como a través de Zonos Checkout o integraciones personalizadas con nuestra API de Pagos de Zonos. Para obtener detalles completos sobre cómo garantizamos los tipos de cambio, consulta nuestros Términos de Servicio.

Crear un nuevo objeto de tipo de rate

Para obtener un tipo de rate fresco entre dos monedas, puedes usar la mutación createExchangeRate a través de nuestra API GraphQL. createExchangeRate admite un código de moneda source y target, así como un tipo de rate. La documentación completa sobre la mutación createExchangeRate se puede encontrar en nuestra referencia de API GraphQL. Los tipos de cambio obtenidos con nuestra API son específicos de la organización.

Mutación

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation {
  exchangeRateCreate(
    input: {
      sourceCurrencyCode: GBP
      targetCurrencyCode: EUR
      type: MID_MARKET
    }
  ) {
    id
    rate
    sourceCurrencyCode
    targetCurrencyCode
  }
}

Respuesta

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "createExchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "GBP",
      "targetCurrencyCode": "EUR"
    }
  }
}

Recuperar una rate de cambio existente

Puedes usar la consulta exchangeRate con un ID proporcionado para recuperar los detalles de una rate de cambio obtenida previamente. Esto es útil si deseas ver detalles históricos de la rate de cambio, usarlos para informes, interfaces de usuario, etc. Puedes ver una lista completa de campos disponibles en la referencia de la API GraphQL.

Las tasas creadas previamente no se actualizan cuando las recuperas, están fijadas en el tiempo al momento en que fueron obtenidas originalmente.

Mutación

1
2
3
4
5
query {
  exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
    // Field names here...
  }
}

Respuesta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "data": {
    "exchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "CAD",
      "targetCurrencyCode": "GBP",
      "targetFormat": {
        "decimalDelimiter": ".",
        "symbol": "£",
        "thousandsDelimiter": ","
      }
    }
  }
}

Tipos de cambio de Google vs tipos de cambio de Zonos 

Cuando usas Google para los tipos de cambio, obtendrás un valor diferente al que proporciona nuestra API. El rate de cambio que tu cliente ve en línea no es un rate de consumidor. Si buscas en Google el rate de conversión actual de USD a GBP, lo que verás es el rate de cambio de referencia. Este es el rate al que los grandes bancos internacionales intercambian cientos de millones de dólares, pero nadie puede comprar a este rate. Un consumidor verá este rate de referencia más las tarifas cobradas por la empresa de cambio de divisas cuando no se utilizan los tipos de cambio de Zonos.

Los otros sitios que ves probablemente muestran el rate de cambio por conveniencia, pero en realidad no están cobrando al cliente en su moneda extranjera. Las compañías de tarjetas de crédito y los bancos que emiten la tarjeta cobrarán tarifas de cambio de divisas y de transacciones extranjeras a los clientes que compren en sitios que cobran en USD. Aunque muestren la moneda en GBP (o cualquier otra moneda), la cantidad que se muestra en el checkout no es la cantidad que el cliente pagará finalmente.

Como se mencionó antes, ofrecemos un rate de cambio garantizado. Las tarifas adicionales que cobramos tienen en cuenta el mercado de cambio constantemente fluctuante. Es probable que se produzcan variaciones durante el período garantizado de 90 días para el rate originalmente obtenido. Las tarifas adicionales aseguran que la cantidad mostrada y pagada por el cliente en el checkout sea el costo total y final que pagará, sin tarifas ocultas o sorpresas más adelante.

¿Fue útil esta página?