Copy changelogs
Module Chuyển Đổi Tỷ Giá Nhanh & Thanh Toán Đa Tiền Tệ (Smart Payment cho Perfex CRM - smartpayment) giải quyết triệt để rào cản thanh toán quốc tế cho các doanh nghiệp dùng Perfex CRM. Module tự động đổi tỷ giá khi khách hàng thanh toán qua các cổng như PayPal/Stripe (vốn không hỗ trợ VND hoặc một số đồng tiền địa phương), đồng thời giữ nguyên vẹn giá trị và đồng tiền gốc trên hóa đơn gốc.
Các Phân Hệ Tính Năng Cốt Lõi
1. Tự Động Chuyển Đổi Tỷ Giá Khi Thanh Toán
- Cầu Nối Cổng Thanh Toán Đa Tiền Tệ: Tự động quy đổi số tiền hóa đơn ở các đồng tiền không được hỗ trợ (VND, EUR, GBP, AUD) sang đồng tiền thanh toán của cổng (USD) ngay trong quá trình checkout.
- Bảo Toàn Đồng Tiền Gốc Trực Quan: Hóa đơn gốc, chi tiết sản phẩm và lịch sử công nợ khách hàng vẫn được giữ nguyên ở đồng tiền địa phương.
2. Chốt Tỷ Giá Lịch Sử & Quản Lý Tỷ Giá Cố Định
- Lưu Vết Tỷ Giá Lịch Sử: Ghi nhận và khóa cố định tỷ giá quy đổi chính xác tại thời điểm khách bấm thanh toán vào nhật ký hóa đơn (
tblsmart_payment_exchange_rates). - Cấu Hình Tỷ Giá Cố Định: Cho phép Admin thiết lập bảng tỷ giá quy đổi cố định cho từng cặp tiền tệ trong cài đặt Admin nhằm kiểm soát biên độ chênh lệch.
3. Động Cơ Hooks Developer & Giao Diện Thông Báo Tỷ Giá
- Bộ Hooks & Filters Mở Rộng: Cung cấp các hàm lọc
smart_payment_get_exchange_ratevàsmart_payment_convert_currencycho nhà phát triển module Perfex CRM khác. - Khung Thông Báo Tỷ Giá Trực Quan: Nhúng khung thông báo quy đổi tỷ giá trực tiếp trên trang thanh toán công khai của khách hàng (
payment_gateway_head).
Kiến Trúc Hệ Thống Smart Payment
graph TD
A[Client Views Public Invoice Payment Page] --> B[Smart Payment Intercepts Gateway Checkout Head Hook]
B --> C[Fetch Fixed Exchange Rate from tblsmart_payment_exchange_rates]
C --> D[Calculate Converted Target Payment Amount]
D --> E[Render Conversion Notice & Update Gateway Checkout Button]
E --> F[Client Completes Payment via PayPal / Gateway]
F --> G[Record Transaction Payment with Locked Historical Exchange Rate]