Bearer Auth
Clés API dans Paramètres → API. vt_live_* pour la production, vt_test_* pour le sandbox.
Limites de taux
100 requêtes/minute par clé API. Headers : X-RateLimit-Limit, X-RateLimit-Remaining.
Webhooks signés
Signature HMAC-SHA256 sur chaque payload. Retry automatique avec backoff exponentiel en cas d'échec.
OpenAPI 3.0
Spécification complète à /openapi.yaml. Utilisez openapi-generator pour créer des SDK dans n'importe quel langage.
Toutes les requêtes API nécessitent un Bearer token API key. Obtenez votre clé depuis le tableau de bord → Paramètres → 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)
Limité à 100 requêtes/minute par clé API. Headers : 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 Node.js et Python, Disponibles au T3 2026
Configurez vos webhooks depuis le tableau de bord → Intégrations → Webhooks
booking.createdNew booking received
booking.updatedBooking modified
tax.calculatedTax calculation completed
report.generatedFiscal report generated
HMAC-SHA256
Tous les payloads webhook sont signés avec HMAC-SHA256. Vérifiez le header X-VillaTax-Signature avec le secret de votre endpoint.
Intégration Channel Manager
Poussez les réservations depuis votre PMS ou channel manager. Les calculs fiscaux se déclenchent automatiquement. Construisez votre propre couche de reporting par-dessus.
Logiciel de gestion immobilière
Intégrez la conformité fiscale directement dans votre logiciel de gestion immobilière. Vos clients bénéficient de la conformité fiscale indonésienne sans quitter votre app.
Reporting fiscal automatisé
Récupérez les résumés fiscaux via API pour générer automatiquement des rapports mensuels PBJT, PPh et PPN. Exportez vers votre système comptable avec du JSON propre.