📘

Pagamenti & Banking

payments sales_billing 🛡️ RLS Protected

Il-pagamenti & il-banek <unk> Dokumentazzjoni tal-proċess u l-API derivata mill-kodiċi.

Fachliche Bestimmung: Il-Pajlamenti u l-Banking <unk> Dokumentazzjoni tal-proċess u tal-API derivata mill-kodiċi.

⚡ Flussi ta' xogħol u ċikli ta' ħajja (2) 🗄️ Modelli tad-dejta & Felder (2) 🔌 Punti ta' Bidu (UI & API) (11) 🛡️ Regolatorji u konformità

⚡ Flussi ta' xogħol u ċikli ta' ħajja

L-ordni tal-utent: aġent li jqabbel il-ħlas `plan:command_payment_matching_agent`

Geprüfter Durable-Plan (durable_plan), Start: manual_command.

1. payment_matching_agent

payment_matching_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "payment_matching_agent", "condition_fact": null}

Aktionen: payment_matching_agent

Pagament `status:payment`

L-użu tal-apparat tal-istatus osservattiv (observable_only) ma jkunx obbligat.

1. unmatched

mhux imqabbla

Statut <unk>inmatched<unk> tal-magna tal-istat

2. matched

li jappartjenu

Statut <unk>matched<unk> tal-magna tal-istat ta' ħlas.

3. confirmed

ikkonfermat

Statut <unk>Konfirmat <unk> tal-ħlas tal-magna tal-istat.

🗄️ Modelli tad-dejta & Felder

PaymentOrders payment_orders RLS Aktiv

14 Il-kamps / il-kolla

Tabelle payment_orders

Feldname	Tip ta' data	Obbligu	Schlüssel	L-importanza professjonali
`kind`	`VARCHAR(16)`	Ja *	-	Feld kind
`package_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld package_amount
`package_gb`	`INTEGER`	Nein	-	Feld package_gb
`provider`	`VARCHAR(16)`	Ja *	-	Feld provider
`provider_session_id`	`VARCHAR(255)`	Nein	-	Feld provider_session_id
`status`	`VARCHAR(16)`	Ja *	-	Feld status
`created_by`	`UUID`	Nein	-	Feld created_by
`paid_at`	`DATETIME`	Nein	-	Feld paid_at
`topup_id`	`UUID`	Nein	FK ➔ ai_budget_topups.id	Feld topup_id
`rental_booking_id`	`UUID`	Nein	FK ➔ rental_bookings.id	Feld rental_booking_id
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at

Payments payments RLS Aktiv

23 Il-kamps / il-kolla

Tabelle payments

Feldname	Tip ta' data	Obbligu	Schlüssel	L-importanza professjonali
`transaction_date`	`DATE`	Ja *	-	Feld transaction_date
`value_date`	`DATE`	Nein	-	Feld value_date
`amount`	`NUMERIC(14, 2)`	Ja *	-	Feld amount
`currency`	`VARCHAR(3)`	Ja *	-	Feld currency
`direction`	`VARCHAR(48)`	Ja *	-	Feld direction
`payment_method`	`VARCHAR(32)`	Nein	-	Feld payment_method
`counterparty_name`	`VARCHAR(255)`	Nein	-	Feld counterparty_name
`counterparty_iban`	`VARCHAR(34)`	Nein	-	Feld counterparty_iban
`reference`	`TEXT`	Nein	-	Feld reference
`bank_transaction_id`	`VARCHAR(128)`	Ja *	-	Feld bank_transaction_id
`invoice_id`	`UUID`	Nein	FK ➔ invoices.id	Feld invoice_id
`bank_account_id`	`UUID`	Nein	FK ➔ bank_accounts.id	Feld bank_account_id
`matching_confidence`	`NUMERIC(4, 3)`	Nein	-	Feld matching_confidence
`status`	`VARCHAR(48)`	Ja *	-	Feld status
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

🔌 Punti ta' Bidu (UI & API)

Art	Il-metodu	Punti ta ' tmiem / pjaċċ	Titel & Zweck	L-eżenzjoni
⚡ REST API	DELETE	`/api/v1/payments/{payment_id}`	delete_payment Semantic binding: operator_surface; mutation=True	`payments`
⚡ REST API	GET	`/api/v1/payments`	list_payments Semantic binding: inventory_only; mutation=False	`payments`
⚡ REST API	GET	`/payments`	payments_page Semantic binding: inventory_only; mutation=False	`payments`
⚡ REST API	GET	`/payments/new`	payment_create_page Semantic binding: inventory_only; mutation=False	`payments`
⚡ REST API	GET	`/payments/{payment_id}`	payment_detail_page Semantic binding: inventory_only; mutation=False	`payments`
⚡ REST API	GET	`/payments/{provider}/return`	payments_return Semantic binding: inventory_only; mutation=False	`payments`
⚡ REST API	POST	`/api/v1/payments`	create_payment Semantic binding: operator_surface; mutation=True	`payments`
⚡ REST API	POST	`/api/v1/payments/import-statement`	import_bank_statement Semantic binding: operator_surface; mutation=True	`payments`
⚡ REST API	POST	`/api/v1/payments/{payment_id}/assign-account`	assign_bank_account Semantic binding: operator_surface; mutation=True	`payments`
⚡ REST API	POST	`/api/v1/payments/{payment_id}/match`	match_payment Semantic binding: operator_surface; mutation=True	`payments`
⚡ REST API	POST	`/api/v1/payments/{payment_id}/unmatch`	unmatch_payment Semantic binding: operator_surface; mutation=True	`payments`

🛡️ Regolatorji u konformità

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

L-impriża għandha tinvestiga l-impriża.
Il-konnessjoni tal-konnessjoni