Pengantar

Hai, Selamat Datang! Reseller Topupgim.

API Reseller dikembangkan berdasarkan konsep REST API yang menggunakan kode respons HTTP untuk mendeteksi jika terjadi kesalahan. Kami menggunakan fitur dan fungsi bawaan HTTP sehingga dapat dimengerti oleh klien HTTP umum. Respons API kami memiliki format JSON, termasuk juga pesan kesalahannya.

Untuk menggunakan API Reseller ini sebelumnya kamu harus sudah memiliki akun Topupgim yang sudah diupgrade ke Agen.

Berikut langkah-langkahnya:

Sudah mendaftarkan akun Topupgim. Jika belum, silahkan mendaftar di Pendaftaran Akun.

Masuk ke halaman Pendaftaran Agen kemudian lengkapi data yang diminta.

Setelah disetujui, buat PIN transaksi pada halaman Akun Saya > Kata Sandi / PIN.

Mengisi saldo voucher yang akan digunakan untuk pembelian produk.

Mengajukan permintaan aktivasi akses API Reseller ke kontak Admin Topupgim.

Setelah diaktivasi, kamu akan mendapatkan Client ID dan Secret Key yang dapat kamu temukan di pengaturan api.

Siapkan url notifikasi dan alamat ip server yang kamu gunakan untuk mengakses api kemudian simpan di pengaturan api.

Base URL

Mode	Base URL
`Production`	https://api.topupgim.com

Otentikasi

Setiap requests wajib menggunakan ip yang sudah di-whitelist sebelumnya dan menggunakan otentikasi data headers berikut:

Header	Deskripsi
`x-client-id`	Client ID tetap yang didapatkan di halaman pengaturan api.
`x-secret-key`	Secret Key dapat diubah melalui halaman pengaturan api.

Notifikasi (Webhook)

Umumnya notifikasi pesanan akan dikirim melalui requests POST ke url notifikasi yang sudah kamu setel sebelumnya pada halaman pengaturan api.

Untuk menjaga keaslian webhook dari Topupgim, kamu dapat memvalidasinya melalui:
headers x-signature dengan format md5("clientID:secretKey:referenceID").

Respon API

Setiap respons API berupa format JSON yang memiliki struktur sebagai berikut:

HTTP Status	Response Message	Deskripsi
`200`	OK	Permintaan berhasil dan memenuhi spesifikasi yang diminta.
`403`	IP_RESTRICTED	Akses ditolak, ip address harus di-whitelist terlebih dahulu.
`401`	UNAUTHORIZED	Otentikasi gagal, pastikan client id dan secret key sudah benar.
`400`	BAD_REQUEST	Terdapat tipe bidang requests yang tidak memenuhi spesifikasi.
`422`	REQUEST_NOT_PROCESSABLE	Terdapat tipe bidang requests yang tidak memenuhi spesifikasi.
`404`	NOT_FOUND	Halaman atau data yang dicari tidak ditemukan.
`404`	SKU_NOT_AVAILABLE	Kode sku tidak ditemukan atau sedang tidak aktif saat membuat pesanan.
`500`	INSUFFICIENT_BALANCE	Saldo tidak mencukupi terhadap harga produk saat membuat pesanan.
`500`	INVALID_PRICE	Harga produk melebihi `max_price` yang disetel saat membuat pesanan.
`500`	INTERNAL_ERROR	Terjadi keslalahan pada sisi server kami.

Base URL#

Otentikasi#

Notifikasi (Webhook)#

Respon API#

Base URL

Otentikasi

Notifikasi (Webhook)

Respon API