Checkout untuk Miva

Dalam 24 jam setelah mendaftar, perwakilan onboarding yang berdedikasi akan menghubungi Anda untuk memulai proses integrasi yang disesuaikan.

Penting: Langkah-langkah yang tercantum di bawah ini hanya untuk referensi Anda dan Anda akan dipandu melaluinya oleh perwakilan onboarding Anda.

1. Unduh modul dari Miva App Store, atau minta file zonos.mvc langsung dari Zonos.
2. Di admin Miva Anda, buka Pengaturan Domain -> Modul -> Tambah Modul, unggah file zonos.mvc, lalu klik Tambah.

3. Buka Pengaturan -> Modul, cari Zonos, lalu klik Pasang. Konfirmasikan statusnya ditampilkan sebagai Terpasang.

Di Miva, buka Pengguna -> Token API lalu klik Add API Token. Konfigurasikan sebagai berikut:

• Name: Zonos Checkout
• Allowed IP Addresses: 0.0.0.0/0, ::/0
• Signature: Require Signature with Key -- klik Generate untuk membuat kunci penandatanganan
• Timestamp: Require Timestamp Within 30 seconds

Pada layar berikutnya, aktifkan Customer Service & Sales untuk mengizinkan token membuat dan mengubah pesanan. Klik Save.

Navigasikan ke modul Checkout di Miva dengan membuka Miva -> Pengaturan Utilitas -> Zonos, lalu isi bidang berikut:

1. Store ID: Salin nomor akun Zonos Anda dari Dashboard -> Pengaturan -> Akun -> Integrasi.
2. Zonos API Key: Kunci API rahasia Anda (jangan pernah membagikannya).
3. Zonos Public Key: Kunci publik Anda.
4. Store Currency: Mata uang dasar toko Anda (misalnya, USD).
5. Environment: Pilih Live untuk produksi atau Test untuk pengujian.
6. Checkout Button Selector: Selektor CSS untuk tombol checkout Anda (contoh: a[href*="checkout.html"]).
7. Hidden Selectors: Untuk menyembunyikan opsi pembayaran domestik dan detail lain yang mungkin tidak relevan bagi pelanggan internasional.
8. Import Orders: Centang untuk mengimpor pesanan Zonos yang selesai secara otomatis ke admin Miva. Ini memerlukan webhook untuk didaftarkan pada langkah berikutnya.

Klik Perbarui di kanan atas untuk menyimpan sebelum melanjutkan.

Pesanan diimpor melalui webhook di modul 10.x. Versi modul sebelumnya menggunakan URL/endpoint keberhasilan pesanan sebagai gantinya.

Setelah menyimpan pengaturan Anda, klik Daftarkan Webhook. Ini menghubungkan toko Anda ke Zonos sehingga pesanan yang selesai diimpor secara otomatis, pembatalan disinkronkan, dan pembaruan pengiriman dikirim kembali ke Miva.

Webhook harus didaftarkan sebelum impor pesanan, sinkronisasi pembatalan, dan pembaruan pengiriman dapat berfungsi. Kotak centang Import Orders memerlukan webhook untuk didaftarkan.

Gulir ke bawah untuk melengkapi bidang yang tersisa:

1. Miva API Token: Access Token dari Token API yang Anda buat di langkah Buat token API.
2. Miva API Signature: Signing Key dari entri Token API yang sama.
3. Image Type: Memilih ukuran gambar produk mana yang ditampilkan di checkout Zonos (Main cocok untuk sebagian besar toko).
4. Additional Field Mappings: Secara opsional memetakan bidang khusus Miva ke atribut/metadata Zonos (warna, material, ukuran, dll.). Kami merekomendasikan memetakan kode HS jika Anda telah menetapkan kode HS khusus produk di daftar produk Miva Anda. Ini tidak diperlukan untuk menghasilkan penawaran bea cukai dan pajak karena kami dapat menggunakan kode HS khusus produk yang telah Anda masukkan ke dalam Katalog atau menggunakan kode HS default Anda. Namun, ini direkomendasikan; akurasi perhitungan biaya mendarat akan meningkat secara signifikan dengan produk yang diklasifikasikan dengan benar. Untuk memetakan bidang di Miva, buat bidang khusus untuk kode HS lalu petakan di bawah Pengaturan Utilitas -> Zonos.

Klik Perbarui untuk menyimpan semua pengaturan.

Sekarang setelah Anda menyiapkan akun dan modul Anda, Anda siap melakukan pengujian dengan melakukan hal berikut:

• Uji penawaran pengiriman
• Tempatkan pesanan uji di situs Anda
• Uji alur pesanan melalui sistem Anda
• Uji situs web Anda

Pelajari cara menjalankan pengujian ini. Anda perlu mengatur bidang Environment modul ke Test saat melakukan pengujian.

Setelah menyelesaikan pengujian, Anda sekarang siap untuk go live! Atur Environment ke Live, konfirmasikan kredensial Zonos Anda sudah benar, dan pastikan webhook telah didaftarkan di toko aktif Anda.

1. Buka dashboard.zonos.com -> Hello -> Hello Settings.
2. Aktifkan Currency behavior.
3. Masukkan selektor CSS yang menargetkan elemen harga produk Anda (misalnya, .price).

Zonos Hello akan secara otomatis mengonversi dan menampilkan harga dalam mata uang lokal pembeli saat ini diaktifkan.

Dimensi pengiriman, negara asal, dan kode HS yang ditetapkan di katalog Miva dipetakan secara otomatis ke Zonos dan digunakan untuk penawaran biaya mendarat / pengiriman jika terisi. Tidak diperlukan pemetaan tambahan untuk mengonfigurasinya.

Jika toko Anda menjual produk yang dapat dikonfigurasi dengan semua variasi berbagi satu SKU, Product Shipping Rules standar Miva menyimpan satu set dimensi per produk, sehingga setiap konfigurasi diperlakukan dengan ukuran yang sama terlepas dari apa yang dipilih pelanggan.

Miva dan Zonos mendukung dimensi di tingkat varian, tetapi itu memerlukan penyiapan setiap varian secara individual. Ini mungkin tidak praktis untuk toko dengan ratusan atau ribuan konfigurasi yang tidak dipetakan ke varian diskret.

Fitur ini mengatasi hal tersebut dengan membaca dimensi per konfigurasi langsung dari keranjang saat checkout, menggunakan logika khusus apa pun yang sudah diterapkan toko Anda untuk menghitungnya -- misalnya, mengurai dimensi dari deskripsi produk.

Persyaratan

• Toko Anda harus sudah mengisi kolom dimensi khusus pada item keranjang saat item ditambahkan ke keranjang (ditangani di sisi Miva, di luar cakupan modul Zonos).
• Anda perlu mengetahui nama kolom persis yang Anda gunakan.

Konfigurasi

Masukkan nama kolom tersebut ke dalam tiga bidang yang sesuai di admin modul Zonos. Biarkan kosong untuk kembali ke Product Shipping Rules standar -- fitur ini sepenuhnya opt-in dan tidak akan memengaruhi toko yang tidak menggunakannya.

Saat label pengiriman dibuat atau nomor pelacakan dimasukkan di Zonos Dashboard, nomor pelacakan dan status pengiriman secara otomatis dikirim ke pesanan terkait di admin Miva. Ini memerlukan webhook untuk didaftarkan (lihat langkah Daftarkan webhook di atas).

Pelacakan juga dapat dimasukkan langsung di Miva. Gunakan dialog input Enter Tracking Number pada pesanan Zonos mana pun -- nomor pelacakan dan status pengiriman akan disinkronkan kembali ke Zonos Dashboard secara otomatis.

Log debug dapat diakses di dalam admin Miva, di bawah pengaturan modul Zonos. Log ini mencatat siklus hidup lengkap setiap peristiwa pesanan yang diproses oleh modul -- impor, sinkronisasi pelacakan, pembatalan, dan permintaan pembatalan keluar ke Zonos -- termasuk keberhasilan maupun kegagalan secara inline.

Setiap entri mencakup ID pesanan Zonos, ID pesanan Miva, dan, jika relevan, detail tingkat pelanggan seperti respons kesalahan dari API Miva atau Zonos. Ini menjadikannya sumber informasi paling lengkap untuk mendiagnosis masalah.

Log hanya menyimpan 500 baris terbaru. Entri yang lebih lama tidak diarsipkan, jadi periksa segera setelah masalah terjadi -- peristiwa sebelumnya mungkin sudah tertimpa.

Log kesalahan publik (tidak memerlukan login) 

Log kedua yang ditujukan untuk publik tersedia melalui URL langsung -- tidak memerlukan login admin Miva. Log ini hanya mencatat kesalahan (tidak ada keberhasilan) dan tidak berisi PII pelanggan atau data sensitif. Setiap entri diawali dengan versi modul (misalnya, [v10.09]) untuk identifikasi cepat.

Format URL:

https://[store-domain]/mm5/json.mvc?Store_Code=[miva_store_code]&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Contoh:

https://dts4509.mivamerchantdev.com/mm5/json.mvc?Store_Code=Test&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Kode toko: miva_store_code dikembalikan dalam array metadata dari respons API untuk semua pesanan dashboard.

Semua pengembalian dana pembayaran harus diproses langsung melalui dashboard Zonos. Tombol Refund, Capture, dan Void di Miva tidak tersedia untuk pesanan yang diimpor dari Zonos, sesuai desain. Setiap pengembalian dana yang diproses di Zonos tidak akan secara otomatis memperbarui jumlah pembayaran pada pesanan Miva terkait -- pesanan Miva mempertahankan jumlah yang telah ditangkap (captured) semula dan tidak disinkronkan dengan aktivitas pengembalian dana di Zonos.

Untuk pembatalan pesanan, perilakunya bergantung pada status pesanan saat ini:

• Open (belum dikirim): Membatalkannya di Miva juga akan membatalkannya di Zonos dan membatalkan otorisasi pembayaran. Karena Zonos tidak menangkap pembayaran hingga pesanan dikirim, pelanggan tidak pernah benar-benar dikenakan biaya dan tidak diperlukan pengembalian dana terpisah.
• Shipped atau Completed: Membatalkan di Miva akan menandai pesanan Miva sebagai dibatalkan, tetapi Zonos akan menolak pembatalan tersebut karena pesanan telah dipenuhi dan tidak lagi memenuhi syarat untuk pembatalan otomatis. Dalam kasus ini, catatan khusus admin ditambahkan ke pesanan Miva -- hanya terlihat oleh staf toko dan tidak pernah oleh pelanggan -- yang menjelaskan bahwa pesanan perlu ditangani di Zonos. Notifikasi email juga dikirim ke alamat email utama akun toko untuk memberi tahu pedagang agar mengambil tindakan di dashboard Zonos, tempat mereka dapat memproses pengembalian dana yang berlaku secara manual.

Gejala: Pesanan selesai di Zonos Checkout dan muncul di dashboard Zonos, tetapi tidak ada yang muncul di admin Miva.

Penyebab: Zonos mengirim webhook ORDER_CREATED (HTTP POST) ke endpoint /mm5/json.mvc toko Anda. Di situs dev, keamanan tingkat server sering memblokir permintaan ini sebelum mencapai Miva. Penyebab umum:

• HTTP Basic Auth -- Jika situs dev memiliki prompt kata sandi (Plesk, cPanel, .htaccess, dll.), webhook akan ditolak dengan 401 Unauthorized. Whitelist IP Zonos di konfigurasi .htaccess atau Plesk Anda agar dapat melewati prompt autentikasi.
• Cloudflare WAF / IP Access Rules -- Jika situs diproksi melalui Cloudflare, aturan keamanannya dapat memblokir POST sebelum mencapai server Anda. Tambahkan aturan WAF untuk mengizinkan permintaan POST yang jalur URL-nya mengandung /mm5/json.mvc, atau whitelist IP Zonos langsung di IP Access Rules Cloudflare.
• Daftar putih IP tingkat server -- Jika situs dev membatasi traffic hanya ke IP tertentu (umum pada lingkungan staging yang dikunci ke IP kantor atau platform), permintaan webhook Zonos akan langsung ditolak tanpa respons. Tambahkan semua IP pengiriman webhook Zonos ke daftar putih server Anda (Plesk IP Access Restriction Manager, cPanel IP Blocker, atau aturan keamanan firewall/panel hosting Anda).

IP pengiriman webhook Zonos

195.85.106.100/32
67.207.37.24/29
18.118.243.230/32
18.191.115.116/32
18.216.243.49/32
18.218.198.53/32
18.221.118.18/32
18.223.39.35/32
3.128.123.176/32
3.132.179.92/32
3.138.165.252/32
3.19.11.176/32
3.22.153.63/32
52.15.215.38/32

Ini biasanya hanya memengaruhi situs dev/staging -- situs Miva produksi biasanya bersifat publik dan tidak memerlukan whitelisting IP. Jika tidak yakin cara mengonfigurasi ini, hubungi penyedia hosting atau dukungan Miva Anda.

Informasi produk dapat berdampak pada jumlah bea cukai dan pajak yang terutang serta biaya pengiriman. Semakin banyak informasi produk yang Anda berikan kepada Zonos, semakin presisi penawaran yang dikembalikan. Zonos dapat menghasilkan penawaran bahkan ketika informasi ini tidak tersedia, tetapi merekomendasikan untuk memberikan detail produk utama berikut untuk meningkatkan akurasi:

• Berat: Berat berdampak pada biaya pengiriman Anda, yang dapat mempengaruhi bea cukai atau pajak. Berat dalam daftar produk Miva Anda secara otomatis digunakan oleh Zonos saat ada.
• Dimensi: Dimensi dapat berdampak pada biaya pengiriman Anda, yang dapat mempengaruhi bea cukai atau pajak. Zonos dapat memanfaatkan dimensi produk (panjang, lebar, dan tinggi) yang ditetapkan pada setiap produk di Miva, tetapi Anda harus memetakannya di aplikasi Zonos untuk integrasi yang tepat.
• Kode HS: Kode HS berdampak pada tarif bea cukai dan terkadang dapat mempengaruhi pajak. Zonos dapat menggunakan kode HS yang ditetapkan dalam daftar produk Anda di Miva, tetapi Anda harus memetakan bidang kode HS di aplikasi Zonos.
• Negara asal: Negara asal produk berdampak pada tarif bea cukai dan dapat mempengaruhi pajak. Miva tidak dapat mengirimkan negara asal produk Anda ke Zonos sehingga harus ditambahkan menggunakan Katalog Zonos.

Detail produk yang diteruskan ke Zonos oleh Miva 

Catatan: Sebagai alternatif, Anda dapat memasukkan informasi apa pun di atas ke Katalog, mengesampingkan informasi yang disimpan dan diteruskan dari Miva.

Pelajari lebih lanjut tentang informasi produk berdasarkan platform.