In this Article
Konversi mata uang tampak seperti masalah yang sudah terpecahkan dan diakses melalui API. Kerumitannya muncul saat keuangan dan produk pertama kali tidak sepakat mengenai sebuah angka, dan penyebabnya hampir selalu karena mereka menggunakan kurs yang berbeda dan keduanya yakin kurs merekalah yang tepat.
Panduan ini membedakan empat jenis kurs, menjelaskan asal masing-masing kurs, serta memberikan aturan untuk memilih kurs yang dapat Anda pertanggungjawabkan nanti.
Fakta Utama
- Tidak ada satu kurs tunggal. Mata uang diperdagangkan di luar bursa, sehingga setiap kurs yang dipublikasikan adalah pandangan satu sumber pada satu waktu.
- Empat jenis kurs kerap tertukar, dan penggunaan kurs yang keliru adalah penyebab paling umum selisih rekonsiliasi dalam sistem keuangan.
- Kurs referensi bank sentral dipublikasikan sekali sehari serta stabil dan dapat dikutip, sehingga tepat untuk akuntansi dan tidak tepat untuk penetapan harga.
- Kurs yang dibayar pelanggan Anda mencakup spread, sehingga kurs mid-market tidak pernah sama dengan mutasi kartu, dan menampilkannya sebagai harga akan menimbulkan tiket dukungan.
- Selalu simpan kurs, sumber, dan stempel waktu bersama setiap jumlah yang dikonversi, atau konversi tersebut tidak dapat direproduksi kemudian.
Mengapa tidak ada satu kurs tunggal?
Karena mata uang utama diperdagangkan di luar bursa antara institusi, bukan di satu bursa sentral. Tidak ada bel penutupan dan tidak ada publikasi resmi, sehingga setiap angka yang dipublikasikan merupakan agregasi dari sumber tertentu pada saat tertentu.
Hal ini berdampak langsung pada perangkat lunak: dua API yang ditanyakan dengan selang satu detik dapat secara wajar mengembalikan angka berbeda, dan tidak ada yang cacat. Masalah rekonsiliasi yang ditimbulkannya tidak selesai dengan mencari sumber yang lebih baik. Masalah tersebut selesai dengan memutuskan sumber mana yang berwenang untuk tujuan mana dan mencatat keputusan itu pada setiap jumlah yang disimpan.
Jenis kurs apa saja yang ada?
Ada empat, dengan tujuan yang berbeda, dan setiap API kurs pertukaran mata uang mengembalikan salah satunya. Kami menyebutnya model kurs 4 bagian.
| Jenis | Pengertiannya | Gunakan untuk |
|---|---|---|
| 1. Mid-market | Titik tengah antara harga beli dan jual di berbagai pasar utama | Tampilan, analitik, perbandingan internal |
| 2. Referensi bank sentral | Referensi harian yang dipublikasikan, ditetapkan pada waktu tertentu | Akuntansi, pajak, kontrak, segala hal yang dapat diaudit |
| 3. Kurs transaksi | Kurs yang benar-benar diterapkan oleh penyedia pembayaran atau jaringan kartu, termasuk spread | Rekonsiliasi terhadap penyelesaian transaksi sebenarnya |
| 4. Kurs terjamin | Kurs yang dikunci untuk suatu jangka waktu oleh penyedia, dengan margin untuk jaminan tersebut | Penetapan harga checkout ketika total tidak boleh berubah |
Kegagalan klasik adalah menampilkan kurs mid-market saat checkout dan menyelesaikan transaksi dengan kurs transaksi. Pelanggan melihat satu angka dan dikenai angka lain, dan selisih itu sepenuhnya dapat diprediksi serta sepenuhnya dapat dihindari.
Bagaimana kurs harus dipilih dan disimpan?
| Tujuan | Gunakan kurs ini ketika | Hindari ketika |
|---|---|---|
| Pelaporan keuangan | Referensi bank sentral, dengan tanggal | Anda memerlukan ketepatan intrahari, yang tidak disediakan referensi |
| Harga produk yang ditampilkan kepada pengguna | Kurs terjamin atau kurs transaksi, dengan spread diungkapkan | Menggunakan mid-market, yang tidak akan sama dengan tagihan |
| Analitik dan dasbor | Mid-market, secara konsisten, dari satu sumber | Mencampur sumber antarbagan, yang menciptakan variasi palsu |
| Perbandingan historis | Kurs yang disimpan pada saat itu | Mengonversi ulang riwayat dengan kurs hari ini, yang menulis ulang masa lalu |
Satu aturan penyimpanan mencakup sebagian besar kesulitan: bersama setiap jumlah yang dikonversi, simpan jumlah asli, mata uang, kurs, sumber, dan stempel waktu. Sistem yang hanya menyimpan angka hasil konversi tidak dapat menjawab mengapa sebuah angka berubah, dan pertanyaan itu selalu muncul pada akhirnya.
Di mana pengumpulan data berperan, dan apa batasannya?
Gunakan sumber resmi untuk kurs referensi. Bank sentral memublikasikannya secara terbuka dan dalam format yang dapat dibaca mesin. Melakukan scraping pada situs keuangan untuk angka yang dipublikasikan bank sentral sebagai API hanya membawa kerugian: keandalan lebih buruk, asal-usul data lebih buruk, dan masalah ketentuan yang tidak Anda perlukan.
Data pasar memiliki lisensi. Kurs institusional langsung adalah produk berlisensi dengan ketentuan redistribusi, sama seperti data pasar ekuitas. Feed tampilan gratis jarang memiliki lisensi untuk dijual kembali atau digunakan secara langsung kepada pelanggan.
Pasangan kripto adalah masalah yang berbeda. Pasangan ini diperdagangkan di banyak pasar dengan harga yang benar-benar berbeda, sehingga satu kurs merupakan pilihan editorial mengenai pasar mana yang akan disertakan dan bagaimana pembobotannya. Nyatakan pilihan yang Anda buat.
Penggunaan request yang dipatok ke negara bersifat terbatas: beberapa portal resmi dan situs keuangan regional membatasi atau melokalkan akses berdasarkan asal. DataImpulse residential mencakup hal itu dengan harga $1 per GB di 195 negara. Kursnya sendiri harus berasal dari penerbit resmi.
Terkait: lisensi data pasar, apakah web scraping sah.
Pertanyaan yang Sering Diajukan
Mengapa dua API mata uang mengembalikan kurs yang berbeda?
Karena mata uang utama diperdagangkan di luar bursa tanpa bursa sentral, sehingga setiap kurs yang dipublikasikan merupakan agregasi satu sumber pada satu saat. Dua API yang ditanyakan dengan selang satu detik dapat berbeda secara wajar, sehingga sumber yang berwenang harus dipilih berdasarkan tujuan dan dicatat.
Kurs pertukaran mana yang harus saya gunakan untuk akuntansi?
Kurs referensi bank sentral, yang disimpan bersama tanggalnya. Kurs ini dipublikasikan sekali sehari pada waktu tetap, stabil dan dapat dikutip, serta merupakan yang diharapkan auditor. Kurs ini bukan pilihan yang tepat untuk penetapan harga checkout, karena tidak akan sama dengan jumlah yang benar-benar dibayar pelanggan.
Mengapa bank pelanggan saya mengenakan jumlah yang berbeda?
Karena kurs mid-market tidak memiliki spread, sedangkan transaksi nyata memilikinya. Jaringan kartu dan penyedia pembayaran menerapkan kurs mereka sendiri ditambah margin, sehingga menampilkan mid-market saat checkout menjamin ketidaksesuaian antara jumlah yang ditampilkan dan yang ditagihkan.
Haruskah saya melakukan scraping kurs pertukaran dari situs keuangan?
Tidak. Bank sentral memublikasikan kurs referensi secara terbuka dalam format yang dapat dibaca mesin, dan kurs pasar institusional adalah produk berlisensi dengan ketentuan redistribusi. Scraping memberikan asal-usul data dan keandalan yang lebih buruk untuk data yang sudah tersedia dengan semestinya.
Apa yang harus saya simpan bersama jumlah yang dikonversi?
Jumlah dan mata uang asli, kurs yang diterapkan, sumber kurs tersebut, serta stempel waktu. Tanpa kelima hal itu, angka historis tidak dapat direproduksi atau dijelaskan, dan mengonversi ulang riwayat yang tersimpan dengan kurs saat ini secara diam-diam menulis ulang laporan masa lalu.
Akses penerbit resmi dari wilayah yang tepat
Beberapa portal keuangan resmi dan regional melokalkan atau membatasi akses berdasarkan asal. DataImpulse residential proxies menyediakan jalur keluar yang dipatok ke negara dengan harga $1 per GB di 195 negara. Buat akun dan verifikasi satu sumber dari wilayahnya sendiri.
Terkait: API data pasar saham · portal data publik · apakah web scraping sah.
Terakhir diperbarui: 17 September 2026.