04 - Central Billing

Dokumen ini menjelaskan endpoint, flow, class, dan ownership billing pada central context.

Scope

Route files:

routes/central/billing-public.php

routes/central/billing.php

Controllers:

app/Http/Controllers/Api/V1/Central/Billing/*

Services:

app/Services/Central/Billing/*

app/Services/Shared/Billing/*

Billing Domain Topology

Endpoint Matrix

A. Public Billing

Method	Path	Controller	Middleware	Tujuan
GET	`/api/v1/central/billing/plans`	`PlanCatalogController`	-	Katalog plan untuk pricing publik
POST	`/api/v1/central/billing/webhooks/{provider}`	`BillingWebhookController`	`throttle:auth-refresh`	Ingest webhook provider

B. Platform Billing Admin

Semua endpoint memakai:

auth:sanctum

ability:platform:access

Method	Path	Controller	Tujuan
GET	`/api/v1/central/platform/billing/audits`	`AuditController@index`	List audit billing
GET	`/api/v1/central/platform/billing/audits/{id}`	`AuditController@show`	Detail audit
GET	`/api/v1/central/platform/billing/plans`	`PlanController@index`	List plan
PUT	`/api/v1/central/platform/billing/plans/{planCode}`	`PlanController@upsert`	Create/update plan
PUT	`/api/v1/central/platform/billing/plans/{planCode}/features/{featureKey}`	`PlanController@upsertFeatureValue`	Set value fitur plan
GET	`/api/v1/central/platform/billing/features`	`FeatureController@index`	List fitur billing
PUT	`/api/v1/central/platform/billing/features/{featureKey}`	`FeatureController@upsert`	Create/update fitur

Webhook Processing Flow

Class Responsibility Map

PlanCatalogController: public plan list output.

BillingWebhookController: ingress endpoint webhook.

PaymentWebhookService: orchestration validasi, idempotensi, mutasi state.

BillingWebhookForensicService: persistence forensik webhook.

DunningNotificationService: notifikasi dunning flow.

BillingWebhookProviderRegistry: registry adapter provider.

Provider adapters:

ManualWebhookProvider

MidtransWebhookProvider

XenditWebhookProvider

Data Ownership (Central)

Plan + plan features = central source of truth.

Subscription + invoice lifecycle = central.

Tenant feature usage + overrides = central.

Webhook events + receipts = central.

Tenant runtime hanya konsumsi entitlements dan status dari kebijakan central.

04 - Central Billing

Scope#

Billing Domain Topology#

Endpoint Matrix#

A. Public Billing#

B. Platform Billing Admin#

Webhook Processing Flow#

Class Responsibility Map#

Data Ownership (Central)#