DOCS

Retrieve an exchange rate

/

Lấy tỷ giá hối đoái

Tìm hiểu cách lấy tỷ giá rate.

Zonos hỗ trợ việc lấy tỷ giá hối đoái cập nhật giữa hai loại tiền tệ thông qua API GraphQL của chúng tôi. Chúng tôi đảm bảo tỷ giá hối đoái mà chúng tôi tính toán giữa các loại tiền tệ. Mặc dù chúng tôi cập nhật tỷ giá mỗi 10 phút, nhưng chúng tôi đảm bảo tỷ giá rate từ thời điểm nó được lấy trong vòng 90 ngày.

Zonos chỉ đảm bảo tỷ giá hối đoái cho các trường hợp mà chúng tôi xử lý thanh toán quốc tế, chẳng hạn như thông qua Zonos Checkout hoặc các tích hợp tùy chỉnh với API Thanh toán Zonos của chúng tôi. Để biết đầy đủ chi tiết về cách chúng tôi đảm bảo tỷ giá hối đoái, hãy tham khảo Điều khoản dịch vụ.

Tạo một đối tượng tỷ giá rate mới

Để lấy một tỷ giá rate mới giữa hai loại tiền tệ, bạn có thể sử dụng phép biến đổi createExchangeRate thông qua API GraphQL của chúng tôi. createExchangeRate hỗ trợ mã loại tiền tệ sourcetarget, cũng như một loại rate. Tài liệu đầy đủ về phép biến đổi createExchangeRate có thể được tìm thấy trong tài liệu tham khảo API GraphQL. Tỷ giá hối đoái được lấy bằng API của chúng tôi là cụ thể cho tổ chức.

Biến đổi

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

Phản hồi

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

Truy xuất rate hiện có

Bạn có thể sử dụng truy vấn exchangeRate với ID được cung cấp để truy xuất chi tiết rate đã được lấy trước đó. Điều này hữu ích nếu bạn muốn xem chi tiết rate lịch sử, sử dụng chúng cho báo cáo, giao diện người dùng, v.v. Bạn có thể xem danh sách đầy đủ các trường có sẵn trên tài liệu tham khảo API GraphQL.

Các tỷ giá đã được tạo trước đó sẽ không được làm mới khi bạn truy xuất chúng, chúng được cố định theo thời gian khi chúng được lấy ban đầu.

Mutation

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

Phản hồi

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

Tỷ giá Google so với tỷ giá Zonos 

Khi bạn sử dụng Google để tra cứu tỷ giá, bạn sẽ nhận được một giá trị khác so với những gì API của chúng tôi cung cấp. Tỷ giá rate mà khách hàng của bạn nhìn thấy trực tuyến không phải là tỷ giá rate dành cho người tiêu dùng. Nếu bạn tra cứu tỷ giá chuyển đổi USD sang GBP hiện tại trên Google, điều bạn thấy là tỷ giá “chuẩn” trên thị trường ngoại hối. Đây là tỷ giá rate mà các ngân hàng quốc tế lớn trao đổi hàng trăm triệu đô la, nhưng không ai có thể mua với tỷ giá này. Người tiêu dùng sẽ thấy tỷ giá chuẩn này cộng với các khoản phí do công ty ngoại hối tính khi không sử dụng tỷ giá Zonos.

Các trang web khác mà bạn thấy có thể hiển thị tỷ giá rate chỉ để tiện lợi, nhưng thực tế họ không tính phí khách hàng bằng ngoại tệ của họ. Các công ty thẻ tín dụng và ngân hàng phát hành thẻ sẽ tính phí giao dịch ngoại hối và phí giao dịch quốc tế cho khách hàng mua hàng từ các trang tính phí bằng USD. Mặc dù họ hiển thị tiền tệ bằng GBP (hoặc bất kỳ đơn vị tiền tệ nào khác), số tiền hiển thị cho họ tại checkout không phải là số tiền khách hàng cuối cùng phải trả.

Như đã đề cập trước đây, chúng tôi cung cấp một tỷ giá rate được đảm bảo. Các khoản phí bổ sung mà chúng tôi tính toán dựa trên thị trường trao đổi ngoại tệ luôn biến động. Sự biến động có thể xảy ra trong suốt thời gian 90 ngày được đảm bảo cho tỷ giá rate được truy xuất ban đầu. Các khoản phí bổ sung đảm bảo rằng số tiền hiển thị và thanh toán bởi khách hàng tại checkout là tổng chi phí cuối cùng họ phải trả—không có phí ẩn hay bất ngờ sau đó.

Trang này có hữu ích không?