Skrip untuk beberapa mata uang

Buat skrip yang mendukung penjualan dalam lebih dari satu mata uang.

Persyaratan paket

Skrip Shopify dan aplikasi Script Editor hanya tersedia untuk toko dengan paket Shopify Plus. Aplikasi Script Editor tidak lagi tersedia untuk diunduh dari Shopify App Store.

Pada 30 Juni 2026, Skrip Shopify akan dihapus dan tidak akan berfungsi lagi. Jika Anda ingin dukungan berkelanjutan untuk kasus penggunaan Skrip Shopify yang sudah ada, Anda harus beralih ke pengganti Shopify Functions yang kompatibel untuk skrip pembayaran, pengiriman, atau item pesanan Anda yang sudah ada. Pelajari selengkapnya tentang beralih dari Skrip Shopify ke Shopify Functions.

Diskon berbasis jumlah tetap atau persentase

Tinjau cara kerja diskon skrip saat berjualan dalam beberapa mata uang. Mungkin sulit untuk memasarkan diskon dengan jumlah tetap karena jumlahnya dapat berfluktuasi sesuai dengan tingkat konversi mata uang.

Metode

Anda dapat menggunakan metode berikut untuk membatasi atau memperluas diskon ke mata uang tertentu:

• Objek Keranjang memiliki metode baru, presentment_currency. Metode ini mengembalikan kode mata uang lokal (yang ditampilkan) pelanggan. Misalnya, Anda dapat menggunakan metode ini untuk memeriksa mata uang yang ditampilkan kepada pelanggan dan memfilter skrip Anda berdasarkan hasilnya.

• Objek Uang memiliki metode baru, Money.derived_from_presentment(customer_cents: X). Metode ini mengembalikan nilai dalam mata uang toko. X mewakili jumlah (diformat dalam sen) dalam mata uang lokal (yang ditampilkan) pelanggan. Metode ini mengonversi jumlah dalam mata uang lokal (yang ditampilkan) pelanggan Anda menjadi jumlah yang setara dalam mata uang toko Anda. Misalnya, Anda dapat menggunakan metode ini untuk menampilkan diskon kepada pelanggan dalam mata uang lokal (yang ditampilkan) mereka.

Konversi mata uang

Skrip Shopify berjalan pada mata uang toko Anda, bukan pada mata uang lokal (yang ditampilkan) pelanggan Anda:

• Sebelum skrip berjalan, jumlah di keranjang Anda dikonversi ke mata uang toko Anda.
• Setelah skrip selesai, jumlah ini dikonversi kembali ke mata uang lokal (yang ditampilkan) pelanggan Anda.

Kedua konversi ini tidak menyebabkan Anda dikenai biaya konversi. Anda hanya dikenai biaya konversi saat pembayaran ditangkap.

Tinjau skrip Anda sebelum berjualan dalam beberapa mata uang

Saat Anda mengaktifkan penjualan dalam beberapa mata uang, tinjau skrip Anda untuk memastikan skrip tersebut masih berfungsi sebagaimana mestinya:

• Skrip yang menawarkan diskon persentase - Skrip ini menawarkan diskon persentase yang sama, apa pun mata uangnya.
• Skrip yang menawarkan diskon nilai tetap - Nilai dalam skrip ini menggunakan mata uang toko Anda. Skrip yang menawarkan diskon jumlah tetap bisa sulit dipasarkan karena jumlah diskon dapat berfluktuasi sesuai nilai tukar mata uang.
• Skrip yang mengandalkan ambang batas harga tertentu untuk berjalan - Nilai dalam skrip ini menggunakan mata uang toko Anda.

Contoh

Contoh berikut menyembunyikan semua penyedia pembayaran kecuali Shopify Payments saat mata uang lokal pelanggan Anda (mata uang yang ditampilkan) berbeda dari mata uang toko Anda:

Output.payment_gateways = Input.payment_gateways.delete_if do |payment_gateway|
  Input.cart.presentment_currency != Input.cart.shop_currency && payment_gateway.name != "Shopify Payments"
end

Pelajari selengkapnya

• Dampak penggunaan penyedia pembayaran eksternal saat berjualan dalam beberapa mata uang
• Skrip Shopify