Files
sam-kd/eaccount/api/usage.php
2025-12-16 20:05:46 +09:00

398 lines
15 KiB
PHP

<?php
/**
* 카드 사용내역 조회 API
*
* 파라미터:
* - type: daily(일별), monthly(월별), period(기간별, 기본값)
* - cardNum: 카드번호 (빈값이면 전체)
* - startDate: 시작일 (YYYYMMDD) - period 타입
* - endDate: 종료일 (YYYYMMDD) - period 타입
* - baseDate: 기준일 (YYYYMMDD) - daily 타입
* - baseMonth: 기준월 (YYYYMM) - monthly 타입
* - page: 페이지 번호 (기본 1)
* - limit: 페이지당 건수 (기본 50)
* - debug: 1이면 디버그 정보 포함
*/
header('Content-Type: application/json; charset=utf-8');
// load .env
require_once __DIR__ . '/../../lib/DotEnv.php';
(new DotEnv(__DIR__ . '/../../.env'))->load();
require_once('barobill_card_config.php');
// 디버그 모드
$debugMode = isset($_GET['debug']) && $_GET['debug'] == '1';
try {
$type = $_GET['type'] ?? 'period';
$cardNum = $_GET['cardNum'] ?? '';
$page = max(1, intval($_GET['page'] ?? 1));
$limit = min(100, max(10, intval($_GET['limit'] ?? 50)));
$orderDirection = intval($_GET['order'] ?? 2); // 2: 내림차순 (최신순)
$result = null;
// cardNum이 빈 값이면 전체 카드 조회 (각 카드별로 조회 후 병합)
if (empty($cardNum)) {
// 등록된 카드 목록 조회
$cardsResult = getCardList(1); // 사용 가능한 카드만
if (!$cardsResult['success'] || empty($cardsResult['data'])) {
$result = [
'success' => true,
'data' => [
'currentPage' => 1,
'countPerPage' => $limit,
'maxPageNum' => 1,
'maxIndex' => 0,
'logs' => []
]
];
} else {
// 각 카드별로 조회 후 병합
$allLogs = [];
foreach ($cardsResult['data'] as $card) {
$cardNumToQuery = $card->CardNum ?? '';
if (empty($cardNumToQuery)) continue;
switch ($type) {
case 'daily':
$baseDate = $_GET['baseDate'] ?? date('Ymd');
$tempResult = getDailyCardUsage($cardNumToQuery, $baseDate, 100, 1, $orderDirection);
break;
case 'monthly':
$baseMonth = $_GET['baseMonth'] ?? date('Ym');
$tempResult = getMonthlyCardUsage($cardNumToQuery, $baseMonth, 100, 1, $orderDirection);
break;
case 'period':
default:
$startDate = $_GET['startDate'] ?? date('Ymd', strtotime('-30 days'));
$endDate = $_GET['endDate'] ?? date('Ymd');
$tempResult = getPeriodCardUsage($cardNumToQuery, $startDate, $endDate, 100, 1, $orderDirection);
break;
}
if ($tempResult['success'] && !empty($tempResult['data']['logs'])) {
$allLogs = array_merge($allLogs, $tempResult['data']['logs']);
}
}
// UseDT 기준으로 정렬
usort($allLogs, function($a, $b) use ($orderDirection) {
$aTime = $a->UseDT ?? '';
$bTime = $b->UseDT ?? '';
return $orderDirection == 1 ? strcmp($aTime, $bTime) : strcmp($bTime, $aTime);
});
// 페이징 처리
$totalCount = count($allLogs);
$maxPageNum = ceil($totalCount / $limit);
$offset = ($page - 1) * $limit;
$pagedLogs = array_slice($allLogs, $offset, $limit);
$result = [
'success' => true,
'data' => [
'currentPage' => $page,
'countPerPage' => $limit,
'maxPageNum' => $maxPageNum,
'maxIndex' => $totalCount,
'logs' => $pagedLogs
]
];
}
} else {
// 특정 카드 조회
switch ($type) {
case 'daily':
$baseDate = $_GET['baseDate'] ?? date('Ymd');
$result = getDailyCardUsage($cardNum, $baseDate, $limit, $page, $orderDirection);
break;
case 'monthly':
$baseMonth = $_GET['baseMonth'] ?? date('Ym');
$result = getMonthlyCardUsage($cardNum, $baseMonth, $limit, $page, $orderDirection);
break;
case 'period':
default:
$startDate = $_GET['startDate'] ?? date('Ymd', strtotime('-30 days'));
$endDate = $_GET['endDate'] ?? date('Ymd');
$result = getPeriodCardUsage($cardNum, $startDate, $endDate, $limit, $page, $orderDirection);
break;
}
}
if ($result['success']) {
$logs = [];
// 디버그: raw 로그 데이터 출력
if ($debugMode && !empty($result['data']['logs'])) {
$firstLog = $result['data']['logs'][0];
error_log('CardApprovalLog raw data: ' . print_r($firstLog, true));
// 디버그: 모든 필드명 확인
if (is_object($firstLog)) {
$fields = get_object_vars($firstLog);
error_log('CardApprovalLog fields: ' . implode(', ', array_keys($fields)));
error_log('ApprovalAmount value: ' . ($firstLog->ApprovalAmount ?? 'NOT SET'));
error_log('Amount value: ' . ($firstLog->Amount ?? 'NOT SET'));
error_log('TotalAmount value: ' . ($firstLog->TotalAmount ?? 'NOT SET'));
}
}
foreach ($result['data']['logs'] as $log) {
// UseDT 형식: YYYYMMDDHHMMSS
$useDT = $log->UseDT ?? '';
$approvalDate = '';
$approvalTime = '';
if (strlen($useDT) >= 8) {
$approvalDate = substr($useDT, 0, 4) . '-' . substr($useDT, 4, 2) . '-' . substr($useDT, 6, 2);
}
if (strlen($useDT) >= 14) {
$approvalTime = substr($useDT, 8, 2) . ':' . substr($useDT, 10, 2) . ':' . substr($useDT, 12, 2);
} elseif (strlen($useDT) >= 12) {
$approvalTime = substr($useDT, 8, 2) . ':' . substr($useDT, 10, 2);
}
$logs[] = [
'cardNum' => maskCardNumber($log->CardNum ?? ''),
'cardNumFull' => $log->CardNum ?? '',
'approvalNum' => $log->ApprovalNum ?? '',
'approvalDate' => $approvalDate,
'approvalTime' => $approvalTime,
'approvalDateTime' => $approvalDate . ' ' . $approvalTime,
'merchantName' => $log->UseStoreName ?? '',
'merchantBizNum' => $log->UseStoreCorpNum ?? '',
// 금액 필드: 여러 가능한 필드명 시도
// ApprovalAmount가 실제 승인금액 (화면에 표시할 금액)
'amount' => intval($log->ApprovalAmount ?? 0),
'amountFormatted' => number_format(intval($log->ApprovalAmount ?? 0)),
'vat' => intval($log->Tax ?? 0),
'vatFormatted' => number_format(intval($log->Tax ?? 0)),
'serviceCharge' => intval($log->ServiceCharge ?? 0),
// totalAmount는 화면에서 사용하므로 ApprovalAmount를 사용
'totalAmount' => intval($log->ApprovalAmount ?? 0),
'totalAmountFormatted' => number_format(intval($log->ApprovalAmount ?? 0)),
'approvalType' => $log->ApprovalType ?? '',
'approvalTypeName' => getApprovalTypeName($log->ApprovalType ?? ''),
'installment' => $log->PaymentPlan ?? '',
'installmentName' => getInstallmentName($log->PaymentPlan ?? ''),
'currencyCode' => $log->CurrencyCode ?? 'KRW',
'memo' => $log->Memo ?? '',
'cardCompany' => $log->CardCompany ?? '',
'cardCompanyName' => getCardCompanyNameFromLog($log->CardCompany ?? ''),
// 추가 필드
'useKey' => $log->UseKey ?? '',
'storeAddress' => $log->UseStoreAddr ?? '',
'storeCeo' => $log->UseStoreCeo ?? '',
'storeBizType' => $log->UseStoreBizType ?? '',
'storeTel' => $log->UseStoreTel ?? ''
];
}
// 통계 계산
$totalAmount = array_sum(array_column($logs, 'totalAmount'));
$approvalCount = count(array_filter($logs, function($l) { return $l['approvalType'] == '1'; }));
$cancelCount = count(array_filter($logs, function($l) { return $l['approvalType'] == '2'; }));
$response = [
'success' => true,
'data' => [
'logs' => $logs,
'pagination' => [
'currentPage' => $result['data']['currentPage'],
'countPerPage' => $result['data']['countPerPage'],
'maxPageNum' => $result['data']['maxPageNum'],
'totalCount' => $result['data']['maxIndex']
],
'summary' => [
'totalAmount' => $totalAmount,
'totalAmountFormatted' => number_format($totalAmount),
'count' => count($logs),
'approvalCount' => $approvalCount,
'cancelCount' => $cancelCount
]
]
];
// 디버그 정보 추가 (성공한 경우에도 항상 첫 번째 로그의 필드 정보 출력)
if (!empty($result['data']['logs'])) {
$firstLog = $result['data']['logs'][0];
if (is_object($firstLog)) {
// 모든 필드를 배열로 변환
$allFields = get_object_vars($firstLog);
$fieldNames = array_keys($allFields);
// 금액 관련 필드 찾기 (대소문자 구분 없이)
$amountFields = [];
foreach ($fieldNames as $fieldName) {
if (stripos($fieldName, 'amount') !== false ||
stripos($fieldName, 'cost') !== false ||
stripos($fieldName, 'price') !== false ||
stripos($fieldName, '금액') !== false) {
$amountFields[$fieldName] = (string)($firstLog->$fieldName ?? 'NULL');
}
}
// 디버그 모드일 때만 상세 정보 출력
if ($debugMode) {
$response['debug'] = [
'userId' => getBarobillUserId(),
'params' => $_GET,
'firstLogFields' => $fieldNames,
'firstLogAllValues' => array_map(function($v) {
return is_string($v) ? $v : (is_numeric($v) ? (string)$v : gettype($v));
}, $allFields),
'amountFields' => $amountFields
];
} else {
// 디버그 모드가 아니어도 금액 필드 정보는 항상 포함 (문제 해결용)
$response['debug'] = [
'amountFields' => $amountFields,
'allFields' => $fieldNames
];
}
}
} elseif ($debugMode) {
$response['debug'] = [
'userId' => getBarobillUserId(),
'params' => $_GET,
'message' => 'No logs found'
];
}
echo json_encode($response, JSON_UNESCAPED_UNICODE);
} else {
// API Error Handling (Graceful Fallback)
// If API fails (e.g., SoapClient missing), return empty list with warning
$response = [
'success' => true, // Masquerade as success to render empty table
'data' => [
'logs' => [],
'pagination' => [
'currentPage' => 1,
'countPerPage' => $limit,
'maxPageNum' => 1,
'totalCount' => 0
],
'summary' => [
'totalAmount' => 0,
'totalAmountFormatted' => '0',
'count' => 0,
'approvalCount' => 0,
'cancelCount' => 0
]
],
'warning' => 'API 연동 실패: ' . $result['error'],
'api_error_code' => $result['error_code'] ?? null
];
// 디버그 정보 추가
if ($debugMode) {
$response['debug'] = [
'userId' => getBarobillUserId(),
'params' => $_GET
];
}
echo json_encode($response, JSON_UNESCAPED_UNICODE);
}
} catch (Throwable $e) {
echo json_encode([
'success' => true, // Return true to avoid UI breakage
'data' => [
'logs' => [],
'pagination' => ['currentPage' => 1, 'maxPageNum' => 1, 'totalCount' => 0],
'summary' => ['totalAmount' => 0, 'count' => 0]
],
'warning' => '시스템 오류: ' . $e->getMessage()
], JSON_UNESCAPED_UNICODE);
}
/**
* 카드번호 마스킹
*/
function maskCardNumber($cardNum) {
if (strlen($cardNum) < 8) return $cardNum;
return substr($cardNum, 0, 4) . '-****-****-' . substr($cardNum, -4);
}
/**
* 날짜 포맷팅
*/
function formatDate($date) {
if (strlen($date) === 8) {
return substr($date, 0, 4) . '-' . substr($date, 4, 2) . '-' . substr($date, 6, 2);
}
return $date;
}
/**
* 시간 포맷팅
*/
function formatTime($time) {
if (strlen($time) === 6) {
return substr($time, 0, 2) . ':' . substr($time, 2, 2) . ':' . substr($time, 4, 2);
} elseif (strlen($time) === 4) {
return substr($time, 0, 2) . ':' . substr($time, 2, 2);
}
return $time;
}
/**
* 승인 유형 이름
*/
function getApprovalTypeName($type) {
$types = [
'1' => '승인',
'2' => '취소'
];
return $types[$type] ?? $type;
}
/**
* 할부 이름
*/
function getInstallmentName($installment) {
if (empty($installment) || $installment == '0' || $installment == '00') {
return '일시불';
}
return $installment . '개월';
}
/**
* 카드사 이름 (로그용)
*/
function getCardCompanyNameFromLog($code) {
$companies = [
'01' => '비씨',
'02' => 'KB국민',
'03' => '하나(외환)',
'04' => '삼성',
'06' => '신한',
'07' => '현대',
'08' => '롯데',
'11' => 'NH농협',
'12' => '수협',
'13' => '씨티',
'14' => '우리',
'15' => '광주',
'16' => '전북',
'21' => '하나',
'22' => '제주',
'23' => 'SC제일',
'25' => 'KDB산업',
'26' => 'IBK기업',
'27' => '새마을금고',
'28' => '신협',
'29' => '저축은행',
'30' => '우체국',
'31' => '카카오뱅크',
'32' => 'K뱅크',
'33' => '토스뱅크'
];
return $companies[$code] ?? $code;
}
?>