Etsy API Integration

1. Aplikasi Independen

Belajar Ekspor Indonesia adalah aplikasi independen untuk edukasi, alat bantu kerja, dan pembukuan bisnis seller. Belajar Ekspor bukan perwakilan resmi, partner resmi, maupun afiliasi dari Etsy, Inc. Aplikasi ini memanfaatkan Etsy Open API v3 untuk membantu seller mengelola dan membukukan transaksi dari tokonya sendiri yang telah diotorisasi secara sah.

2. Tujuan Integrasi (Application Purpose)

Integrasi Etsy ditujukan khusus untuk alur kerja operasional dan pembukuan internal seller:

• Pencatatan omzet, pesanan, dan histori transaksi toko milik seller.
• Perhitungan Harga Pokok Penjualan (HPP), biaya kemasan, biaya operasional, dan profitabilitas.
• Pencatatan estimasi dan rincian fee marketplace, payment adjustments, serta rekonsiliasi payout.
• Penyusunan laporan keuangan periodik (PDF, XLSX, CSV) dan pembuatan slip pengemasan (packing slip) internal.

Integrasi ini BUKAN dan TIDAK DIGUNAKAN untuk:

• Marketplace-wide scraping atau ekstraksi data marketplace massal.
• Riset/profiling kompetitor tanpa izin (competitor intelligence).
• Pelatihan model kecerdasan buatan (AI) eksternal menggunakan konten Etsy API.
• Fitur otomatisasi yang melanggar ketentuan resmi Etsy.

3. Otorisasi OAuth & Prinsip Hak Akses Minimum (Least Privilege)

Akses ke data toko Etsy dilakukan melalui protokol otorisasi resmi OAuth 2.0 dengan PKCE. Pengguna memberikan izin secara sadar di halaman persetujuan resmi Etsy. Scope yang diminta dibatasi secara ketat hanya untuk kebutuhan baca (read-only):

• shops_r: Membaca konteks identitas toko yang dihubungkan seller.
• listings_r: Membaca daftar produk/listing untuk dipetakan ke data HPP dan stok internal.
• transactions_r: Membaca transaksi order, receipt, dan ledger untuk pencatatan pembukuan keuangan.

Aplikasi TIDAK MEMINTA scope tulis (listings_w, transactions_w), tidak meminta scope profil/email anggota (email_r, profile_r), dan tidak meminta atau memproses alamat email pembeli (buyer_email).

4. Larangan Screen Scraping & Pengumpulan Kredensial

Belajar Ekspor tidak pernah meminta atau menyimpan kata sandi (password) akun Etsy pengguna. Seluruh proses autentikasi dilakukan langsung di server resmi Etsy. Belajar Ekspor tidak menggunakan teknik web/screen scraping, headless browser automation, atau endpoint pribadi tidak berdokumen untuk mengambil data dari platform Etsy.

5. Keamanan Token & Penyimpanan Data

Kredensial integrasi (API Shared Secret, Webhook Secret, dan Encryption Keys) dikelola sepenuhnya di sisi server backend yang aman dan tidak pernah didistribusikan ke aplikasi klien Android. Access token dan refresh token disimpan dalam database backend menggunakan enkripsi standar industri (AES-256-GCM). Data transaksi dan pembukuan dipisahkan secara ketat antar akun pengguna (tenant isolation) dan tidak dapat diakses oleh pengguna lain.

6. Penafian Garansi Resmi Etsy (Etsy Warranty Disclaimer)

7. Pemutusan Koneksi (Disconnect) & Penghapusan Data

Pengguna memiliki kendali penuh atas koneksi toko Etsy miliknya:

• Pemutusan Koneksi: Pengguna dapat memutuskan integrasi kapan saja melalui menu pengaturan toko di aplikasi. Setelah diputus, sinkronisasi otomatis akan berhenti.
• Penghapusan Data Toko: Pengguna dapat menghapus data toko yang terhubung dari aplikasi Belajar Ekspor. Proses ini menghapus token OAuth dan cache data toko di server Belajar Ekspor.
• Toko Etsy Asli: Menghapus data toko di Belajar Ekspor sama sekali tidak menghapus atau mengubah toko fisik Anda di platform Etsy. Toko Etsy Anda tetap utuh di Etsy.

8. Kontak & Dukungan Resmi

Untuk pertanyaan, kendala integrasi, atau permohonan terkait data privasi, silakan hubungi saluran resmi kami: