Dokumentasi API Valasin

Ringkasan

Valasin menyediakan REST API berbasis HTTPS untuk membaca kurs live (misalnya untuk papan kurs digital di gerai atau website Anda) dan menarik laporan transaksi. API tersedia untuk paket Pro (baca kurs & laporan) dan Enterprise (akses penuh serta endpoint khusus sesuai kebutuhan integrasi).

Semua request menggunakan JSON dengan autentikasi API key yang dapat dibuat dan dirotasi dari dashboard pemilik. Rate limit default 60 request/menit — dapat ditingkatkan untuk paket Enterprise.

Autentikasi

Kirim API key Anda pada setiap request lewat header berikut. Jangan pernah menaruh API key di kode sisi klien — simpan di server backend Anda.

Authorization: Bearer vs_live_XXXXXXXXXXXXXXXX
Content-Type: application/json

Mendapatkan Kurs Live

Endpoint ini mengembalikan kurs jual-beli seluruh mata uang aktif gerai Anda, lengkap dengan indikator perubahan dibanding pembaruan sebelumnya — sumber yang sama dengan yang tampil di Smart POS dan papan kurs digital Anda.

curl "https://api.valasin.id/v1/rates" \
  -H "Authorization: Bearer vs_live_XXXX"

{
  "base": "IDR",
  "updated_at": "2026-09-25T09:30:02Z",
  "rates": [
    {
      "currency": "USD",
      "we_buy": 15875,
      "we_sell": 16025,
      "change": "+0.4%"
    },
    {
      "currency": "SGD",
      "we_buy": 11920,
      "we_sell": 12040,
      "change": "-0.2%"
    }
  ]
}

Laporan Transaksi

Tarik rekap transaksi per rentang tanggal untuk kebutuhan rekonsilasi atau pelaporan. Hasil dapat difilter per gerai, mata uang, dan kasir, dengan paginasi berbasis kursor.

curl "https://api.valasin.id/v1/transactions?from=2026-09-01&to=2026-09-30&currency=USD" \
  -H "Authorization: Bearer vs_live_XXXX"

Kode Error & Bantuan

API mengembalikan kode HTTP standar: 400 untuk payload tidak valid, 401 untuk API key salah, 403 untuk fitur di luar paket, dan 429 saat rate limit terlampaui. Respons error selalu menyertakan pesan yang bisa dibaca manusia.

Butuh akses sandbox atau endpoint khusus? Hubungi tim kami — untuk paket Enterprise kami membuka endpoint sesuai kebutuhan integrasi Anda.