DOCS

Retrieve an exchange rate

/

Recuperar taxas de câmbio

Aprenda como recuperar uma taxa de rate.

Zonos suporta a obtenção de taxas de câmbio atualizadas entre duas moedas através da nossa API GraphQL. Garantimos as taxas de câmbio que calculamos entre moedas. Embora atualizemos nossas taxas a cada 10 minutos, garantimos a taxa de rate desde o momento em que foi obtida por 90 dias.

Zonos garante taxas de câmbio apenas para casos em que lidamos com pagamentos internacionais, como através do Zonos Checkout ou integrações personalizadas com nossa API de Pagamentos do Zonos. Para detalhes completos sobre como garantimos as taxas de câmbio, consulte nossos Termos de Serviço.

Criar um novo objeto de taxa de rate

Para obter uma nova taxa de rate entre duas moedas, você pode usar a mutação createExchangeRate via nossa API GraphQL. createExchangeRate suporta um código de moeda source e target, bem como um tipo de taxa de rate. A documentação completa sobre a mutação createExchangeRate pode ser encontrada na nossa referência da API GraphQL. As taxas de câmbio obtidas com nossa API são específicas para a organização.

Mutação

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

Resposta

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 uma rate de câmbio existente

Você pode usar a consulta exchangeRate com um ID fornecido para recuperar os detalhes da rate de câmbio previamente obtida. Isso é útil se você quiser ver detalhes históricos da rate de câmbio, usá-los para relatórios, interfaces de usuário, etc. Você pode ver uma lista completa dos campos disponíveis na referência da API GraphQL.

As taxas criadas anteriormente não são atualizadas quando você as recupera, elas são fixadas no tempo em que foram originalmente obtidas.

Mutação

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

Resposta

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": ","
      }
    }
  }
}

Taxas de câmbio do Google vs taxas de câmbio do Zonos 

Quando você usa o Google para taxas de câmbio, você obterá um valor diferente do que nossa API fornece. A taxa de câmbio rate que seu cliente está vendo online não é uma taxa de câmbio rate para consumidores. Se você pesquisar no Google a conversão atual de USD para GBP rate, o que você verá é a taxa de câmbio “referencial” rate. Esta é a taxa rate na qual grandes bancos internacionais trocam centenas de milhões de dólares, mas ninguém pode comprar a essa taxa rate. Um consumidor verá essa taxa referencial rate mais as taxas cobradas pela empresa de câmbio quando as taxas de câmbio do Zonos não são utilizadas.

Os outros sites que você vê provavelmente exibem a taxa de câmbio rate por uma questão de conveniência, mas eles não estão realmente cobrando do cliente na moeda estrangeira deles. As empresas de cartão de crédito e os bancos que emitem o cartão cobrarão taxas de câmbio estrangeiro e taxas de transação estrangeira aos clientes que compram de sites que cobram em USD. Mesmo que eles exibam a moeda em GBP (ou qualquer outra moeda), o valor exibido para eles no checkout não é o valor que o cliente acabará pagando.

Como mencionado anteriormente, oferecemos uma taxa de câmbio rate garantida. As taxas adicionais que cobramos levam em conta o mercado de câmbio em constante flutuação. Variações são prováveis de ocorrer durante o período garantido de 90 dias para a taxa rate originalmente buscada. As taxas extras garantem que o valor exibido e pago pelo cliente no checkout seja o custo total e final que eles pagarão—sem taxas ocultas ou surpresas posteriormente.

Esta página foi útil?