Halaman ini menjelaskan bagaimana Belajar Ekspor menggunakan Etsy Open API untuk menghubungkan toko Etsy milik pengguna dengan fitur seller di Belajar Ekspor. Integrasi dirancang untuk membantu pengguna menyinkronkan informasi toko, listing, order, transaksi, dan informasi keuangan yang relevan sesuai izin yang diberikan pengguna melalui Etsy.
The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
1. Tentang Integrasi Etsy API
Belajar Ekspor adalah platform independen. Fitur Integrasi Etsy API memungkinkan pengguna menghubungkan toko Etsy miliknya sendiri ke Belajar Ekspor untuk menggunakan fitur seperti pembukuan seller, sinkronisasi order, sinkronisasi listing, laporan keuangan, analisis performa, pemantauan biaya, dan notifikasi aktivitas toko.
Integrasi dilakukan melalui Etsy Open API. Belajar Ekspor tidak menggunakan screen scraping untuk mengambil data Etsy dan tidak meminta pengguna membuat atau membagikan API key Etsy miliknya sendiri.
2. Cara Menghubungkan Toko Etsy
Proses koneksi dilakukan melalui OAuth resmi Etsy dengan alur berikut:
- Pengguna memilih fitur Connect Etsy Store di Belajar Ekspor.
- Pengguna diarahkan ke halaman otorisasi resmi Etsy.
- Pengguna login langsung di Etsy dan meninjau izin yang diminta.
- Jika pengguna menyetujui, Etsy memberikan otorisasi kepada Belajar Ekspor.
- Belajar Ekspor menerima token OAuth untuk mengakses data sesuai scope yang disetujui pengguna.
3. Data Etsy yang Dapat Diakses
Data yang dapat diakses bergantung pada fitur yang digunakan serta permission atau OAuth scope yang disetujui pengguna. Data tersebut dapat mencakup:
- Informasi dasar toko dan Shop ID
- Nama toko, status toko, bagian toko, dan informasi toko lain yang tersedia melalui API
- Listing atau produk, termasuk status aktif, tidak aktif, atau kedaluwarsa sesuai izin yang tersedia
- Order, receipt, transaksi penjualan, dan status pemenuhan pesanan
- Informasi pembayaran, fee, payout, atau data finansial lain yang tersedia melalui endpoint yang diizinkan
- Data teknis integrasi seperti Etsy user ID, Shop ID, status koneksi, waktu sinkronisasi, dan scope yang diberikan
Belajar Ekspor berupaya meminta izin seminimal mungkin sesuai kebutuhan fitur. Jika suatu fitur baru membutuhkan izin tambahan, pengguna dapat diminta melakukan otorisasi ulang melalui Etsy.
4. Tujuan Penggunaan Data Etsy
Data Etsy yang diotorisasi pengguna dapat digunakan untuk:
- Menyinkronkan identitas dan informasi toko ke akun Belajar Ekspor
- Menampilkan listing atau produk pada Product Center
- Menyinkronkan order dan transaksi ke Pembukuan Seller Etsy
- Menghitung omzet, biaya, fee, HPP, payout, profit, dan laporan berdasarkan data yang tersedia
- Menampilkan histori transaksi dan performa toko
- Membantu memantau listing, biaya, dan aktivitas toko
- Mengirim notifikasi yang relevan, misalnya order baru atau perubahan status order, apabila fitur tersebut diaktifkan
- Mendukung analisis performa toko dan produk untuk pengguna yang bersangkutan
Data Etsy tidak digunakan untuk mengakses toko yang tidak diotorisasi pengguna dan tidak digunakan untuk tujuan yang tidak terkait dengan layanan Belajar Ekspor tanpa dasar yang sesuai.
5. Permission dan OAuth Scope
Etsy menggunakan sistem OAuth scope untuk menentukan data atau tindakan yang dapat diakses aplikasi. Belajar Ekspor dapat meminta scope baca yang relevan dengan fitur seller, misalnya akses untuk membaca data toko, listing, dan transaksi. Scope aktual yang diminta akan ditampilkan pada proses otorisasi Etsy.
Jika di masa depan Belajar Ekspor menyediakan fitur yang dapat membuat atau mengubah data di Etsy, permission tulis yang sesuai hanya akan digunakan setelah fitur tersebut tersedia dan pengguna memberikan persetujuan melalui OAuth.
6. Keamanan Token dan Kredensial
Token OAuth diperlakukan sebagai informasi sensitif. Belajar Ekspor menerapkan pembatasan akses pada sistem backend dan tidak menampilkan token OAuth, shared secret aplikasi, atau kredensial sensitif lain kepada publik.
Shared secret Etsy tidak disimpan sebagai kredensial terbuka di aplikasi Android. Komunikasi OAuth dan callback menggunakan koneksi HTTPS sesuai konfigurasi integrasi yang terdaftar.
Walaupun kami menerapkan langkah keamanan yang wajar, tidak ada sistem digital yang dapat dijamin bebas risiko sepenuhnya. Pengguna tetap wajib menjaga keamanan akun Etsy, akun Belajar Ekspor, perangkat, dan email miliknya.
7. Sinkronisasi, Penyimpanan, dan Cache Data
Belajar Ekspor dapat menyimpan atau melakukan cache terhadap sebagian data Etsy yang diperlukan untuk menjalankan fitur, mempercepat tampilan, menyusun histori pembukuan, dan mengurangi permintaan API yang tidak perlu. Pengelolaan data dilakukan sesuai kebutuhan layanan, Kebijakan Privasi Belajar Ekspor, serta ketentuan Etsy API yang berlaku.
Data yang berasal dari Etsy dapat mengalami jeda sinkronisasi, perubahan, atau perbedaan waktu pembaruan. Untuk keputusan keuangan atau operasional yang penting, pengguna disarankan membandingkan data dengan sumber resmi Etsy.
8. Memutus Koneksi Etsy
Pengguna dapat memutus koneksi toko Etsy dari pengaturan integrasi yang tersedia di Belajar Ekspor. Setelah koneksi diputus:
- Sinkronisasi baru dari Etsy akan dihentikan
- Token OAuth akan dihapus atau dinonaktifkan dari sistem Belajar Ekspor sesuai proses teknis yang berlaku
- Fitur yang membutuhkan koneksi Etsy dapat berhenti berfungsi
- Data historis yang sebelumnya telah tersimpan dapat tetap tersedia untuk histori pembukuan sampai dihapus oleh pengguna atau sesuai kebijakan retensi
Untuk permintaan penghapusan akun atau data, pengguna dapat mengikuti prosedur pada halaman Penghapusan Data/Akun.
9. Keterbatasan Integrasi
Ketersediaan integrasi bergantung pada Etsy Open API, permission pengguna, rate limit, koneksi internet, perubahan endpoint, perubahan kebijakan, gangguan layanan, atau faktor teknis lain di luar kendali Belajar Ekspor.
Belajar Ekspor tidak menjamin bahwa seluruh data Etsy selalu tersedia secara real-time atau bahwa integrasi akan berjalan tanpa gangguan. Jika Etsy mengubah atau menghentikan bagian tertentu dari API, Belajar Ekspor dapat menyesuaikan, membatasi, atau menghentikan fitur terkait.
10. Kontrol dan Hak Pengguna
Pengguna tetap memiliki kontrol terhadap koneksi toko Etsy miliknya dan dapat:
- Meninjau izin pada saat proses OAuth
- Memutus koneksi Etsy dari Belajar Ekspor
- Meminta penghapusan data sesuai prosedur yang tersedia
- Menghubungi Belajar Ekspor apabila memiliki pertanyaan tentang integrasi atau penggunaan data
11. Dokumen Terkait
Halaman ini merupakan bagian dari kebijakan Belajar Ekspor dan perlu dibaca bersama dengan:
12. Kontak
Jika memiliki pertanyaan mengenai Integrasi Etsy API, privasi, penghapusan data, atau keamanan koneksi, pengguna dapat menghubungi tim Belajar Ekspor melalui kanal kontak resmi yang tercantum pada halaman Kontak.
Etsy dan merek terkait tetap merupakan milik pemiliknya masing-masing. Penggunaan Etsy Open API oleh Belajar Ekspor tidak berarti adanya endorsement, sertifikasi, sponsorship, atau afiliasi resmi dari Etsy, Inc.