Dokumentasi API

REST API GoTopUp memungkinkan Anda mengecek saldo, mengambil daftar produk, membuat transaksi, dan memantau status secara otomatis. Semua endpoint menggunakan autentikasi Bearer token. Dapatkan API Key Anda di API Settings.

Base URL: https://api.gotopup.biz.id/v1

POST/api/auth/login

Autentikasi

Gunakan API Key Anda (dari menu API Settings) sebagai Bearer token pada header setiap request.

curl https://api.gotopup.biz.id/v1/products \
  -H "Authorization: Bearer gtp_live_xxxxxxxx"

GET/api/wallet/balance

Cek Saldo

Mengembalikan saldo wallet Anda saat ini.

curl https://api.gotopup.biz.id/v1/wallet/balance \
  -H "Authorization: Bearer gtp_live_xxxxxxxx"

GET/api/products

Daftar Produk & Harga

Mengambil daftar produk beserta harga terbaik yang tersedia.

curl https://api.gotopup.biz.id/v1/products?category=pulsa \
  -H "Authorization: Bearer gtp_live_xxxxxxxx"

POST/api/transactions

Buat Transaksi

Membuat order pembelian. Saldo dipotong, transaksi diproses ke provider, dan status diperbarui via callback.

curl -X POST https://api.gotopup.biz.id/v1/transactions \
  -H "Authorization: Bearer gtp_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "product_code": "TSEL10",
    "destination": "081234567890",
    "ref_id": "INV-0001"
  }'

GET/api/transactions/{id}

Cek Status Transaksi

Memeriksa status transaksi. Nilai status: PENDING, PROCESSING, SUCCESS, FAILED, REFUNDED.

curl https://api.gotopup.biz.id/v1/transactions/TRX123ABC \
  -H "Authorization: Bearer gtp_live_xxxxxxxx"

POSTyour-server.com/callback

Callback / Webhook

Saat status transaksi final, GoTopUp mengirim POST ke URL callback Anda dengan detail transaksi & serial number.

{
  "code": "TRX123ABC",
  "ref_id": "INV-0001",
  "status": "SUCCESS",
  "serial_number": "SN-9284756102",
  "price": 10900,
  "message": "Transaksi berhasil"
}