Campaigns & Escrow API

Sistem kampanye Crevir dirancang untuk menahan likuiditas pendanaan klien dengan aman (melalui model Escrow) hingga hasil akhir (deliverable) diverifikasi oleh sistem.

Dengan Endpoint Kampanye, sistem klien (ERP atau Project Management Tools internal) dapat secara otomatis memublikasikan Campaign Brief baru dan memantau status penyelesaian kontrak secara proaktif.

Membuat Campaign Brief

POST /api/core/campaigns/:campaignId/brief

Mengirim draf atau taklimat (brief) kampanye secara terprogram. Anda bisa menargetkan kreator secara spesifik (Bounty Tertutup) atau membuka untuk lelang publik.

Body Parameters (JSON)

Parameter	Tipe	Wajib?	Deskripsi
`title`	`string`	Ya	Judul kampanye internal.
`budget`	`number`	Ya	Anggaran kotor yang dialokasikan dalam Rupiah (IDR).
`deliverables`	`array`	Ya	Array yang berisi objek deliverable (misal: "1x YouTube Dedicated", "1x Instagram Reels").
`target_creator_ids`	`array`	Tidak	ID kreator spesifik (misal: `["cre_8a9B..."]`). Jika kosong, kampanye akan berstatus publik.

Contoh Request

curl -X POST "https://api.crevir.com/api/core/campaigns/cmp_8z7XbQwe/brief" \
  -H "Authorization: Bearer cvt_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Peluncuran Flagship Smartphone X20",
    "budget": 150000000,
    "deliverables": [
      {
        "type": "youtube_dedicated",
        "description": "Video review 10 menit berfokus pada kapabilitas kamera low-light."
      }
    ]
  }'

Contoh Response

{
  "data": {
    "campaign_id": "cmp_8z7XbQwe",
    "status": "draft",
    "budget_locked": false,
    "created_at": "2026-07-21T10:00:00Z"
  }
}

[!CAUTION] Pembuatan brief kampanye via API hanya akan menghasilkan status draft. Kampanye tidak akan dipublikasikan ke Kreator sebelum sistem Anda mengonfirmasi penahanan Escrow atau melakukan pembayaran tagihan (Invoice) awal.

Cek Status Kampanye

GET /api/core/campaigns/:campaignId

Melakukan penarikan (polling) status kampanye tunggal, termasuk pergerakan dana escrow.

Contoh Request

curl -X GET "https://api.crevir.com/api/core/campaigns/cmp_8z7XbQwe" \
  -H "Authorization: Bearer cvt_live_xxxxx"

Contoh Response

{
  "data": {
    "campaign_id": "cmp_8z7XbQwe",
    "status": "active",
    "escrow": {
      "status": "locked",
      "amount": 150000000
    },
    "participants_count": 5
  }
}