VillaTaxVillaTax
Audit Gratis
Charlotte AIHarga
MasukMulai
Audit Gratis
BerandaFitur — Fitur VillaTax untuk pengelolaan pajak vila di BaliAudit GratisHarga
REST API · OpenAPI 3.0 · HMAC Webhooks

Dokumentasi API

Integrasikan kepatuhan pajak Bali ke dalam aplikasi Anda

12 Endpoint100 req/mntHMAC-SHA256OpenAPI 3.0
Dapatkan kunci API Lihat Dok Interaktif

Autentikasi Bearer

Kunci API di Pengaturan → API. vt_live_* untuk produksi, vt_test_* untuk sandbox.

Batas Permintaan

100 permintaan/menit per kunci API. Header: X-RateLimit-Limit, X-RateLimit-Remaining.

Webhook Tersertifikasi

Tanda tangan HMAC-SHA256 pada setiap payload. Retry otomatis dengan exponential backoff saat gagal.

OpenAPI 3.0

Spesifikasi lengkap di /openapi.yaml. Gunakan openapi-generator untuk membuat SDK dalam bahasa apa pun.

Autentikasi

Semua permintaan API memerlukan Bearer token API key. Dapatkan kunci Anda dari Dashboard > Pengaturan > API Keys.

Base URL: https://villa-tax.operium.store/api/v1
Auth:     Authorization: Bearer vt_live_YOUR_API_KEY
Sandbox:  Bearer vt_test_YOUR_KEY (returns testMode: true)

Dibatasi 100 permintaan/menit per kunci API. Header: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Mulai Cepat

JavaScriptnode.js
// Authenticate with Bearer token
const headers = {
  'Authorization': 'Bearer vt_live_YOUR_API_KEY',
  'Content-Type': 'application/json'
};

// List your properties
const res = await fetch(
  'https://villa-tax.operium.store/api/v1/properties?organizationId=YOUR_ORG_ID',
  { headers }
).then(r => r.json());
// { data: [...], testMode: false, meta: { total: 5, page: 1, limit: 20 } }

// Create a booking + auto tax calculation
const booking = await fetch('https://villa-tax.operium.store/api/v1/bookings', {
  method: 'POST', headers,
  body: JSON.stringify({
    propertyId: 'prop-uuid',
    guestName: 'Alice Martin',
    checkIn: '2025-06-15',
    checkOut: '2025-06-22',
    grossAmountIdr: 14000000,
    platform: 'airbnb'
  })
}).then(r => r.json());
// { data: { id: '...', taxBreakdowns: [{ type:'PBJT', rate:0.10, ... }] }, testMode: false }

Endpoint

Buka Explorer Interaktif→
GET/v1/organizationsList all organizations
GET/v1/organizations/{id}Get an organization
GET/v1/propertiesList properties
POST/v1/propertiesCreate a property
GET/v1/properties/{id}Get a property
GET/v1/bookingsList bookings
POST/v1/bookingsCreate a booking
GET/v1/bookings/{id}Get booking + tax breakdowns
GET/v1/tax-summaryTax summary by org & fiscal year
GET/v1/webhooks/endpointsList webhook endpoints
POST/v1/webhooks/endpointsRegister a webhook endpoint
DELETE/v1/webhooks/endpoints/{id}Delete a webhook endpoint

SDK untuk Node.js dan Python, Tersedia Q3 2026

Webhook

Konfigurasi webhook dari Dashboard > Integrasi > Webhook

booking.created

New booking received

booking.updated

Booking modified

tax.calculated

Tax calculation completed

report.generated

Fiscal report generated

HMAC-SHA256

Semua payload webhook ditandatangani dengan HMAC-SHA256. Verifikasi header X-VillaTax-Signature menggunakan secret endpoint Anda.

Dibuat untuk developer yang membutuhkan data pajak nyata

01

Integrasi Channel Manager

Dorong pemesanan dari PMS atau channel manager Anda. Perhitungan pajak berjalan otomatis. Bangun lapisan pelaporan Anda sendiri di atasnya.

02

Perangkat Lunak Manajemen Properti

Sematkan kepatuhan fiskal langsung ke produk manajemen properti Anda. Klien Anda mendapatkan kepatuhan pajak Indonesia tanpa meninggalkan aplikasi Anda.

03

Pelaporan Fiskal Otomatis

Tarik ringkasan pajak melalui API untuk menghasilkan laporan PBJT, PPh, dan PPN bulanan secara otomatis. Ekspor ke sistem akuntansi Anda dengan JSON yang bersih.

FAQ

Siap mengintegrasikan VillaTax?

Dapatkan kunci API Hubungi tim Enterprise
PT ASIAH LEGAL JAYA
Usaha Besar • Benoa Square Lt.3 Suite 4.3 • Badung, Bali
+62-813-8798-3316
VillaTaxVillaTax

Dashboard kepatuhan pajak untuk pemilik vila di Bali, Indonesia.

Powered by OPERIUM →

Produk

Arsitektur produkCharlotte AIFiturIntegrasiHargaLayananBlogAudit GratisDocs API

Fitur

PemesananMesin PajakTugasAnalitikStaf & GajiAkuntansiCoretax 2026Dokumen

Solusi

VilaPemesanan LangsungUntuk PemilikUntuk AgenUntuk InvestorUntuk DeveloperSafe HarborProgram MitraKarirFAQKontak

Hukum

Kebijakan PrivasiSyarat LayananGDPRKebijakan Pengembalian DanaTentang OPERIUM
© 2026 PT. Asiah Legal Jaya — Usaha Besar — Benoa Square Lt.3 Suite 4.3, Badung, BaliPerhitungan pajak bersifat indikatif. Konsultasikan dengan konsultan pajak resmi.