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.
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.
// 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 }/v1/organizations/v1/organizations/{id}/v1/properties/v1/properties/v1/properties/{id}/v1/bookings/v1/bookings/v1/bookings/{id}/v1/tax-summary/v1/webhooks/endpoints/v1/webhooks/endpoints/v1/webhooks/endpoints/{id}SDK untuk Node.js dan Python, Tersedia Q3 2026
Konfigurasi webhook dari Dashboard > Integrasi > Webhook
booking.createdNew booking received
booking.updatedBooking modified
tax.calculatedTax calculation completed
report.generatedFiscal report generated
HMAC-SHA256
Semua payload webhook ditandatangani dengan HMAC-SHA256. Verifikasi header X-VillaTax-Signature menggunakan secret endpoint Anda.
Integrasi Channel Manager
Dorong pemesanan dari PMS atau channel manager Anda. Perhitungan pajak berjalan otomatis. Bangun lapisan pelaporan Anda sendiri di atasnya.
Perangkat Lunak Manajemen Properti
Sematkan kepatuhan fiskal langsung ke produk manajemen properti Anda. Klien Anda mendapatkan kepatuhan pajak Indonesia tanpa meninggalkan aplikasi Anda.
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.