HeuJung
f9c4c025cb
공개 이슈(gnuboard/g7) 17건 전수 대조에서 "진짜 누락"으로 판정된 5건을 해소한다.
— 서버가 만들어 내보내는 상점 주소가 각 지점에서 `/shop` 리터럴이나
`"/{$routePath}/..."` 조립으로 흩어져 있었다. 기본값이 아닌 상점에서는 그 주소가
존재하지 않는 화면을 가리키는데, 서버는 문자열을 만들어 내려보냈을 뿐이라 예외도
404 로그도 남지 않는다 — 링크만 조용히 죽는다. `ShopPathResolver` 를 단일 해석
지점으로 두고 주문 완료 이동·비회원 조회 안내·알림 메일·통합검색·상품문의·SEO
캐시·사이트맵 전 지점을 경유시켰다. 같은 값에 종속된 PG 4종 리다이렉트는
`{shopBase}` 자리표시자로, 편집기 상태 scope 는 선택 세그먼트 토큰 `/*?`
(engine-v1.58.0)로 해소했다. 기설치본은 업그레이드 스텝이 백필한다.
M-02 — 답변 깊이 상한이 config 는 1~10 인데 컬럼 comment 만 1~5 로 남아,
comment 에서 자동 생성되는 계약 문서 4곳이 실제보다 좁은 상한을 공개하고 있었다.
L-01 — 관리자 게시글 폼에 첨부 안내가 아예 없었고, 대신 사장된 고정 문구
("최대 5개 파일, 각 10MB")가 남아 있었다. 게시판마다 다른 실제 설정값을 렌더한다.
— 목록 1페이지가 공지 전량을 상한 없이 읽던 것에 안전상한을 두고(구조 무변경,
limit 부가만), 조회수 정렬 목록 술어를 덮는 복합 색인을 신설했다.
브라우저 실측 검수에서 발견한 사전 결함 1건(사용자 게시판 목록이 URL 정렬
파라미터를 데이터소스로 전달하지 않던 문제)도 함께 고쳤다. 폴백을 빈 문자열로 둬
URL 에 정렬이 없을 때 게시판 설정을 덮어쓰지 않게 했다.
310 lines
12 KiB
PHP
310 lines
12 KiB
PHP
<?php
|
|
|
|
namespace Plugins\Sirsoft\Tosspayments\Controllers;
|
|
|
|
use App\Extension\HookManager;
|
|
use App\Services\PluginSettingsService;
|
|
use Carbon\Carbon;
|
|
use Illuminate\Http\RedirectResponse;
|
|
use Illuminate\Http\Request;
|
|
use Illuminate\Support\Facades\Log;
|
|
use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
|
|
use Modules\Sirsoft\Ecommerce\Exceptions\PaymentAmountMismatchException;
|
|
use Modules\Sirsoft\Ecommerce\Helpers\DeviceDetector;
|
|
use Modules\Sirsoft\Ecommerce\Models\Order;
|
|
use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
|
|
use Plugins\Sirsoft\Tosspayments\Http\Requests\FailCallbackRequest;
|
|
use Plugins\Sirsoft\Tosspayments\Http\Requests\SuccessCallbackRequest;
|
|
use Plugins\Sirsoft\Tosspayments\Services\TossPaymentsApiService;
|
|
use Plugins\Sirsoft\Tosspayments\Support\ShopRedirectUrl;
|
|
|
|
/**
|
|
* 토스페이먼츠 결제 콜백 컨트롤러
|
|
*
|
|
* 토스페이먼츠 결제 완료/실패 후 브라우저 리다이렉트를 처리합니다.
|
|
* 성공 시 Confirm API를 호출하고, 주문 상태를 업데이트합니다.
|
|
*/
|
|
class PaymentCallbackController
|
|
{
|
|
private const PLUGIN_IDENTIFIER = 'sirsoft-tosspayments';
|
|
|
|
/**
|
|
* 카드 발급사 코드 → 이름 매핑
|
|
*/
|
|
private const CARD_ISSUER_MAP = [
|
|
'3K' => '기업 BC',
|
|
'46' => '광주',
|
|
'71' => '롯데',
|
|
'30' => '산업',
|
|
'31' => '비씨',
|
|
'51' => '삼성',
|
|
'38' => '새마을금고',
|
|
'41' => '신한',
|
|
'62' => '신협',
|
|
'36' => '씨티',
|
|
'33' => '우리',
|
|
'W1' => '우리',
|
|
'37' => '우체국',
|
|
'39' => '저축',
|
|
'35' => '전북',
|
|
'42' => '제주',
|
|
'15' => '카카오뱅크',
|
|
'3A' => '케이뱅크',
|
|
'24' => '토스뱅크',
|
|
'21' => '하나',
|
|
'61' => '현대',
|
|
'11' => 'KB국민',
|
|
'91' => 'NH농협',
|
|
'34' => 'Sh수협',
|
|
];
|
|
|
|
public function __construct(
|
|
private OrderProcessingService $orderService,
|
|
private PluginSettingsService $pluginSettingsService,
|
|
private TossPaymentsApiService $apiService,
|
|
) {}
|
|
|
|
/**
|
|
* 토스페이먼츠 결제 성공 콜백
|
|
*
|
|
* GET /plugins/sirsoft-tosspayments/payment/success
|
|
* ?paymentKey={PK}&orderId={OID}&amount={AMT}
|
|
*
|
|
* @param SuccessCallbackRequest $request 검증된 콜백 요청
|
|
* @return RedirectResponse SPA 페이지로 리다이렉트
|
|
*/
|
|
public function success(SuccessCallbackRequest $request): RedirectResponse
|
|
{
|
|
$validated = $request->validated();
|
|
$paymentKey = $validated['paymentKey'];
|
|
$orderId = $validated['orderId'];
|
|
$pgAmount = $validated['amount'];
|
|
|
|
try {
|
|
// 1. 주문 조회 (주문번호 기반)
|
|
$order = $this->orderService->findByOrderNumber($orderId);
|
|
|
|
if (! $order) {
|
|
Log::error('TossPayments: order not found', ['orderId' => $orderId]);
|
|
|
|
return redirect($this->resolveFailUrl(['error' => 'order_not_found', 'orderId' => $orderId]));
|
|
}
|
|
|
|
// 2. TossPayments Confirm API 호출
|
|
HookManager::doAction('sirsoft-tosspayments.payment.before_confirm', $order, $paymentKey, $pgAmount);
|
|
|
|
$pgResponse = $this->apiService->confirmPayment($paymentKey, $orderId, $pgAmount);
|
|
|
|
HookManager::doAction('sirsoft-tosspayments.payment.after_confirm', $order, $pgResponse);
|
|
|
|
// 3-a. 가상계좌 발급 — 아직 입금 전이므로 completePayment 하지 않고 계좌 정보만 저장한다.
|
|
// 실제 결제완료는 입금통보 웹훅(DEPOSIT_CALLBACK, status=DONE)에서 처리한다.
|
|
// 웹훅 secret 은 이 confirm 응답에만 내려오므로 payment_meta 에 저장해 대조에 쓴다.
|
|
if (($pgResponse['status'] ?? null) === 'WAITING_FOR_DEPOSIT') {
|
|
$this->handleVirtualAccountIssued($order, $pgResponse, $paymentKey, $request);
|
|
|
|
return redirect($this->resolveSuccessUrl($orderId));
|
|
}
|
|
|
|
// 3-b. 즉시 결제완료(카드/계좌이체/휴대폰/간편결제) — 기존 경로
|
|
$this->orderService->completePayment($order, [
|
|
'transaction_id' => $pgResponse['paymentKey'] ?? null,
|
|
'card_approval_number' => $pgResponse['card']['approveNo'] ?? null,
|
|
'card_number_masked' => $pgResponse['card']['number'] ?? null,
|
|
'card_name' => $this->resolveCardIssuer($pgResponse['card']['issuerCode'] ?? null),
|
|
'card_installment_months' => $pgResponse['card']['installmentPlanMonths'] ?? 0,
|
|
'is_interest_free' => $pgResponse['card']['isInterestFree'] ?? false,
|
|
'embedded_pg_provider' => $pgResponse['easyPay']['provider'] ?? null,
|
|
'receipt_url' => $pgResponse['receipt']['url'] ?? null,
|
|
'payment_meta' => [
|
|
'method' => $pgResponse['method'] ?? null,
|
|
'pg_raw_response' => $pgResponse,
|
|
],
|
|
'payment_device' => DeviceDetector::detect($request),
|
|
], $pgAmount);
|
|
|
|
// 4. SPA 주문 완료 페이지로 redirect
|
|
return redirect($this->resolveSuccessUrl($orderId));
|
|
|
|
} catch (PaymentAmountMismatchException $e) {
|
|
Log::error('TossPayments: amount mismatch', [
|
|
'orderId' => $orderId,
|
|
'expected' => $e->getExpectedAmount(),
|
|
'actual' => $e->getActualAmount(),
|
|
'context' => $e->getContext(),
|
|
]);
|
|
|
|
return redirect($this->resolveFailUrl([
|
|
'error' => 'amount_mismatch',
|
|
'orderId' => $orderId,
|
|
]));
|
|
|
|
} catch (\Exception $e) {
|
|
Log::error('TossPayments: confirm failed', [
|
|
'orderId' => $orderId,
|
|
'error' => $e->getMessage(),
|
|
'code' => $e->getCode(),
|
|
]);
|
|
|
|
return redirect($this->resolveFailUrl([
|
|
'error' => 'confirm_failed',
|
|
'message' => $e->getMessage(),
|
|
'orderId' => $orderId,
|
|
]));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 토스페이먼츠 결제 실패 콜백
|
|
*
|
|
* GET /plugins/sirsoft-tosspayments/payment/fail
|
|
* ?code={ERR}&message={MSG}&orderId={OID}
|
|
*
|
|
* @param FailCallbackRequest $request 검증된 콜백 요청
|
|
* @return RedirectResponse SPA 체크아웃 페이지로 리다이렉트
|
|
*/
|
|
public function fail(FailCallbackRequest $request): RedirectResponse
|
|
{
|
|
$validated = $request->validated();
|
|
$code = $validated['code'] ?? 'UNKNOWN';
|
|
$message = $validated['message'] ?? '';
|
|
$orderId = $validated['orderId'] ?? null;
|
|
|
|
Log::warning('TossPayments: payment failed', [
|
|
'code' => $code,
|
|
'message' => $message,
|
|
'orderId' => $orderId,
|
|
]);
|
|
|
|
if ($orderId) {
|
|
$order = $this->orderService->findByOrderNumber($orderId);
|
|
|
|
if ($order) {
|
|
$this->orderService->failPayment($order, $code, $message);
|
|
}
|
|
}
|
|
|
|
return redirect($this->resolveFailUrl([
|
|
'error' => $code,
|
|
'message' => $message,
|
|
'orderId' => $orderId,
|
|
]));
|
|
}
|
|
|
|
/**
|
|
* 가상계좌 발급 처리 — completePayment 없이 계좌 정보와 웹훅 secret 만 저장한다.
|
|
*
|
|
* 토스 confirm 응답의 status 가 WAITING_FOR_DEPOSIT 이면 호출된다. 실제 결제완료는
|
|
* 입금통보 웹훅(deposit)에서 처리한다. secret 은 이 응답에만 내려오므로 payment_meta 에
|
|
* 저장해 웹훅 위조 방지 대조(hash_equals)에 사용한다.
|
|
*
|
|
* @param Order $order 대상 주문
|
|
* @param array<string, mixed> $pgResponse 토스 confirm 응답
|
|
* @param string $paymentKey 토스 결제 키
|
|
* @param Request $request HTTP 요청 (디바이스 판별용)
|
|
*/
|
|
private function handleVirtualAccountIssued(Order $order, array $pgResponse, string $paymentKey, Request $request): void
|
|
{
|
|
$vbank = $pgResponse['virtualAccount'] ?? [];
|
|
|
|
$dueAt = null;
|
|
$dueDate = $vbank['dueDate'] ?? null;
|
|
if (is_string($dueDate) && $dueDate !== '') {
|
|
try {
|
|
$dueAt = Carbon::parse($dueDate);
|
|
} catch (\Exception) {
|
|
$dueAt = null;
|
|
}
|
|
}
|
|
|
|
// 에스크로 여부는 결제 시점 스냅샷 — 응답의 useEscrow 를 그대로 저장한다.
|
|
$isEscrow = (bool) ($vbank['useEscrow'] ?? $pgResponse['useEscrow'] ?? false);
|
|
|
|
$order->payment()->update(array_filter([
|
|
'pg_provider' => 'tosspayments',
|
|
'payment_status' => PaymentStatusEnum::WAITING_DEPOSIT->value,
|
|
'transaction_id' => $paymentKey ?: null,
|
|
'vbank_code' => $vbank['bankCode'] ?? null,
|
|
'vbank_name' => $vbank['bank'] ?? ($vbank['bankCode'] ?? null),
|
|
'vbank_number' => $vbank['accountNumber'] ?? null,
|
|
'vbank_holder' => $vbank['customerName'] ?? null,
|
|
'vbank_due_at' => $dueAt,
|
|
'vbank_issued_at' => Carbon::now(),
|
|
'is_escrow' => $isEscrow,
|
|
'payment_device' => DeviceDetector::detect($request),
|
|
'payment_meta' => [
|
|
'status' => 'WAITING_FOR_DEPOSIT',
|
|
'method' => $pgResponse['method'] ?? null,
|
|
// 웹훅 secret — DEPOSIT_CALLBACK 대조용 (이 응답에만 존재)
|
|
'toss_secret' => $pgResponse['secret'] ?? null,
|
|
'pg_raw_response' => $pgResponse,
|
|
],
|
|
], fn ($v) => $v !== null));
|
|
|
|
Log::info('TossPayments: virtual account issued', [
|
|
'orderId' => $order->order_number,
|
|
'paymentKey' => $paymentKey,
|
|
'vbank_number' => $vbank['accountNumber'] ?? null,
|
|
'vbank_due_at' => $dueAt?->toDateTimeString(),
|
|
'is_escrow' => $isEscrow,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* 카드 발급사 코드 → 이름 변환
|
|
*
|
|
* @param string|null $issuerCode 발급사 코드
|
|
* @return string|null 카드사명
|
|
*/
|
|
private function resolveCardIssuer(?string $issuerCode): ?string
|
|
{
|
|
if ($issuerCode === null) {
|
|
return null;
|
|
}
|
|
|
|
return self::CARD_ISSUER_MAP[$issuerCode] ?? $issuerCode;
|
|
}
|
|
|
|
/**
|
|
* 결제 성공 리다이렉트 URL 생성
|
|
*
|
|
* @param string $orderId 주문번호
|
|
* @return string 리다이렉트 URL
|
|
*/
|
|
private function resolveSuccessUrl(string $orderId): string
|
|
{
|
|
$settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
|
|
$urlTemplate = $settings['redirect_success_url'] ?? ShopRedirectUrl::DEFAULT_SUCCESS_URL;
|
|
|
|
return ShopRedirectUrl::resolve($urlTemplate, ['{orderId}' => $orderId]);
|
|
}
|
|
|
|
/**
|
|
* 결제 실패 리다이렉트 URL 생성
|
|
*
|
|
* @param array $queryParams 쿼리 파라미터
|
|
* @return string 리다이렉트 URL
|
|
*/
|
|
private function resolveFailUrl(array $queryParams = []): string
|
|
{
|
|
$settings = $this->pluginSettingsService->get(self::PLUGIN_IDENTIFIER) ?? [];
|
|
$baseUrl = ShopRedirectUrl::resolve($settings['redirect_fail_url'] ?? ShopRedirectUrl::DEFAULT_FAIL_URL);
|
|
|
|
if (empty($queryParams)) {
|
|
return $baseUrl;
|
|
}
|
|
|
|
$query = http_build_query(array_filter($queryParams));
|
|
$separator = str_contains($baseUrl, '?') ? '&' : '?';
|
|
|
|
return $baseUrl.$separator.$query;
|
|
}
|
|
|
|
/**
|
|
* 결제 디바이스 판별 (User-Agent 기반)
|
|
*
|
|
* @param Request $request HTTP 요청
|
|
* @return string 디바이스 유형 (pc/mobile)
|
|
*/
|
|
}
|