Dokumentasi API & Integrasi Sistem

Pembaruan Terakhir: 4 September 2026

Versi API: v1.0 (RESTful)

Selamat datang di Dokumentasi API PAGRI Fundify. Halaman ini menyediakan panduan teknis bagi mitra pengembang dan lembaga klien untuk mengintegrasikan sistem pelaporan kampanye, manajemen materi promosi digital, transmisi peristiwa konversi, serta validasi lisensi perangkat lunak sentral yang disediakan oleh PT Padamu Negeri Sumut Indonesia (“PAGRI”).

1. Ringkasan Arsitektur & Lingkungan Server

API PAGRI Fundify dirancang berbasis arsitektur REST menggunakan format pertukaran data standar JSON. Seluruh komunikasi data wajib dilakukan melalui saluran terenkripsi HTTPS (TLS 1.2 / TLS 1.3).

Base URL Produksi: https://padamunegeri.biz.id/wp-json/fundify/v1/
Format Pertukaran Data: application/json
Metode Otentikasi: Bearer Token / License Key Header

2. Protokol Otentikasi & Keamanan Kunci API

Setiap permintaan ke antarmuka terlindungi wajib menyertakan kunci lisensi aktif dan token domain yang diterbitkan oleh server pusat pada bagian header permintaan HTTP:

Authorization: Bearer YOUR_SECRET_API_TOKEN
X-License-Key: FUNDIFY-XXXX-XXXX-XXXX
X-Origin-Domain: domainmitra.org

Permintaan yang dikirimkan tanpa header otentikasi sah atau berasal dari domain yang tidak terdaftar akan ditolak dengan kode status HTTP 401 Unauthorized atau 403 Forbidden.

3. Endpoint: Validasi Status Lisensi Domain

Digunakan oleh modul plugin di situs klien untuk memverifikasi keaktifan langganan B2B secara real-time.

Metode HTTP: POST
Endpoint URL: /license/check

Contoh Payload Permintaan (Request Body):

{
  "license_key": "FUNDIFY-B2B-2026-9812",
  "domain": "yayasanpeduli.org"
}

Contoh Respon Berhasil (200 OK):

{
  "status": "active",
  "license_holder": "Yayasan Peduli Anak Bangsa",
  "expires_at": "2027-09-04",
  "features": {
    "meta_marketing_sync": true,
    "multi_campaign_tracking": true,
    "capi_event_pipeline": true
  }
}

4. Endpoint: Sinkronisasi Metrik Kinerja Pemasaran Meta

Mengambil ringkasan metrik kinerja kampanye pemasaran dari Meta Graph API v18.0+ yang telah diagregasikan oleh server pusat untuk disajikan pada dasbor lokal klien secara transparan.

Metode HTTP: GET
Endpoint URL: /analytics/campaign-summary?campaign_id={META_CAMPAIGN_ID}

Contoh Respon Data Agregat (200 OK):

{
  "success": true,
  "data": {
    "campaign_id": "12020584912003",
    "campaign_name": "Program Peduli Kemanusiaan 2026",
    "impressions": 142500,
    "reach": 98400,
    "clicks": 3520,
    "ad_spend": 2500000,
    "currency": "IDR",
    "conversions": {
      "donate": 184,
      "initiate_checkout": 312
    },
    "cost_per_result": 13586.95,
    "last_synced": "2026-09-04T10:30:00Z"
  }
}

5. Endpoint: Eksekusi Status Kampanye Terotorisasi (User-Triggered)

Memfasilitasi perubahan status operasional materi kampanye (seperti mengaktifkan atau menjeda kampanye) ke jaringan Meta berdasarkan instruksi langsung administrator Klien dari antarmuka dasbor.

Metode HTTP: POST
Endpoint URL: /marketing/campaign/update-status

Contoh Payload Permintaan:

{
  "meta_campaign_id": "12020584912003",
  "action": "PAUSED",
  "level": "campaign"
}

Contoh Respon Berhasil (200 OK):

{
  "success": true,
  "message": "Status kampanye berhasil disinkronkan ke server Meta.",
  "meta_status": "PAUSED",
  "timestamp": "2026-09-04T10:35:12Z"
}

6. Batasan Akses & Kode Status Kesalahan Standar (Rate Limiting)

Untuk menjaga stabilitas peladen dari lonjakan beban trafik data, pemanggilan API dibatasi maksimal 120 permintaan per menit per lisensi aktif. Kode status standar yang digunakan:

Kode HTTP	Status	Keterangan
200	OK	Permintaan berhasil diproses.
400	Bad Request	Parameter permintaan tidak valid atau format JSON salah.
401 / 403	Unauthorized / Forbidden	Kunci lisensi salah, kedaluwarsa, atau domain tidak terdaftar.
429	Too Many Requests	Melebihi ambang batas pemanggilan (Rate Limit).
500	Internal Server Error	Terjadi kendala teknis pada infrastruktur peladen pusat.

7. Dukungan Rekayasa & Konsultasi Integrasi

Untuk permintaan akses sandbox pengujian atau pelaporan kendala webhook, silakan hubungi tim rekayasa perangkat lunak kami:

Tim Integrasi & API Gateway PAGRI Fundify
PT Padamu Negeri Sumut Indonesia
Jl. Bunga Lau No. 28, Kel. Kemenangan Tani, Kec. Medan Tuntungan, Kota Medan, Sumatera Utara 20136
Surel Resmi: fundify@padamunegeri.biz.id
Saluran Teknis B2B: +62 8116202204