Hostwebo Billing — Database Schema

Tutte le tabelle prefisso wp_hwbi_* (o {wpdb->prefix}hwbi_*). Schema completo creato al primo activate via Installer::install_schema().

Tabelle

`wp_hwbi_plans`

Catalogo prodotti (hosting, domini, addon, pacchetti crediti AI).

Colonna	Tipo	Note
`id`	BIGINT PK
`slug`	VARCHAR(64) UNIQUE	identificatore univoco (`wp-starter`, `domain-com-yearly`)
`name`	VARCHAR(128)	nome leggibile
`description`	TEXT	testo descrittivo (può contenere markdown)
`product_type`	VARCHAR(32)	`hosting`	`domain`	`addon`	`credit_pack`
`category`	VARCHAR(32)	`cloud_eco`	`wp`	`ecommerce`	…
`billing_period`	VARCHAR(16)	`monthly`	`quarterly`	`annual`	`biennial`	`triennial`	`one_time`
`price_eur_excl_tax`	DECIMAL(10,2)	prezzo senza IVA
`price_eur_incl_tax`	DECIMAL(10,2)	prezzo con IVA (per display front-end)
`tax_rate`	DECIMAL(5,2)	IVA % (default 22.00)
`setup_fee_excl_tax`	DECIMAL(10,2)	setup fee opzionale
`trial_days`	INT	giorni trial gratuito
`stripe_product_id`	VARCHAR(64) NULL	`prod_xxx` (popolato da Fase B sync)
`stripe_price_id`	VARCHAR(64) NULL	`price_xxx`
`paypal_plan_id`	VARCHAR(64) NULL	`P-xxx`
`plesk_service_plan`	VARCHAR(128) NULL	slug Plesk service plan
`cloudlinux_package`	VARCHAR(64) NULL
`features_json`	LONGTEXT NULL	array di bullet feature
`metadata_json`	LONGTEXT NULL	metadata libero (es. `upmind_pid` per audit migrazione)
`is_active`, `is_featured`	TINYINT(1)
`sort_order`	INT	ordinamento UI

Indici: uniq_slug, idx_active_sort, idx_product_type, idx_category.

`wp_hwbi_orders`

Ogni ordine = un transaction. Può generare 1+ subscriptions o solo provisioning one-shot.

Colonna	Tipo	Note
`id`	BIGINT PK
`order_number`	VARCHAR(32) UNIQUE	formato `HWB-2026-000001`
`user_id`	BIGINT NULL
`status`	VARCHAR(32)	`pending_payment`	`paid`	`provisioning`	`active`	`suspended`	`cancelled`	`refunded`	`failed`
`payment_gateway`	VARCHAR(32) NULL	`stripe`	`paypal`	`manual`	`upmind_legacy`
`payment_reference`	VARCHAR(255) NULL	stripe_session_id / paypal_order_id
`total_excl_tax`, `tax_amount`, `total_incl_tax`	DECIMAL(10,2)
`currency`	CHAR(3)	`EUR`
`customer_snapshot`	LONGTEXT	snapshot dati cliente al checkout
`billing_address`	LONGTEXT
`coupon_code`, `discount_amount`
`affiliate_id`	BIGINT NULL	FK affiliates
`metadata_json`	LONGTEXT NULL
`paid_at`, `provisioned_at`, `cancelled_at`	DATETIME

`wp_hwbi_order_items`

Line items per ordine. Permette ordini multi-prodotto (es. hosting + dominio).

`wp_hwbi_subscriptions`

Abbonamenti ricorrenti. Sync con Stripe/PayPal Subscription IDs.

Colonna	Note
`id`, `user_id`, `order_id`, `plan_id`
`status`	`trial`	`active`	`past_due`	`suspended`	`cancelled`	`expired`
`stripe_subscription_id`, `paypal_subscription_id`	Sync con gateway
`plesk_subscription_id`, `plesk_account_id`	Sync con Plesk
`current_period_start`, `current_period_end`, `next_renewal_at`
`cancel_at`, `cancelled_at`, `cancellation_reason`

`wp_hwbi_invoices`

Fatture italiane SDI-compatibili.

Colonna	Note
`invoice_number`	UNIQUE — formato `2026/0001` (sequenziale per anno)
`invoice_year`, `invoice_seq`	UNIQUE composite
`customer_snapshot`, `supplier_snapshot`, `line_items_snapshot`	Immutabili al momento emissione
`pdf_relative_path`	path al PDF generato
`sdi_transmission_id`, `sdi_status`, `sdi_response_json`	Sync con Aruba per fattura elettronica B2B

`wp_hwbi_payments`

Audit trail di ogni pagamento ricevuto. Idempotency garantita.

Colonna	Note
`webhook_event_id`	UNIQUE — dedup pagamenti
`gateway`, `gateway_reference`
`amount_excl_tax`, `tax_amount`, `amount_incl_tax`
`status`	`pending`	`succeeded`	`failed`	`refunded`
`raw_event_json`	dump dell’evento per debug

`wp_hwbi_provisioning_jobs`

Coda worker per orchestrare azioni su Plesk / domain provider.

Colonna	Note
`job_type`	`create_plesk_subscription`	`suspend`	`reactivate`	`cancel`	`renew`	`update_plan`
`status`	`pending`	`running`	`done`	`failed`	`cancelled`
`payload`, `result`	JSON
`attempts`, `max_attempts`	exponential backoff

`wp_hwbi_coupons`

Codici sconto. CRUD in Fase B+.

`wp_hwbi_affiliates` + `wp_hwbi_affiliate_commissions`

Programma referral. Fase I.

wp_options usate dal plugin

Option	Default	Note
`hwbi_db_version`	`1.0.0`	versione schema corrente
`hwbi_billing_v2_enabled`	`false`	master toggle V2
`hwbi_upmind_enabled`	`true`	master toggle Upmind legacy
`hwbi_billing_mode`	`upmind_only`	enum modalità runtime
`hwbi_v2_beta_users`	`''`	CSV user_id beta tester
`hwbi_stripe_publishable_key`	`''`
`hwbi_stripe_secret_key`	`''`
`hwbi_stripe_webhook_secret`	`''`
`hwbi_paypal_client_id`	`''`
`hwbi_paypal_secret`	`''`
`hwbi_paypal_webhook_id`	`''`
`hwbi_paypal_mode`	`sandbox`	`sandbox`	`live`
`hwbi_aruba_sdi_username`	`''`	Fase F
`hwbi_aruba_sdi_password`	`''`	Fase F
`hwbi_aruba_sdi_endpoint`	`''`
`hwbi_legal_data`	array	ragione sociale, P.IVA, REA, IBAN, PEC, codice SDI, …
`hwbi_order_counter_2026`	int	counter atomico per `order_number`
`hwbi_invoice_counter_2026`	int	counter atomico per `invoice_number`

Tutti autoload=false per non rallentare le request che non toccano billing.

Migrazione

Schema versione gestita da Installer::maybe_upgrade() con version_compare( $current, HWBI_DB_VERSION ). Idempotente via dbDelta.

Hostwebo Billing — Database Schema

Hostwebo Billing — Database Schema

Tabelle

`wp_hwbi_plans`

`wp_hwbi_orders`

`wp_hwbi_order_items`

`wp_hwbi_subscriptions`

`wp_hwbi_invoices`

`wp_hwbi_payments`

`wp_hwbi_provisioning_jobs`

`wp_hwbi_coupons`

`wp_hwbi_affiliates` + `wp_hwbi_affiliate_commissions`

wp_options usate dal plugin

Migrazione

Questa guida ti è stata utile?

Continua a leggere

Testing Guide — Hostwebo Billing V2

PayPal Integration (Phase C)

Cutover Playbook — Upmind → Hostwebo Billing V2

Hostwebo Billing — Architecture

Hostwebo Billing — Database Schema

Hostwebo Billing — Database Schema #

Tabelle #

wp_hwbi_plans #

wp_hwbi_orders #

wp_hwbi_order_items #

wp_hwbi_subscriptions #

wp_hwbi_invoices #

wp_hwbi_payments #

wp_hwbi_provisioning_jobs #

wp_hwbi_coupons #

wp_hwbi_affiliates + wp_hwbi_affiliate_commissions #

wp_options usate dal plugin #

Migrazione #

Questa guida ti è stata utile?

Continua a leggere

Testing Guide — Hostwebo Billing V2

PayPal Integration (Phase C)

Cutover Playbook — Upmind → Hostwebo Billing V2

Hostwebo Billing — Architecture

Hostwebo Billing — Database Schema

Tabelle

`wp_hwbi_plans`

`wp_hwbi_orders`

`wp_hwbi_order_items`

`wp_hwbi_subscriptions`

`wp_hwbi_invoices`

`wp_hwbi_payments`

`wp_hwbi_provisioning_jobs`

`wp_hwbi_coupons`

`wp_hwbi_affiliates` + `wp_hwbi_affiliate_commissions`

wp_options usate dal plugin

Migrazione