Buat objek nilai tukar rate baru
Untuk mengambil nilai tukar rate yang baru antara dua mata uang, Anda dapat menggunakan mutasi createExchangeRate melalui GraphQL API kami. createExchangeRate mendukung kode mata uang source dan target, serta jenis rate. Dokumentasi lengkap tentang mutasi createExchangeRate dapat ditemukan di referensi GraphQL API kami. Nilai tukar yang diambil dengan API kami bersifat spesifik untuk organisasi.
Mutasi
mutation {
exchangeRateCreate(
input: {
sourceCurrencyCode: GBP
targetCurrencyCode: EUR
type: MID_MARKET
}
) {
id
rate
sourceCurrencyCode
targetCurrencyCode
}
}
Respon
{
"data": {
"createExchangeRate": {
"id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
"rate": 0.6391,
"sourceCurrencyCode": "GBP",
"targetCurrencyCode": "EUR"
}
}
}
Ambil nilai tukar rate yang ada
Anda dapat menggunakan kueri exchangeRate dengan ID yang diberikan untuk mengambil detail nilai tukar rate yang telah diambil sebelumnya. Ini berguna jika Anda ingin melihat detail nilai tukar rate historis, menggunakannya untuk laporan, antarmuka pengguna, dll. Anda dapat melihat daftar lengkap bidang yang tersedia di referensi API GraphQL.
Nilai tukar yang sebelumnya dibuat tidak diperbarui saat Anda mengambilnya, mereka terikat pada waktu ketika mereka awalnya diambil.
Mutasi
query {
exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
// Field names here...
}
}
Respon
{
"data": {
"exchangeRate": {
"id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
"rate": 0.6391,
"sourceCurrencyCode": "CAD",
"targetCurrencyCode": "GBP",
"targetFormat": {
"decimalDelimiter": ".",
"symbol": "£",
"thousandsDelimiter": ","
}
}
}
}
Kurs tukar Google vs kurs tukar Zonos
Ketika Anda menggunakan Google untuk kurs tukar, Anda akan mendapatkan nilai yang berbeda dari yang disediakan API kami. Kurs tukar yang dilihat pelanggan Anda secara online bukanlah kurs tukar konsumen. Jika Anda mencari konversi USD ke GBP saat ini di Google, yang akan Anda lihat adalah kurs tukar "acuan" valuta asing. Ini adalah kurs tukar di mana bank internasional besar menukarkan ratusan juta dolar, tetapi tidak ada yang bisa membeli dengan kurs tukar ini. Seorang konsumen akan melihat kurs tukar acuan ini ditambah biaya yang dikenakan oleh perusahaan valuta asing ketika kurs tukar Zonos tidak digunakan.
Situs lain yang Anda lihat kemungkinan besar menampilkan kurs tukar hanya untuk kemudahan, tetapi mereka sebenarnya tidak menagih pelanggan dalam mata uang asing mereka. Perusahaan kartu kredit dan bank yang mengeluarkan kartu akan menagih biaya valuta asing dan biaya transaksi asing kepada pelanggan yang membeli dari situs yang menagih dalam USD. Meskipun mereka menampilkan mata uang dalam GBP (atau mata uang lain), jumlah yang ditampilkan kepada mereka saat checkout bukanlah jumlah yang pada akhirnya akan dibayar oleh pelanggan.
Seperti yang disebutkan sebelumnya, kami menawarkan kurs tukar yang dijamin. Biaya tambahan yang kami kenakan memperhitungkan pasar tukar yang terus berfluktuasi. Variasi kemungkinan terjadi selama periode 90 hari yang dijamin untuk kurs tukar yang awalnya diambil. Biaya ekstra memastikan bahwa jumlah yang ditampilkan dan dibayar oleh pelanggan saat checkout adalah biaya total dan final yang akan mereka bayar—tanpa biaya tersembunyi atau kejutan nantinya.
Ambil nilai tukar
Pelajari cara mengambil nilai tukar rate.Zonos mendukung pengambilan nilai tukar terkini antara dua mata uang melalui GraphQL API kami. Kami menjamin nilai tukar yang kami hitung antara mata uang. Meskipun kami memperbarui nilai tukar kami setiap 10 menit, kami menjamin rate dari saat diambil selama 90 hari.
Zonos hanya menjamin nilai tukar untuk kasus di mana kami menangani pembayaran internasional, seperti melalui Zonos Checkout atau integrasi kustom dengan Zonos Payments API kami. Untuk rincian lengkap tentang bagaimana kami menjamin nilai tukar, silakan konsultasikan Ketentuan Layanan.