Panduan API Tokopedia

Step-by-step mendapatkan akses API untuk integrasi ERP

Informasi Umum
1

Persyaratan Awal

Sebelum mendaftar, pastikan Anda memiliki:

Catatan Penting

Jika akun seller Anda masih baru atau belum ada transaksi, kemungkinan pendaftaran akan ditolak. Pastikan toko sudah berjalan normal minimal 1-2 minggu.

2

Registrasi Developer Account

  1. Kunjungi https://developer.tokopedia.com
  2. Klik tombol "Daftar" atau "Sign Up"
  3. Pilih login dengan akun Tokopedia Anda
  4. Isi formulir pendaftaran developer:
    • Nama Lengkap
    • Email (bisa sama dengan akun seller)
    • Nama Perusahaan/Aplikasi
    • Deskripsi aplikasi yang akan dibuat
  5. Verifikasi email yang dikirim ke inbox Anda
Tips

Pada kolom deskripsi, jelaskan bahwa Anda membuat "Sistem ERP untuk manajemen stok dan pesanan multi-channel". Ini akan memudahkan approval.

3

Membuat Aplikasi

  1. Login ke dashboard developer
  2. Klik menu "My Apps" atau "Aplikasi Saya"
  3. Klik tombol "Create App"
  4. Isi detail aplikasi:
    App Name: ERP Solution Integration App Description: Sistem ERP untuk sinkronisasi stok dan pesanan Tokopedia Callback URL: https://erpsolution.biz.id/auth/tokopedia/callback
  5. Pilih scope/permission yang dibutuhkan:
    • read_product - Membaca data produk
    • update_product - Update stok produk
    • read_order - Membaca data pesanan
    • update_order - Update status pesanan
4

Mendapatkan Credentials

Setelah aplikasi dibuat, Anda akan mendapatkan:

Client ID: 1234567890 Client Secret: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
PENTING!

Client Secret hanya ditampilkan sekali. Simpan dengan aman! Jika hilang, Anda harus regenerate dan update di semua tempat yang menggunakannya.

5

OAuth Authorization

Untuk menghubungkan aplikasi dengan akun seller:

  1. Arahkan seller ke URL authorization:
    https://accounts.tokopedia.com/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_CALLBACK_URL&scope=read_product%20update_product%20read_order&response_type=code
  2. Seller login dan grant permission
  3. Tokopedia akan redirect ke callback URL dengan authorization code
  4. Tukar authorization code dengan access token:
POST https://accounts.tokopedia.com/token Content-Type: application/x-www-form-urlencoded grant_type=authorization_code& client_id=YOUR_CLIENT_ID& client_secret=YOUR_CLIENT_SECRET& code=AUTHORIZATION_CODE& redirect_uri=YOUR_CALLBACK_URL
6

Testing API

Setelah mendapatkan access token, test dengan endpoint sederhana:

// Get shop info GET https://fs.tokopedia.net/v1/shop/fs_id/12345 Authorization: Bearer YOUR_ACCESS_TOKEN // Get product list GET https://fs.tokopedia.net/inventory/v1/fs/12345/product/info?shop_id=67890 Authorization: Bearer YOUR_ACCESS_TOKEN
Dokumentasi Lengkap

Lihat dokumentasi lengkap di: https://developer.tokopedia.com/openapi/guide

Troubleshooting Umum

MasalahSolusi
Pendaftaran ditolakPastikan akun seller aktif minimal 1-2 minggu dengan transaksi
Invalid Client IDPeriksa kembali Client ID, pastikan tidak ada spasi
Access token expiredToken berlaku 14 hari, perlu refresh token
Rate limit exceededTunggu 1 jam atau ajukan penambahan limit ke Tokopedia
Scope tidak cukupEdit aplikasi dan tambahkan scope yang diperlukan

Sudah Punya API Access?

Integrasikan Tokopedia dengan ERP Solution Anda

Mulai Integrasi Sekarang