Dokumentasi API

Dompet

Endpoint, contoh request, dan format response.

Semua endpoint

Cek saldo

GET https://instan.app/api/balance
curl --request GET \
--url 'https://instan.app/api/balance' \
--header 'Authorization: Bearer {api_key}' \ 
{
    "data": {
        "available": 150000,
        "available_formatted": "Rp 150.000",
        "pending_settlement": 0,
        "pending_settlement_formatted": "Rp 0",
        "total_in": 200000,
        "total_out": 50000,
        "currency": "IDR"
    }
}

Mutasi

GET https://instan.app/api/mutations
curl --request GET \
--url 'https://instan.app/api/mutations' \
--header 'Authorization: Bearer {api_key}' \
Parameter Rincian Deskripsi
direction Opsional String Nilai-nilai yang diperbolehkan: credit, debit
type Opsional String Filter berdasarkan tipe ledger, misalnya topup, iak_cashback, withdrawal.
datetime_start Opsional String Saring hasil mulai dari datetime ini. Format Y-m-d H:i:s.
datetime_end Opsional String Filter hasil hingga datetime ini. Format Y-m-d H:i:s.
page Opsional Integer Nomor halaman yang Anda inginkan hasilnya dari. Defaultnya adalah 1.
results_per_page Opsional Integer Berapa hasil yang Anda inginkan per halaman. Nilai yang diperbolehkan adalah: 10, 25, 50, 100, 250, 500, 1000. Secara default adalah 25. 
{
    "data": [
        {
            "id": 12,
            "datetime": "2026-08-22 06:02:34",
            "type": "iak_cashback",
            "direction": "credit",
            "amount": 50,
            "amount_formatted": "Rp 50",
            "label": "Cashback IAK",
            "source": "store",
            "wallet": "store",
            "reference_type": "biller_order",
            "reference_id": 101,
            "description": "Cashback IAK"
        }
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    }
}

Opsi penarikan

GET https://instan.app/api/withdrawals/options
curl --request GET \
--url 'https://instan.app/api/withdrawals/options' \
--header 'Authorization: Bearer {api_key}' \ 
{
    "data": {
        "available_balance": 250000,
        "minimum_amount": 100000,
        "transfer_fee": 6500,
        "currency": "IDR",
        "payout_provider": "iak",
        "can_request": true,
        "ewallet_brands": ["GOPAY", "DANA"]
    }
}

Daftar penarikan

GET https://instan.app/api/withdrawals
curl --request GET \
--url 'https://instan.app/api/withdrawals' \
--header 'Authorization: Bearer {api_key}' \
Parameter Rincian Deskripsi
status Opsional String Filter status. Nilai yang diperbolehkan: pending, processing, approved, rejected.
page Opsional Integer Nomor halaman yang Anda inginkan hasilnya dari. Defaultnya adalah 1.
results_per_page Opsional Integer Berapa hasil yang Anda inginkan per halaman. Nilai yang diperbolehkan adalah: 10, 25, 50, 100, 250, 500, 1000. Secara default adalah 25.

Detail penarikan

GET https://instan.app/api/withdrawals/{withdrawal_id}
curl --request GET \
--url 'https://instan.app/api/withdrawals/{withdrawal_id}' \
--header 'Authorization: Bearer {api_key}' \

Buat penarikan

POST https://instan.app/api/withdrawals
curl --request POST \
--url 'https://instan.app/api/withdrawals' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"amount":150000,"ewallet_brand":"DANA","account_number":"081234567890"}'
Parameter Rincian Deskripsi
amount Diperlukan Integer Nominal gross (sebelum biaya transfer) dalam rupiah.
ewallet_brand Opsional String Kode brand e-wallet, misalnya GOPAY atau DANA. Wajib jika saluran payout adalah e-wallet.
account_number Opsional String Nomor HP e-wallet tujuan. Wajib untuk penarikan IAK.
account_name Opsional String Nama pemilik rekening atau e-wallet.
bank_code Opsional String Kode bank penerima. Wajib untuk penarikan DANA bank transfer. 
{
    "data": {
        "id": 21,
        "amount": 143500,
        "transfer_fee": 6500,
        "gross_amount": 150000,
        "currency": "IDR",
        "payout_provider": "iak",
        "status": "processing",
        "datetime": "2026-08-22 06:02:34"
    },
    "meta": {
        "message": "Permintaan penarikan berhasil dikirim.",
        "pending": true
    }
}