Files
Gnuboard7/plugins/_bundled/sirsoft-pay_kginicis/tests/Unit/Concerns/ValidatesTimestampFreshnessTest.php
T
HeuJung faa79b0ae1 feat(tosspayments,pay_kginicis,ecommerce,core): 현금영수증 프로바이더 훅 축 + 토스 환불 정합성
현금영수증 발급사를 PG 결제사와 독립적으로 선택할 수 있도록 공용 훅 축
(registered_providers/issue/cancel)에 토스·KG 프로바이더를 등록한다. KG 결제로
받으면서 영수증만 토스로 발급하는 구성이 가능해진다. KG 전용 발행 컨트롤러·
라우트·관리자 패널은 이 축으로 이전하며 제거했다 — 이중 발행 경로를 남기지
않기 위해서다.

토스 환불은 네 가지를 바로잡았다. 전액취소를 부분취소로 보내던 문제(R1),
면세금액 미전달로 복합과세 상점의 부가세가 틀어지던 문제(R2), 가상계좌
환불계좌를 싣지 않아 취소가 실패하던 문제(R3), 에스크로 부분취소를 PG 호출
전에 차단하지 않던 문제(E4). 취소·발급 요청에는 멱등키를 부착해 네트워크
재시도가 국세청에 이중 신고되거나 이중 환불되는 것을 막는다.

코어 활동로그 가드가 \Exception 만 잡아 채널 해석 실패(\Error)를 놓치고 있었다.
결제 입금통보 같은 외부 콜백이 로그 문제만으로 500을 반환하던 문제를 \Throwable
로 수정한다. 활동로그는 부수 기록이므로 그것을 유발한 요청까지 죽여서는 안 된다.

토스 API 서비스는 베이스 \Exception 을 직접 던지고 있어 도메인 예외
(TossPaymentsApiException)를 신설했다. KG의 KgInicisApiException 선례와 동형이며
RuntimeException 상속이라 기존 소비자의 catch 는 그대로 동작한다.
2026-08-06 12:58:59 +09:00

140 lines
4.8 KiB
PHP

<?php
namespace Plugins\Sirsoft\PayKginicis\Tests\Unit\Concerns;
use Carbon\Carbon;
use Plugins\Sirsoft\PayKginicis\Concerns\ValidatesTimestampFreshness;
use Plugins\Sirsoft\PayKginicis\Tests\PluginTestCase;
/**
* Signature replay 방어용 timestamp 신선도 검증 트레이트 단위 테스트.
*
* 검증 범위:
* - 14자리 yyyyMMddHHmmss (CBT 표준)
* - 13자리 epoch ms (PC/모바일 표준)
* - ±300초 윈도우 내부는 fresh, 이외는 stale
* - 잘못된 포맷은 거부
*/
class ValidatesTimestampFreshnessTest extends PluginTestCase
{
private object $subject;
protected function setUp(): void
{
parent::setUp();
$this->subject = new class
{
use ValidatesTimestampFreshness {
isTimestampFresh as public;
}
};
}
public function test_current_yyyy_mm_dd_hh_mm_ss_is_fresh(): void
{
$ts = Carbon::now()->format('YmdHis');
$this->assertTrue($this->subject->isTimestampFresh($ts));
}
public function test_current_epoch_ms_is_fresh(): void
{
$ts = (string) (Carbon::now()->getTimestamp() * 1000);
$this->assertTrue($this->subject->isTimestampFresh($ts));
}
public function test_5_minutes_ago_is_at_window_boundary(): void
{
// 정확히 300초 — 경계값. 라운딩 흡수 위해 299s 사용
$ts = Carbon::now()->subSeconds(299)->format('YmdHis');
$this->assertTrue($this->subject->isTimestampFresh($ts));
}
public function test_6_minutes_ago_is_stale(): void
{
$ts = Carbon::now()->subSeconds(360)->format('YmdHis');
$this->assertFalse($this->subject->isTimestampFresh($ts));
}
public function test_1_hour_ago_yyyy_mm_dd_hh_mm_ss_is_stale(): void
{
$ts = Carbon::now()->subHour()->format('YmdHis');
$this->assertFalse($this->subject->isTimestampFresh($ts));
}
public function test_1_hour_ago_epoch_ms_is_stale(): void
{
$ts = (string) ((Carbon::now()->getTimestamp() - 3600) * 1000);
$this->assertFalse($this->subject->isTimestampFresh($ts));
}
public function test_future_timestamp_beyond_window_is_stale(): void
{
$ts = Carbon::now()->addSeconds(600)->format('YmdHis');
$this->assertFalse($this->subject->isTimestampFresh($ts));
}
public function test_future_within_window_is_fresh(): void
{
$ts = Carbon::now()->addSeconds(60)->format('YmdHis');
$this->assertTrue($this->subject->isTimestampFresh($ts));
}
public function test_empty_string_is_stale(): void
{
$this->assertFalse($this->subject->isTimestampFresh(''));
}
public function test_non_numeric_is_stale(): void
{
$this->assertFalse($this->subject->isTimestampFresh('abc'));
}
public function test_invalid_yyyy_mm_dd_hh_mm_ss_is_stale(): void
{
// 14자리이지만 잘못된 날짜 (월 13)
$this->assertFalse($this->subject->isTimestampFresh('20261399000000'));
}
public function test_short_numeric_is_stale(): void
{
// 12자리 — 13/14자리 어느 포맷도 아님
$this->assertFalse($this->subject->isTimestampFresh('123456789012'));
}
public function test_15_digits_is_stale(): void
{
$this->assertFalse($this->subject->isTimestampFresh('123456789012345'));
}
/**
* 회귀: 클라이언트가 Asia/Seoul 로컬 시각으로 14자리 타임스탬프를 생성하고
* 서버가 UTC 로 동작할 때 freshness 가 올바르게 판정되어야 한다.
*
* 기존 코드는 Carbon::createFromFormat('YmdHis', $ts) 가 default timezone
* (= app.timezone, 보통 UTC) 으로 파싱하여 KST 클라이언트 → 9시간 차이
* → 항상 stale 로 잘못 판정하던 버그.
*
* 수정 후: 14자리 포맷은 명시적으로 Asia/Seoul 로 파싱하여 gnuboard5
* date('YmdHis') 컨벤션과 정합.
*/
public function test_current_kst_timestamp_is_fresh_when_app_is_utc(): void
{
// 프로덕션 Laravel 은 app.timezone=UTC 로 date_default_timezone_set('UTC') 를
// 호출. PHP CLI 기본 TZ 가 다를 수 있어 명시적으로 UTC 강제하여 환경 시뮬레이션.
$originalTz = date_default_timezone_get();
date_default_timezone_set('UTC');
try {
// 클라이언트가 KST 로 생성한 14자리 timestamp
$kstNow = Carbon::now('UTC')->setTimezone('Asia/Seoul')->format('YmdHis');
$this->assertTrue(
$this->subject->isTimestampFresh($kstNow),
'KST timestamp from client must be valid on UTC server (gnuboard5 date(YmdHis) 컨벤션)'
);
} finally {
date_default_timezone_set($originalTz);
}
}
}