Integrasi Sistem & API Pihak Ketiga: Unit Ekowisata (UNT-WISATA)

1. Integrasi Perangkat Keras Gerbang (Hardware Turnstile & Printer)#

Sistem loket dan gerbang masuk beroperasi secara otomatis dengan mengintegrasikan perangkat keras khusus:

[ POS KASIR BUMDES ] ---> [ PRINTER THERMAL GELANG TYVEK (Zebra ZD410) ]
 |
 v Network LAN
[ CONTROLLER RELAY ESP32 ] ---> [ SOLENOID TRIPOD TURNSTILE GATE ]
 ^
 | Serial Wiegand/RS485
[ SCANNER OPTIK QR BARCODE ]

Protokol Pembukaan Palang Turnstile (Relay Control via REST/MQTT)

typescript
// services/hardware/turnstile-gate.ts
import axios from 'axios';

export async function openTurnstileGate(gateIpAddress: string, ticketQrCode: string): Promise<boolean> {
 try {
 const response = await axios.post(`http://${gateIpAddress}/api/relay/trigger`, {
 action: 'PULSE_OPEN',
 duration_ms: 300,
 auth_token: process.env.GATE_CONTROLLER_SECRET,
 ref: ticketQrCode
 }, { timeout: 800 });

 return response.status === 200 && response.data.status === 'SUCCESS';
 } catch (error) {
 console.error('Gagal memicu trigger relay gerbang turnstile:', error);
 return false;
 }
}

2. Integrasi Host-to-Host API Asuransi Pengunjung#

Setiap tiket masuk yang terjual secara otomatis dilaporkan ke sistem API asuransi rekanan (PT Asuransi Jasaraharja Putera) untuk mengaktifkan polis asuransi jiwa seketika.

Endpoint Pelaporan Manifest Pengunjung Harian

• Metode: POST
• URL: https://api.jasaraharjaputera.co.id/v1/bumdes/manifest-sync
• Headers:
• Authorization: Bearer <API_KEY_ASURANSI>
• Content-Type: application/json

json
{
 "policy_number": "POL-BUMDES-2026-09",
 "sync_date": "2026-09-14",
 "total_visitors": 450,
 "premium_per_person": 1000,
 "total_premium": 450000,
 "order_reference_ids": [
 "ORD-WIS/20260914/0001",
 "ORD-WIS/20260914/0002"
 ]
}

3. Integrasi Online Travel Agent (OTA - Traveloka & Tiket.com)#

Untuk menjangkau wisatawan luar daerah, BUMDes menyediakan antarmuka webhook terbuka yang menerima pesanan tiket dari platform travel daring:

[ APLIKASI TRAVELOKA/TIKET.COM ] ---> [ WEBHOOK RESMI BUMDES ] ---> [ AUTO-ISSUE QR CODE GELANG ]

Wisatawan yang memesan melalui OTA akan menerima voucher ber-QR Code di aplikasi ponsel mereka, yang dapat langsung dipindai di turnstile gerbang masuk BUMDes tanpa perlu menukarkan tiket fisik di loket antrean.