8af86e9e89
- wallet-service: IPaymentGateway abstraction + VN Pay implementation (HMAC-SHA512, sandbox), Payment aggregate root, PaymentsController with create/callback/query endpoints - order-service: PosHub SignalR hub with Redis backplane + MessagePack, strongly-typed clients, 3 group types (shop/kds/pos), integrated into Create/Pay/Complete/Cancel order handlers - fnb-engine + inventory-service: Kitchen→Inventory auto-deduction via domain events, HTTP with Polly retry + circuit breaker, idempotency check, graceful degradation on insufficient stock - order-service: Enhanced PayOrderCommand with 3 flows (cash/card/online), PaymentPending status, WalletServiceClient, CompleteOrderPaymentCommand for gateway callbacks - POS frontend: Cash/Card/QR payment components wired to real backend, BFF proxy updated - infra: Traefik routes for fnb-engine, inventory-service, and SignalR WebSocket hub - ROADMAP.md: Updated with Phase 1 progress tracking Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
41 lines
1.9 KiB
C#
41 lines
1.9 KiB
C#
// EN: Interface for wallet-service client — abstracts payment gateway interaction.
|
|
// VI: Interface cho wallet-service client — trừu tượng hóa tương tác cổng thanh toán.
|
|
|
|
namespace OrderService.Infrastructure.ExternalServices;
|
|
|
|
/// <summary>
|
|
/// EN: Client interface for communicating with wallet-service for payment processing.
|
|
/// VI: Interface client để giao tiếp với wallet-service cho xử lý thanh toán.
|
|
/// </summary>
|
|
public interface IWalletServiceClient
|
|
{
|
|
/// <summary>
|
|
/// EN: Create a payment request via wallet-service. Returns payment URL for online gateways.
|
|
/// VI: Tạo yêu cầu thanh toán qua wallet-service. Trả về URL thanh toán cho cổng trực tuyến.
|
|
/// </summary>
|
|
/// <param name="orderId">EN: Order ID / VI: Mã đơn hàng</param>
|
|
/// <param name="amount">EN: Payment amount / VI: Số tiền thanh toán</param>
|
|
/// <param name="gateway">EN: Payment gateway (vnpay, momo) / VI: Cổng thanh toán (vnpay, momo)</param>
|
|
/// <param name="returnUrl">EN: URL to redirect after payment / VI: URL redirect sau thanh toán</param>
|
|
/// <param name="ipAddress">EN: Client IP address / VI: Địa chỉ IP client</param>
|
|
/// <param name="cancellationToken">EN: Cancellation token / VI: Token hủy</param>
|
|
/// <returns>EN: Payment creation response with URL and transaction ID / VI: Response tạo thanh toán với URL và mã giao dịch</returns>
|
|
Task<CreatePaymentResponse?> CreatePaymentAsync(
|
|
Guid orderId,
|
|
decimal amount,
|
|
string gateway,
|
|
string returnUrl,
|
|
string ipAddress,
|
|
CancellationToken cancellationToken = default);
|
|
}
|
|
|
|
/// <summary>
|
|
/// EN: Response from wallet-service payment creation.
|
|
/// VI: Response từ wallet-service khi tạo thanh toán.
|
|
/// </summary>
|
|
public record CreatePaymentResponse(
|
|
string TransactionId,
|
|
string PaymentUrl,
|
|
string Status
|
|
);
|