УниКредит покупки на Кредит

УниКредит покупки на Кредит — WooCommerce модул, комуникиращ с Контролния панел и SmartUCF.

Description

Дава възможност на Вашите клиенти да закупуват стока на изплащане с УНИ Кредит.

Business rules (authoritative)

Canonical business rules for public bank statuses, later SmartUCF statuses, internal/service lifecycle states, allowed display locations, and the standard leasing information block are documented in:

docs/BUSINESS-RULES-BANK-STATUS-AND-LEASING.md

Those rules are authoritative for manual business tests and future changes. Do not treat internal lifecycle/debug values as standard bank statuses. Do not invent SmartUCF status mappings. Do not put diagnostic fields into the normal customer/business leasing UI.

The four standard bank status strings (until a later SmartUCF status arrives) are exactly:

• Неуспешно изпратен Банка - КП
• Неуспешно изпратен Банка - SmartUCF
• Изпратен Банка - Процес 1
• Изпратен Банка - Процес 2

Later SmartUCF statuses are stored and shown exactly as returned by SmartUCF.

Installation

1. Качете папката mtunicredit в /wp-content/plugins/.
2. Активирайте плъгина от меню Плъгини в WordPress.
3. Уверете се, че WooCommerce е активен.
4. Конфигурирайте връзката с Контролния панел от настройките на модула.

Deployment (vendor)

Before creating the production installation ZIP, add secrets/smartucf-key.php containing the SmartUCF private-key password.

The ZIP is prepared manually and uploaded to the Bank/CP portal. It contains Git source plus deployment-only files (certificates, secrets/smartucf-key.php). Merchants install the ZIP normally; they do not edit wp-config or environment variables for the SSL password.

Changelog

2.0.3

• Cache and expose CP satrudnik_email in the local shop snapshot.
• Notify the shop Satrudnik on definitive bank send failures (bank_send_failed_cp / bank_send_failed_smartucf).

2.0.2

• Canonical Product, Cart, and Checkout financing scheme ordering.
• Cart automatic-first-installment preview and promotional representative parity.
• Checkout promotional fallback priority and invalid prefill normalization.
• Checkout first-installment reset when switching financing schemes.
• Cross-line conflicting automatic-first-installment safety and regression coverage.

2.0.1

• Authoritative product price and quantity for product-popup financing (AUD-WOO-001).
• Canonical full payable order amount across cart/checkout → CP → SmartUCF (AUD-WOO-002).
• WooCommerce/CP transaction currency integrity gate (AUD-WOO-003).
• Native Woo order status remains merchant-controlled after create; bank callbacks update financing state only (AUD-WOO-004).
• Ambiguous CP create outcomes are marked for safe idempotent retry instead of claiming non-creation (AUD-WOO-005).
• Process 1 records bank_sent_process1 only after SmartUCF success; Process 2 after CP create (AUD-WOO-008).
• CP status PATCH failures persist pending sync diagnostics with bounded retry (AUD-WOO-009).
• Durable popup operation token prevents duplicate Woo/CP/SmartUCF orders on retry (AUD-WOO-006).
• CP shop order_id equals Woo internal numeric order ID (max 13), persisted meta and exact HPOS lookup (AUD-WOO-007; hotfix: not base36/W-prefix).
• Shop configuration stale-if-error fallback with refresh lock and stampede protection (AUD-WOO-010).
• SmartUCF SSL private-key password from deployment secret file or dev overrides, not plugin source (AUD-WOO-011).
• Customer-safe error normalization for AJAX, checkout and gateway flows (AUD-WOO-012).
• Order-level financing diagnostics independent of WP_DEBUG (AUD-WOO-013).

1.0.0

• Първоначална версия — гръбнак на модула.