using GB5Shared.DTO.Framework.Login;

namespace GoodBooks.PAY.PAYBLL.Checkout
{
    public interface IPayOrderBLL
    {
        Task<string> GetPayOrder(int payOrderId, LoginDTO login, CancellationToken ct);
        Task<string> GetPayOrderList(int pageOffset, int pageSize, LoginDTO login, CancellationToken ct);

        /// <summary>Entitlement↔Payment loose coupling (§9.1) — payment history for one
        /// (SourceDocType, SourceDocId) pair, newest first.</summary>
        Task<string> GetPayOrdersBySourceDoc(int sourceDocType, int sourceDocId, LoginDTO login, CancellationToken ct);

        /// <summary>
        /// Creates a payment order end-to-end:
        /// validates inputs → checks for duplicates → validates coupon/loyalty →
        /// computes net payable → DB insert → calls gateway CreateOrder →
        /// DB update with gateway order ID → returns CheckoutUrl (or null for COD).
        /// </summary>
        Task<string> InitiatePayOrder(InitiatePayOrderRequest request, LoginDTO login, CancellationToken ct);
    }
}