using Application.Abstractions.Data;
using Application.Abstractions.Messaging;
using Application.Abstractions.Payment;
using Domain.Entities.Common.ValueObject;
using Domain.Entities.Payments;
using Domain.Entities.Payments.Toss;
using Domain.Entities.Payments.Toss.ValueObject;
using Domain.Entities.Payments.ValueObject;
using Domain.Entities.Wallets.ValueObject;
using Microsoft.EntityFrameworkCore;
using SharedKernel.Results;
namespace Application.Features.Admin.Payment.Toss.Confirm.Cancel;
/// 운영자 강제취소 — 토스 취소 API 로 전체 취소 (Phase 1.5 계약 승계)
public sealed class Handler(
IAppDbContext db,
ITossPaymentService tossPay,
IAppDbContextFactory dbFactory
) : ICommandHandler
{
public async Task Handle(Command request, CancellationToken ct)
{
var confirm = await db.TossConfirm.FirstOrDefaultAsync(c => c.ID == request.ID, ct);
if (confirm is null)
{
return Result.Failure(Error.NotFound("Toss.ConfirmNotFound", "결제 내역을 찾을 수 없습니다."));
}
var order = await db.PaymentOrder.FirstOrDefaultAsync(c => c.ID == confirm.PaymentOrderID, ct);
if (order is null)
{
return Result.Failure(Error.NotFound("Payment.OrderNotFound", "주문을 찾을 수 없습니다."));
}
// 진실의 근원은 PaymentOrder.Status — TossConfirm 응답이 비정상이어도
// PG 측에 실제 결제가 잡혀있다면(=Paid) 운영자 강제 환불이 필요.
if (order.Status != PaymentStatus.Paid)
{
return Result.Failure(Error.Problem("Payment.InvalidStatusForCancel", "취소할 수 없는 주문 상태입니다."));
}
// 이미 성공 취소된 경우 방지
var hasSuccessfulCancel = await db.TossCancel.AnyAsync(c => c.PaymentOrderID == order.ID && c.ResponseCode == "SUCCESS", ct);
if (hasSuccessfulCancel)
{
return Result.Failure(Error.Problem("Toss.AlreadyCancelled", "이미 결제가 취소되었습니다."));
}
// paymentKey 확보 — MarkPaid 시 TransactionID 에 저장됨. 없으면 TossConfirm 에서 보강.
var paymentKey = string.IsNullOrEmpty(order.TransactionID) ? confirm.PaymentKey : order.TransactionID;
// 환불 가능성 선검증 — PG 취소 성공 후 지갑 회수가 실패하면 PG-지갑 desync 가 되므로
// 지갑 존재와 충전 잔액(PgCharged)을 PG 호출 전에 확정한다. (API Cancel 핸들러와 동일 패턴)
var wallet = await db.Wallet.Include(w => w.Balances).Include(w => w.Transactions).AsSplitQuery().FirstOrDefaultAsync(w => w.MemberID == order.MemberID, ct);
if (wallet is null)
{
return Result.Failure(Error.NotFound("Payment.WalletNotFound", "지갑 정보를 찾을 수 없습니다."));
}
var pgCharged = wallet.Balances.Where(b => b.Type == WalletBalanceType.PgCharged).Sum(b => b.Amount.Value);
if (pgCharged < order.PointAmount)
{
return Result.Failure(Error.Problem("Payment.PointAlreadySpent", "회원이 이미 사용한 캐시가 있어 결제를 취소할 수 없습니다. 수동 조정이 필요합니다."));
}
var cancelReason = string.IsNullOrWhiteSpace(request.CancelReason) ? "운영자 강제취소" : request.CancelReason;
// 취소 요청 기록 저장 (전체 취소)
var cancel = TossCancel.CreateRequest(order.MemberID, order.ID, paymentKey, order.OrderID, order.Amount, cancelReason, request.CancelRequester ?? "admin");
await db.TossCancel.AddAsync(cancel, ct);
await db.SaveChangesAsync(ct);
// 토스 취소 API 호출 (cancelAmount 미전달 = 전액 취소) — 통신 예외도 기록을 남긴다
TossPaymentResult result;
try
{
result = await tossPay.CancelAsync(paymentKey, cancelReason, null, ct);
}
catch (Exception ex)
{
cancel.SetError("EXCEPTION", ex.Message);
await db.TossLog.AddAsync(TossLog.Create(order.MemberID, TossLogType.Error, "EXCEPTION", ex.Message, paymentKey, order.OrderID), ct);
await db.SaveChangesAsync(ct);
return Result.Failure(Error.Problem("Toss.CancelFailed", "결제 취소 처리 중 오류가 발생했습니다."));
}
if (!result.Success)
{
cancel.SetError(result.Code ?? "FAIL", result.Message ?? "취소 실패");
await db.TossLog.AddAsync(TossLog.Create(order.MemberID, TossLogType.Failed, result.Code ?? "FAIL", result.Message ?? "취소 실패", paymentKey, order.OrderID), ct);
await db.SaveChangesAsync(ct);
return Result.Failure(Error.Problem("Toss.CancelFailed", result.Message ?? "결제 취소에 실패했습니다."));
}
// 취소 응답 저장
ApplyCancelResponse(cancel, result);
order.MarkCancelled();
// 충전분(PgCharged) 회수 — ChargeCancelled 원장 기록으로 출처를 보존한다.
// 잔액은 위에서 선검증했으므로 여기서 예외를 흡수하지 않는다.
// 주문 취소 + 회수는 단일 SaveChanges 원자 커밋 (실패 시 부분 반영 없음)
wallet.DebitChargeCancel(Money.KRW(order.PointAmount), "결제 취소 환불(운영자)", order.OrderID);
try
{
await db.SaveChangesAsync(ct);
}
catch (DbUpdateConcurrencyException ex)
{
// Phase 1.5: WalletBalance rowversion 동시성 충돌 — 오염된 컨텍스트는 버리고(커밋된 것 없음)
// 새 컨텍스트로 리로드해 도메인 연산을 1회 재적용한다. 첫 시도의 원장 기록은 미영속이므로 이중회수 없음.
try
{
return await RetryCancelPersistAsync(order.ID, cancel.ID, result, ct);
}
catch (Exception retryEx)
{
await TryWriteReconcileLogAsync(order.ID, paymentKey, order.PointAmount, $"ADMIN_CANCEL_PERSIST 재시도 실패: {retryEx.Message} (동시성 충돌: {ex.Message})");
throw;
}
}
catch (Exception ex)
{
// Phase 1.5: PG 취소는 성공했는데 저장 실패 — 별도 컨텍스트로 대사 로그를 독립 커밋한 뒤
// 기존 실패 흐름(예외 전파)을 유지한다.
await TryWriteReconcileLogAsync(order.ID, paymentKey, order.PointAmount, $"ADMIN_CANCEL_PERSIST 실패: {ex.Message}");
throw;
}
return Result.Success();
}
/// 동시성 충돌 1회 재시도 — 새 컨텍스트로 리로드 후 취소 반영을 재적용한다. (Phase 1.5)
private async Task RetryCancelPersistAsync(int paymentOrderID, int cancelID, TossPaymentResult result, CancellationToken ct)
{
await using var retryDb = dbFactory.CreateDbContext();
var order = await retryDb.PaymentOrder.FirstAsync(c => c.ID == paymentOrderID, ct);
if (order.Status == PaymentStatus.Cancelled)
{
// 동시 요청이 이미 취소 반영을 끝낸 경우 — 이중회수 금지, idempotent 성공 응답
return Result.Success();
}
var cancel = await retryDb.TossCancel.FirstAsync(c => c.ID == cancelID, ct);
ApplyCancelResponse(cancel, result);
var wallet = await retryDb.Wallet.Include(w => w.Balances).Include(w => w.Transactions).AsSplitQuery().FirstAsync(w => w.MemberID == order.MemberID, ct);
order.MarkCancelled();
// 리로드된 실제 잔액 기준 회수 — 충돌 사이에 캐시가 사용됐다면 Decrease 예외 → 호출부가 대사 로그를 남긴다
// (PG 환불은 이미 완료 — 자동 회수 불가, 운영자 수동 대사 대상)
wallet.DebitChargeCancel(Money.KRW(order.PointAmount), "결제 취소 환불(운영자)", order.OrderID);
await retryDb.SaveChangesAsync(ct);
return Result.Success();
}
/// 대사 로그 독립 커밋 — best-effort. 로그 실패가 원래 실패 흐름을 가리면 안 된다. (Phase 1.5)
private async Task TryWriteReconcileLogAsync(int paymentOrderID, string? paymentKey, int amount, string reason)
{
try
{
// 호출측 취소와 무관하게 반드시 남아야 하므로 CancellationToken.None
await using var logDb = dbFactory.CreateDbContext();
await logDb.PaymentReconcileLog.AddAsync(PaymentReconcileLog.Create(ReconcileKind.AdminCancel, paymentOrderID, paymentKey, amount, reason), CancellationToken.None);
await logDb.SaveChangesAsync(CancellationToken.None);
}
catch
{
// best-effort — 원래 예외를 유지한다
}
}
private static void ApplyCancelResponse(TossCancel cancel, TossPaymentResult result)
{
var last = result.Cancels.Count > 0 ? result.Cancels[^1] : null;
cancel.SetResponse(result.Status ?? "", last?.TransactionKey, last?.CanceledAt, result.RawJson);
}
}