Developer Portal

BSN CMS Developer Portal

API Host-to-Host untuk integrasi sistem ERP/Treasury Anda. REST/JSON, OAuth 2.0, idempotent, dengan kontrak versioned dan sandbox bebas biaya untuk pengembangan.

Request API AccessMulai Quick Start

Quick Start

Request Pertama dalam 60 Detik

Sandbox tier gratis menyediakan mock data untuk seluruh endpoint. Setelah dapat YOUR_TOKEN dari OAuth client credentials flow, request inquiry saldo berikut bisa langsung dijalankan.

  • Header X-Idempotency-Key wajib untuk operasi mutating.
  • Response selalu berupa JSON dengan ProblemDetail (RFC 7807) di error path.
  • Versioning via URL segment (/v1/) — minimal 12 bulan deprecation notice.
bash
# Inquiry saldo akun
curl -X GET https://api.bsn.co.id/cms/v1/accounts/{accountNumber} \
     -H "Authorization: Bearer {YOUR_TOKEN}" \
     -H "X-Idempotency-Key: $(uuidgen)"

API Catalogue

Empat Domain API Utama

Endpoint dirancang sesuai use-case treasury harian — bukan CRUD generic. Setiap domain punya kontrak stabil dan changelog tersendiri.

Authentication

OAuth 2.0 Client Credentials

Server-to-server flow untuk integrasi ERP/Treasury. Token bearer JWT signed RS256, expiry default 1 jam, dengan refresh via re-issue dari client credentials yang sama.

Token URL
https://auth.bsn.co.id/realms/cms/protocol/openid-connect/token
Grant Type
client_credentials
Scopes
accounts.read payments.write approvals.manage

Rate Limits & Tiers

Pilihan Tier Sesuai Skala Integrasi

Rate limit dihitung per client_id, dengan response header X-RateLimit-Remaining dan Retry-After untuk backoff.

TierRate LimitBiayaFitur
Sandbox
100 req/menitGratisMock data, semua endpoint, tanpa SLA
StandardDirekomendasikan
1.000 req/menitTermasuk paket korporasiProduction data, SLA 99.5%, email support
Premium
10.000 req/menitCustom — konsultasi RMDedicated support engineer, SLA 99.9%, priority webhook

SDKs

Client Libraries

cURL sample tersedia untuk semua endpoint hari ini. SDK bahasa-spesifik bertahap rilis sepanjang 2026 dengan distribusi via package manager standar (PyPI, Maven Central, npm).

  • cURLLive

    Salin snippet dari quick start atau OpenAPI spec.

  • PythonComing Q3 2026

    Generated dari OpenAPI spec; subscribe newsletter untuk notifikasi rilis.

  • JavaComing Q3 2026

    Generated dari OpenAPI spec; subscribe newsletter untuk notifikasi rilis.

  • Node.jsComing Q4 2026

    Generated dari OpenAPI spec; subscribe newsletter untuk notifikasi rilis.

Resources

Tooling untuk Integration Engineer

API Access

Siap mulai integrasi?

Tim Developer Relations BSN akan menghubungi Anda dalam 2 hari kerja dengan sandbox credentials, dokumentasi lengkap, dan jadwal technical onboarding.

Request API AccessHubungi Relationship Manager