Daftar periksa integrasi
Ikuti daftar periksa komprehensif ini untuk mengatur akun Dashboard Zonos Anda dan mengintegrasikan ekstensi Zonos Checkout untuk WooCommerce.
Buat akun Zonos
Untuk memulai, silakan hubungi tim penjualan kami untuk membuat akun dan menandatangani perjanjian. Setelah perjanjian ditandatangani, Anda akan menerima dua setoran mikro di akun Anda yang perlu diverifikasi.
Silakan kirimkan jumlah setoran mikro ini ke accounting@zonos.com dengan ID toko Dashboard Anda (CC perwakilan penjualan Anda).
Setelah diverifikasi, detail perbankan Anda akan ditampilkan di Dashboard -> Settings -> Billing.
Konfigurasi pengaturan Dashboard dan Checkout
Setelah membuat akun Zonos, Anda perlu mengonfigurasi pengaturan di Dashboard untuk memastikan Checkout berfungsi dengan baik di toko Anda. Bagian ini mencakup semua konfigurasi Dashboard yang penting.
Atur pembayaran
Hubungkan rekening bank untuk menerima pembayaran tepat waktu dari Checkout. Pembayaran diproses setiap hari dengan penundaan 2 hari dari pembayaran yang diterima. Untuk melakukan ini, silakan ikuti langkah-langkah berikut:
- Navigasikan ke Dashboard -> Settings -> Checkout settings .
- Klik Add bank account.
- Anda akan dibawa ke portal Stripe untuk menyelesaikan pengaturan dan memberikan informasi berikut:
- Informasi rekening bank.
- EIN perusahaan.
- Nomor Jaminan Sosial pemilik perusahaan 25%. Untuk informasi lebih lanjut tentang mengapa ini diperlukan, lihat dokumentasi Stripe.
Catatan: Jika Anda perlu memperbarui jadwal pembayaran Anda, silakan hubungi support@zonos.com
Atur domain yang diizinkan
Zonos Checkout memerlukan daftar domain yang diizinkan untuk tujuan keamanan. Ini mencegah situs yang tidak sah memuat Checkout dan memastikan hanya berjalan di domain yang Anda setujui. Tanpa konfigurasi ini, Checkout akan mengembalikan kesalahan izin.
Untuk mengatur ini:
- Navigasikan ke Dashboard -> Settings -> Checkout settings.
- Di bawah URLs, tambahkan domain lengkap Anda dan subdomain mana pun di mana Checkout akan digunakan. Misalnya, jika domain Anda adalah
example.com
, Anda harus menambahkanexample.com
dantest.example.com
.
Sesuaikan pengaturan merek
Konfigurasikan pengaturan merek Anda di Dashboard agar sesuai dengan tampilan dan nuansa toko Anda.
Untuk melakukan ini, silakan ikuti langkah-langkah berikut:
- Navigasikan ke Dashboard -> Settings -> Checkout settings -> Branding
- Konfigurasikan pengaturan berikut:
- Logo.
- Warna merek dan aksen.
- Tema, Gaya, dan Font.
Untuk informasi lebih lanjut tentang pengaturan merek, lihat dokumentasi kami.
Hubungkan penyedia pengiriman
Untuk mengutip pengiriman di checkout, Anda perlu menghubungkan penyedia pengiriman ke akun Zonos Anda. Ini akan memungkinkan Anda untuk mengaktifkan tingkat layanan pengiriman tertentu di checkout.
Untuk menghubungkan penyedia pengiriman, silakan ikuti langkah-langkah berikut:
- Navigasikan ke Dashboard -> Settings -> Shipping -> Rates.
- Klik Add carrier.
- Ikuti instruksi pengaturan penyedia.
Untuk informasi lebih lanjut tentang menghubungkan akun penyedia, lihat dokumentasi kami.
Atur zona pengiriman
Zona pengiriman memungkinkan Anda mengonfigurasi penyedia pengiriman dan tingkat layanan mana yang tersedia untuk berbagai wilayah di dunia.
Untuk mengatur zona pengiriman, silakan ikuti langkah-langkah berikut:
- Navigasikan ke Dashboard -> Settings -> Shipping -> Locations.
- Klik New zone.
- Masukkan nama zona dan pilih negara yang ingin Anda kirimkan.
- Pilih penyedia dan tingkat layanan yang ingin Anda tawarkan.
Untuk informasi lebih lanjut tentang zona pengiriman, lihat dokumentasi kami.
Atur negara asal cadangan dan kode HS
Negara asal dan kode HS digunakan untuk menghitung bea dan pajak yang akurat.
Jika Anda tidak memberikan negara asal atau kode HS tertentu, kami akan menggunakan cadangan yang diatur di Dashboard.
Untuk mengatur Negara Asal dan kode HS cadangan Anda:
- Navigasikan ke Dashboard -> Settings -> Shipping -> Catalog.
- Untuk negara asal, pilih negara di mana sebagian besar produk Anda diproduksi.
- Untuk kode HS, masukkan kode HS produk Anda yang paling umum. Jika Anda tidak memiliki kode HS, navigasikan ke Classify di Dashboard dan masukkan nama serta deskripsi produk Anda untuk menghasilkan kode HS yang akurat.
Instal dan konfigurasikan ekstensi Checkout untuk WooCommerce
Ikuti langkah-langkah ini untuk menginstal dan mengonfigurasi ekstensi Checkout untuk WooCommerce.
Instal ekstensi
- Masuk ke admin WordPress Anda.
- Di bawah plugin, cari ekstensi Zonos Checkout untuk WooCommerce.
- Klik Instal dan aktifkan.
Hubungkan ekstensi ke akun Zonos
-
Di Admin WordPress Anda, klik pada ekstensi Zonos Checkout di navigasi sebelah kiri.
-
Klik pada Pengaturan Umum.
-
Masukkan Kunci API Pribadi dan ID Toko Anda untuk menghubungkan pengaturan Dasbor Zonos Anda ke situs WooCommerce Anda.
-
Temukan kunci API pribadi toko Anda di Dasbor. Ada beberapa kunci API yang tersedia. Pilih kunci API yang memiliki nama toko Anda, Tipe adalah Rahasia, dan Token dimulai dengan
credential_live
. Masukkan kunci API ini di kolom Kunci API Pribadi di Pengaturan Umum ekstensi. -
Salin ID Toko Anda dari Dasbor dan masukkan ini ke dalam kolom ID Toko di Pengaturan Umum ekstensi.
-
-
Aktifkan aplikasi dalam mode uji.
- Secara default, Mode Uji diaktifkan. Ketika mode uji diaktifkan, pembeli tidak akan diarahkan ke Zonos Checkout.
Konfigurasikan tombol checkout internasional Anda
Anda memiliki dua opsi untuk mengonfigurasi bagaimana pembeli internasional mengakses Zonos Checkout.
Gunakan tombol checkout saat ini untuk pembeli domestik dan internasional:
Konfigurasikan tombol checkout saat ini untuk secara otomatis mengarahkan pembeli internasional ke Zonos Checkout sambil menjaga pembeli domestik pada alur checkout standar Anda. Untuk melakukan ini, ikuti langkah-langkah berikut:
- Di Pengaturan Umum ekstensi, masukkan pemilih CSS tombol checkout Anda (misalnya,
#checkout-button
atau.woocommerce-checkout-button
). - Klik Simpan pengaturan umum.
Untuk menemukan pemilih CSS Anda, klik kanan tombol checkout, pilih "Periksa", dan cari atribut id
atau class
dalam HTML. Jika Anda memiliki beberapa tombol checkout, sertakan pemilih CSS setiap tombol atau konfigurasikan semua tombol untuk mengarahkan ke halaman keranjang dan gunakan pemilih tombol checkout halaman keranjang.
Tambahkan tombol checkout internasional yang khusus
Buat tombol checkout internasional yang khusus, yang ideal jika Anda memiliki banyak pengguna VPN atau pembeli yang berbasis di AS yang perlu mengirim ke alamat internasional.
Untuk membuat tombol terpisah untuk pembeli internasional:
-
Di Pengaturan Umum ekstensi, masukkan pemilih CSS tombol checkout Anda (misalnya,
#checkout-button
atau.woocommerce-checkout-button
). -
Alihkan tombol Tombol checkout internasional ke kanan.
-
Konfigurasikan penampilan tombol:
- Masukkan teks tombol (misalnya, "Internasional Checkout" atau "Global Checkout").
- (Opsional) Tambahkan CSS kustom untuk mencocokkan desain toko Anda seperti yang ditunjukkan dalam contoh di bawah ini. Jika tidak ada CSS kustom yang disediakan, tombol akan default ke skema warna utama toko Anda. Kami merekomendasikan untuk menguji penampilan tombol di perangkat desktop dan seluler.
-
Klik Simpan pengaturan umum.
Aktifkan AS di Zona Pengiriman: Ketika diaktifkan, tombol checkout internasional yang khusus akan muncul untuk semua pembeli. Untuk memungkinkan pembeli yang berbasis di AS menggunakan checkout internasional (misalnya, saat menggunakan VPN atau mengirim ke alamat internasional), Anda harus mengaktifkan AS di Zona Pengiriman di Dasbor. Tanpa pengaturan ini, pembeli AS tidak akan diarahkan ke Zonos Checkout.
Peta pengaturan WooCommerce
Sesuaikan Zonos untuk terintegrasi dengan mulus dengan toko WooCommerce Anda, memastikan perhitungan bea, pajak, dan pengiriman yang akurat. Gunakan tab Pengaturan Pemetaan untuk menyelaraskan detail produk dan atribut dengan pengaturan ecommerce Anda. Meskipun nilai default disediakan, Anda dapat mengonfigurasi pengaturan ini agar sesuai dengan kebutuhan unik toko Anda.
Detail produk, detail kustom, berat, dan dimensi
Bidang ini dipetakan ke nilai umum default. Nilai yang ditandai dengan asterisk (*) adalah wajib. Jika Anda menggunakan aplikasi pihak ketiga yang menimpa bidang (*) apa pun, pastikan bidang (*) ini dipetakan dengan benar ke nilai yang digunakan aplikasi pihak ketiga.
Atribut produk
Jika produk Anda memiliki atribut unik seperti warna atau ukuran yang diterapkan pada variasi, Anda perlu memetakan atribut ini di ekstensi Zonos. Ini memastikan bahwa ketika pesanan dipenuhi, toko WooCommerce Anda dan inventaris diperbarui dengan produk yang benar yang dikirim. Untuk memetakan atribut, ikuti langkah-langkah yang dijelaskan dalam dokumentasi pemetaan atribut produk WooCommerce kami.
Catatan: Jika Anda memiliki pertanyaan atau memerlukan bantuan dalam memetakan variasi produk, silakan hubungi support@zonos.com.
Uji integrasi Anda
Sekarang setelah Anda mengatur akun dan aplikasi Anda, Anda siap untuk menguji integrasi Anda.
Untuk melakukan pemesanan uji di checkout:
- Tambahkan
?zonosTestMode=1
ke URL toko Anda untuk diarahkan ke Zonos Checkout. - Ubah Zonos Hello ke negara yang ingin Anda uji dengan mengklik bendera Hello dan memilih negara yang ingin Anda uji. Ini diperlukan atau Anda tidak akan diarahkan ke Zonos Checkout jika menggunakan tombol checkout tunggal. Anda dapat memperbarui Hello dengan mengubah zCountry= di URL ke negara mana pun yang ingin Anda uji. Misalnya, jika Anda ingin menguji Kanada, Anda akan memasukkan CA di zCountry=CA.
- Jalankan proses checkout dan lakukan pemesanan. Lihat dokumentasi pengujian umum kami untuk detail lebih lanjut.
- Setelah menyelesaikan pengujian, aktifkan Zonos dengan mengubah Test mode menjadi off. Ini akan menghidupkan integrasi Anda dan memungkinkan pembeli internasional menggunakan Zonos Checkout.
Beberapa hal yang perlu diingat:
- De minimis—Jika subtotal keranjang belanja Anda di bawah de minimis negara tujuan pengiriman, mungkin tidak ada bea atau pajak yang harus dibayar. Ini tercermin dalam perhitungan kami.
- Pengembalian dan pembatalan—Kami mengumpulkan pembayaran, jadi jika Anda perlu melakukan pengembalian atau pembatalan, silakan proses ini di Dashboard.
- Label—Cetak label untuk semua pesanan internasional di Dashboard, kecuali jika Anda telah disertifikasi untuk mencetak label di luar Dashboard. Ini diperlukan agar Zonos dapat membayar bea dan pajak atas nama Anda.
Pasca-integrasi
Ekstensi Zonos Anda akan secara otomatis mengimpor pesanan dari Zonos ke WooCommerce. Namun, mungkin ada kasus langka di mana pesanan tidak terimpor atau status pesanan di WooCommerce tidak sinkron dengan Dashboard. Anda dapat menggunakan fitur berikut dalam ekstensi untuk mengimpor pesanan, menyinkronkan status pesanan secara manual, dan mengaktifkan pengaturan lanjutan untuk memecahkan masalah.
Mengimpor pesanan secara manual
Jika pesanan Zonos belum terimpor ke WooCommerce, Anda dapat menggunakan tab Order import untuk mengimpor pesanan secara manual ke WooCommerce:
- Masuk ke Dashboard.
- Navigasikan ke Orders.
- Klik pada pesanan yang perlu diimpor dan salin Zonos order number.
- Di Admin WordPress, navigasikan ke tab Order import di Ekstensi Zonos, dan masukkan nomor pesanan Zonos ke dalam field Zonos order number.
- Klik Import order. Jika pesanan berhasil diimpor, pesanan akan muncul di WooCommerce dan Anda akan melihat banner "Order imported successfully" di bagian atas halaman. Jika pesanan gagal diimpor, Anda akan melihat banner dengan rincian pesan kesalahan.
Menyinkronkan pesanan secara manual
Jika status pesanan di WooCommerce tidak cocok dengan status di Zonos, Anda dapat menyinkronkan pesanan secara manual.
- Masuk ke Dashboard.
- Navigasikan ke Orders.
- Klik pada pesanan yang perlu diimpor dan salin Zonos order number.
- Di Admin WordPress, navigasikan ke tab Order sync di Ekstensi Zonos, dan masukkan nomor pesanan Zonos ke dalam field Zonos order number.
- Klik Sync order. Status pesanan di WooCommerce sekarang harus cocok dengan status pesanan di Dashboard.
Pengaturan lanjutan
Mode Debug
Aktifkan Debug mode untuk mengirim log rinci Zonos untuk membantu Anda mendiagnosis masalah dan meningkatkan kinerja integrasi Anda.
Batas Rate
Jumlah maksimum permintaan webhook yang diizinkan per alamat IP per menit. Defaultnya adalah 30 untuk melindungi dari potensi penyalahgunaan.
Pemecahan Masalah Umum
Jika Anda menggunakan aplikasi caching seperti WP Rockett, Anda perlu clear cache Anda saat Anda melakukan perubahan pada Ekstensi Zonos Anda.
Pertanyaan yang Sering Diajukan
Informasi produk apa yang harus saya berikan untuk kutipan yang paling akurat tentang bea, pajak, dan biaya pengiriman?
Informasi produk dapat mempengaruhi jumlah bea dan pajak yang harus dibayar, serta total biaya pengiriman. Semakin banyak informasi produk yang Anda berikan kepada Zonos, semakin tepat kutipan yang diberikan. Zonos dapat menghasilkan kutipan bahkan ketika informasi ini tidak tersedia, tetapi merekomendasikan untuk memberikan detail produk kunci berikut untuk meningkatkan akurasi:
- Berat: Berat mempengaruhi biaya pengiriman Anda, yang dapat mempengaruhi bea atau pajak. Berat dalam daftar produk WooCommerce Anda secara otomatis digunakan oleh Zonos saat dipetakan. Anda juga dapat menambahkan berat ke Catalog di Dashboard untuk memastikan perhitungan pengiriman yang akurat.
- Dimensi: Dimensi digunakan untuk menghitung berat dimensi. Pengangkut akan mengenakan biaya berdasarkan berat yang lebih besar antara berat fisik dan berat dimensi. Zonos dapat memanfaatkan dimensi produk (panjang, lebar, dan tinggi) yang ditetapkan pada setiap produk di WooCommerce untuk menghitung berat dimensi agar Anda collect jumlah biaya pengiriman yang benar dari pelanggan Anda. Anda juga dapat menambahkan dimensi ke Catalog di Dashboard untuk memastikan perhitungan pengiriman yang akurat.
- Kode HS: Kode HS mempengaruhi tarif bea dan kadang-kadang dapat mempengaruhi pajak. Anda dapat memetakan nilai kode HS di WooCommerce atau menggunakan Catalog di Dashboard.
- Negara asal: Negara asal produk mempengaruhi tarif bea dan dapat mempengaruhi pajak. Anda dapat memetakan nilai negara asal di WooCommerce atau menggunakan Catalog di Dashboard.
Zonos Checkout untuk WooCommerce
Integrasikan ekstensi Checkout untuk WooCommerce.