Payment Channels

Dapatkan daftar payment channels yang tersedia untuk top up saldo.

GET /v1/balance/channels

Response Fields

data berupa array channel pembayaran untuk isi saldo, diurutkan dengan yang aktif di depan. Channel yang sedang tidak bisa dipakai tetap dikirim dengan status: "off" supaya Anda dapat menampilkannya sebagai "sementara tidak tersedia" — bukan menghilang begitu saja dari tampilan pembeli Anda. Daftar ini bisa berubah kapan saja: ambil ulang secara berkala dan jangan menyimpan kodenya secara permanen di kode program.

service string

Kode channel yang dipakai sebagai code di POST /v1/balance (mis. QRIS_CUSTOM).

name string

Nama channel yang ditampilkan.

type string

Jenis channel (mis. qris, va, ewallet).

minimum / maximum integer

Batas nominal top up untuk channel ini (Rupiah).

fee_flat integer

Biaya admin tetap (Rupiah).

fee_percentage number

Biaya admin persentase (%).

status string

on = bisa dipakai sekarang. off = channel ada, tetapi sedang tidak bisa dipakai; memakainya akan dijawab CODE_NOT_FOUND_OR_INACTIVE. Tampilkan yang off dalam keadaan nonaktif, jangan disembunyikan — dengan begitu pembeli Anda tahu channel itu memang ada dan bisa kembali tersedia.

sort_order integer

Urutan tampilan yang kami sarankan. Array sudah dikirim dalam urutan itu (aktif lebih dulu), jadi menampilkannya apa adanya sudah benar.

updated_at string

Kapan channel terakhir diubah (ISO 8601). Berguna untuk mengetahui apakah suatu channel baru saja berubah status.

fees / fees_type deprecated

Jangan dipakai menghitung biaya. Dua field lama yang dipertahankan demi kompatibilitas integrasi terdahulu. Biaya yang berlaku ada di fee_flat dan fee_percentage.

Jangan menghitung total bayar sendiri. fee_flat dan fee_percentage berguna untuk menampilkan perkiraan biaya, tetapi nominal final baru ditetapkan saat tagihan terbit. Yang harus dibayar adalah amount pada respons POST /v1/balance.

Example Request

curl --request GET \
              --url https://sekalipay.com/api/v1/balance/channels \
              --header 'X-APIKEY: YOUR_API_KEY'

Response Sample

200 OK

{
              "message": "OK",
              "data": [
                {
                  "name": "QRIS",
                  "service": "QRIS_CUSTOM",
                  "type": "QRIS",
                  "status": "on",
                  "minimum": 1000,
                  "maximum": 10000000,
                  "fee_flat": 0,
                  "fee_percentage": "0.70",
                  "sort_order": 1,
                  "updated_at": "2026-09-05T04:04:04.000000Z",
                  // deprecated
                  "fees": "0",
                  "fees_type": "percent"
                },
                {
                  "name": "BRI VA",
                  "service": "BRIVA",
                  "type": "VA",
                  // sedang tidak bisa dipakai — tampilkan nonaktif
                  "status": "off",
                  "minimum": 10000,
                  "maximum": 10000000,
                  "fee_flat": 3000,
                  "fee_percentage": "0.00",
                  "sort_order": 2,
                  "updated_at": "2026-09-04T13:02:01.000000Z",
                  "fees": "0",
                  "fees_type": "percent"
                }
              ]
            }