Gnuboard7/plugins/_bundled/sirsoft-pay_kginicis/tests/Feature/Controllers/PaymentCallbackControllerTest.php

<?php

namespace Plugins\Sirsoft\PayKginicis\Tests\Feature\Controllers;

use App\Models\User;
use App\Services\PluginSettingsService;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;
use Modules\Sirsoft\Ecommerce\Database\Factories\OrderFactory;
use Modules\Sirsoft\Ecommerce\Database\Factories\OrderPaymentFactory;
use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
use Modules\Sirsoft\Ecommerce\Models\Order;
use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
use Plugins\Sirsoft\PayKginicis\Tests\PluginTestCase;

class PaymentCallbackControllerTest extends PluginTestCase
{
    private const TEST_MID = 'INIpayTest';

    private const TEST_SIGN_KEY = 'SU5JTElURV9UUklQTEVERVNfS0VZU1RS';

    /**
     * 애플리케이션 로그를 spy 로 감시하되 `activity` 채널은 실제 로거로 유지합니다.
     *
     * `Log::spy()` 단독 사용 시 `Log::channel('activity')` 가 null 을 반환하고,
     * 결제 완료 훅이 태우는 활동 로그가 null 에 `info()` 를 호출해 \Error 로 죽는다.
     * (`ResolvesActivityLogType::logActivity` 의 catch 는 \Exception 만 잡아 통과시킴)
     */
    private function spyApplicationLogKeepingActivityChannel(): void
    {
        $activityChannel = Log::channel('activity');

        Log::spy();
        Log::shouldReceive('channel')->with('activity')->andReturn($activityChannel);
    }

    private function makeAuthorizeResponse(string $tid, string $moid, int $amount, string $resultCode = '0000', array $overrides = []): array
    {
        return array_merge([
            'resultCode' => $resultCode,
            'resultMsg' => '성공',
            'tid' => $tid,
            'MOID' => $moid,
            'TotPrice' => (string) $amount,
            'payMethod' => 'Card',
            'applNum' => 'APP12345',
            'cardNum' => '4330-****-****-1234',
            'cardName' => '신한카드',
            'cardQuota' => '00',
            'applDate' => now()->format('YmdHis'),
            'buyerName' => '홍길동',
            'buyerEmail' => 'buyer@example.com',
            'buyerTel' => '01012345678',
        ], $overrides);
    }

    private function createTestOrder(int $totalAmount = 50000): Order
    {
        $user = User::factory()->create();

        $order = OrderFactory::new()->create([
            'user_id' => $user->id,
            'order_number' => 'ORD-TEST-'.random_int(10000, 99999),
            'order_status' => OrderStatusEnum::PENDING_ORDER,
            'currency' => 'KRW',
            'currency_snapshot' => self::krwCurrencySnapshot(),
            'subtotal_amount' => $totalAmount,
            'total_discount_amount' => 0,
            'total_coupon_discount_amount' => 0,
            'total_product_coupon_discount_amount' => 0,
            'total_order_coupon_discount_amount' => 0,
            'total_code_discount_amount' => 0,
            'base_shipping_amount' => 0,
            'extra_shipping_amount' => 0,
            'shipping_discount_amount' => 0,
            'total_shipping_amount' => 0,
            'total_amount' => $totalAmount,
            'total_due_amount' => $totalAmount,
            'total_points_used_amount' => 0,
            'total_deposit_used_amount' => 0,
            'total_paid_amount' => 0,
        ]);

        OrderPaymentFactory::new()->create([
            'order_id' => $order->id,
            'payment_status' => PaymentStatusEnum::READY,
            'payment_method' => PaymentMethodEnum::CARD,
            'pg_provider' => 'kginicis',
            'paid_amount_local' => 0,
            'paid_at' => null,
            'transaction_id' => null,
            'card_approval_number' => null,
        ]);

        return $order;
    }

    private function mockPluginSettings(array $overrides = []): void
    {
        $defaults = [
            'is_test_mode' => true,
            'test_mid' => self::TEST_MID,
            'test_sign_key' => self::TEST_SIGN_KEY,
            'test_iniapi_key' => 'ItEQKi3rY7uvDS8l',
            'test_iniapi_iv' => 'HYb3yQ4f65QL89==',
            'live_mid' => '',
            'live_sign_key' => '',
            'live_iniapi_key' => '',
            'live_iniapi_iv' => '',
            'redirect_success_url' => '/shop/orders/{orderId}/complete',
            'redirect_fail_url' => '/shop/checkout',
        ];

        $settingsMock = $this->createMock(PluginSettingsService::class);
        $settingsMock->method('get')
            ->willReturn(array_merge($defaults, $overrides));

        $this->app->instance(PluginSettingsService::class, $settingsMock);
    }

    private function makeCallbackParams(string $moid, int $totPrice, array $overrides = []): array
    {
        return array_merge([
            'resultCode' => '0000',
            'resultMsg' => '성공',
            'authToken' => 'AUTH_TOKEN_'.uniqid(),
            'authUrl' => 'https://fcstdpay.inicis.com/api/payAuth',
            // idc_name 은 KG 이니시스가 success 콜백에 항상 포함시키는 IDC 식별자.
            // 컨트롤러가 isValidIdcAuthUrl 화이트리스트 검증에 사용 (SSRF 방어).
            'idc_name' => 'fc',
            'netCancelUrl' => 'https://stginiapi.inicis.com/api/v1/netcancel',
            'MOID' => $moid,
            'TotPrice' => $totPrice,
        ], $overrides);
    }

    // ===== 성공 콜백 테스트 =====

    public function test_auth_callback_redirects_to_complete_page_on_valid_payment(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $tid = 'TID_'.uniqid();
        $params = $this->makeCallbackParams($order->order_number, 50000);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response(
                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
                200
            ),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");

        $order->refresh();
        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);

        $payment = $order->payment;
        $payment->refresh();
        $this->assertEquals($tid, $payment->transaction_id);
        $this->assertEquals('APP12345', $payment->card_approval_number);

        $meta = $payment->payment_meta;
        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
        $this->assertSame($tid, $meta['pg_raw_response']['tid'] ?? null);
        $this->assertArrayNotHasKey('cardNum', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('buyerName', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('buyerEmail', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('buyerTel', $meta['pg_raw_response']);
    }

    public function test_auth_callback_stores_selected_easy_pay_context(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $tid = 'TID_EASYPAY_'.uniqid();
        $params = $this->makeCallbackParams($order->order_number, 50000);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response(
                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
                200
            ),
        ]);

        $response = $this->post(
            '/plugins/sirsoft-pay_kginicis/payment/callback?selectedPaymentMethod=kginicis_naverpay',
            $params,
        );

        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");

        $payment = $order->payment;
        $payment->refresh();

        $this->assertSame('naverpay', $payment->embedded_pg_provider);

        $meta = $payment->payment_meta;
        $this->assertSame('kginicis_naverpay', $meta['selected_payment_method'] ?? null);
        $this->assertSame('naverpay', $meta['embedded_pg_provider'] ?? null);
        $this->assertSame('네이버페이', $meta['embedded_pg_provider_label'] ?? null);
    }

    public function test_auth_callback_user_cancel_2001_redirects_without_error_query(): void
    {
        // 사용자가 결제창을 X 또는 '취소' 버튼으로 종료한 경우 — 에러 토스트 노출 X.
        // NHN KCP 의 CANCEL_RES_CODES 패턴과 동일하게 조용히 체크아웃으로 복귀.
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams('ORD-TEST-99999', 50000, [
            'resultCode' => '2001',
            'resultMsg' => '사용자가 취소를 요청하였습니다.',
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect();
        $location = $response->headers->get('Location');
        $this->assertStringNotContainsString('error=', $location, 'user cancel must not append error query');
        $this->assertStringNotContainsString('message=', $location, 'user cancel must not append message query');
    }

    public function test_auth_callback_user_cancel_message_keyword_redirects_without_error_query(): void
    {
        // resultCode 가 표준 cancel 코드가 아니지만 resultMsg 에 '취소' 키워드가
        // 포함된 경우도 사용자 취소로 간주 (KG 이니시스 버전별 코드 차이 대응).
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams('ORD-TEST-99999', 50000, [
            'resultCode' => '9998',
            'resultMsg' => '사용자가 결제를 취소하였습니다.',
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect();
        $this->assertStringNotContainsString('error=', $response->headers->get('Location'));
    }

    public function test_auth_callback_real_failure_still_redirects_with_error_query(): void
    {
        // 사용자 취소가 아닌 실제 결제 실패는 기존대로 error query 포함하여
        // 사용자에게 에러 토스트 노출.
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams('ORD-TEST-99999', 50000, [
            'resultCode' => '9999',
            'resultMsg' => 'PG 시스템 오류',
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect();
        $this->assertStringContainsString('error=9999', $response->headers->get('Location'));
    }

    public function test_auth_callback_redirects_to_fail_on_order_not_found(): void
    {
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams('NON_EXISTENT_ORDER', 50000);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response(
                $this->makeAuthorizeResponse('TID_NONE', 'NON_EXISTENT_ORDER', 50000),
                200
            ),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect();
        $this->assertStringContainsString('error=order_not_found', $response->headers->get('Location'));
    }

    public function test_auth_callback_redirects_to_fail_on_pg_result_code_not_0000(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams($order->order_number, 50000);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response([
                'resultCode' => '9999',
                'resultMsg' => '승인 실패',
            ], 200),
        ]);

        $statusBefore = $order->order_status;

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect();
        $this->assertStringContainsString('error=9999', $response->headers->get('Location'));

        // 계약 변경(KVE-2026-2018 형제): 승인이 성립하지 않은 비인증 브라우저 콜백은
        // 주문 상태를 바꾸지 않는다. 정당한 결제창 닫힘은 close-report 가 기록한다.
        $order->refresh();
        $this->assertEquals($statusBefore, $order->order_status, '비인증 콜백이 주문 상태를 바꿨습니다.');
        $this->assertNotEquals(OrderStatusEnum::CANCELLED, $order->order_status);
    }

    /**
     * 무인증 위조 콜백으로 타인의 결제대기 주문을 취소할 수 없다.
     *
     * 공격자는 로그인하지 않고 피해자의 주문번호(moid)와 위조 authToken 만으로 이 엔드포인트를
     * 친다. 서버 승인은 당연히 실패하는데, 그 실패를 주문 실패로 오인 처리하면 남의 주문이 취소된다.
     */
    public function test_forged_unauthenticated_callback_cannot_cancel_another_users_order(): void
    {
        $victimOrder = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams($victimOrder->order_number, 50000);
        $params['authToken'] = 'FORGED_AUTH_TOKEN';

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response([
                'resultCode' => '9999',
                'resultMsg' => '인증정보가 올바르지 않습니다',
            ], 200),
            '*' => Http::response('OK', 200),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect();

        $victimOrder->refresh();
        $this->assertEquals(
            OrderStatusEnum::PENDING_ORDER,
            $victimOrder->order_status,
            '무인증 위조 콜백이 피해자의 주문을 취소시켰습니다.'
        );
        $this->assertArrayNotHasKey('payment_failure_code', $victimOrder->order_meta ?? []);
    }

    public function test_auth_callback_sends_net_cancel_and_redirects_to_fail_on_authorize_http_error(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams($order->order_number, 50000);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response(null, 500),
            'stginiapi.inicis.com/api/v1/netcancel' => Http::response('OK', 200),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect();
        $this->assertStringContainsString('error=authorize_failed', $response->headers->get('Location'));
    }

    public function test_auth_callback_skips_net_cancel_when_local_payment_was_already_completed_before_exception(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $tid = 'TID_POST_COMMIT_'.uniqid();
        $params = $this->makeCallbackParams($order->order_number, 50000);

        $orderService = $this->createMock(OrderProcessingService::class);
        $orderService->method('findByOrderNumber')
            ->with($order->order_number)
            ->willReturn($order);
        $orderService->expects($this->once())
            ->method('completePayment')
            ->willReturnCallback(function (Order $callbackOrder, array $paymentData, ?int $paidAmount) use ($tid): void {
                DB::transaction(function () use ($callbackOrder, $paymentData, $paidAmount, $tid): void {
                    $callbackOrder->forceFill([
                        'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
                        'total_paid_amount' => $paidAmount,
                        'total_due_amount' => 0,
                        'paid_at' => now(),
                    ])->save();

                    $callbackOrder->payment()->update([
                        'payment_status' => PaymentStatusEnum::PAID,
                        'transaction_id' => $tid,
                        'card_approval_number' => $paymentData['card_approval_number'] ?? null,
                        'payment_meta' => $paymentData['payment_meta'] ?? [],
                        'paid_amount_local' => $paidAmount,
                        'paid_at' => now(),
                    ]);
                });

                throw new \RuntimeException('post commit hook failed');
            });
        $this->app->instance(OrderProcessingService::class, $orderService);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response(
                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
                200
            ),
            'stginiapi.inicis.com/api/v1/netcancel' => Http::response('OK', 200),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");

        Http::assertNotSent(static fn ($request): bool => str_contains((string) $request->url(), 'netcancel'));

        $order->refresh();
        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);

        $payment = $order->payment->fresh();
        $this->assertEquals(PaymentStatusEnum::PAID, $payment->payment_status);
        $this->assertSame($tid, $payment->transaction_id);
    }

    public function test_auth_callback_redirects_to_fail_on_missing_params(): void
    {
        $this->mockPluginSettings();

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', [
            'resultCode' => '0000',
        ]);

        $response->assertRedirect();
        $this->assertStringContainsString('error=invalid_params', $response->headers->get('Location'));
    }

    public function test_auth_callback_redirects_to_custom_success_url(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings(['redirect_success_url' => '/custom/payment/{orderId}/done']);

        $tid = 'TID_CUSTOM';
        $params = $this->makeCallbackParams($order->order_number, 50000);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response(
                $this->makeAuthorizeResponse($tid, $order->order_number, 50000),
                200
            ),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/callback', $params);

        $response->assertRedirect("/custom/payment/{$order->order_number}/done");
    }

    public function test_auth_callback_detects_mobile_device(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $params = $this->makeCallbackParams($order->order_number, 50000);

        Http::fake([
            'fcstdpay.inicis.com/api/payAuth' => Http::response(
                $this->makeAuthorizeResponse('TID_MOBILE', $order->order_number, 50000),
                200
            ),
        ]);

        $response = $this->post(
            '/plugins/sirsoft-pay_kginicis/payment/callback',
            $params,
            ['User-Agent' => 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X)']
        );

        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");

        $payment = $order->payment;
        $payment->refresh();
        $this->assertEquals('mobile', $payment->payment_device);
    }

    // ===== 가상계좌 입금 통보 테스트 =====

    public function test_vbank_notify_returns_ok_on_successful_deposit(): void
    {
        $order = $this->createTestOrder(30000);
        $this->markVbankIssued($order, 'VBANK_TID_SUCCESS', '1234567890');
        $this->mockPluginSettings();

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/vbank-notify', $this->makeVbankNotifyPayload([
            'no_tid' => 'VBANK_TID_SUCCESS',
            'no_oid' => $order->order_number,
            'amt_input' => '30000',
        ]));

        $response->assertOk();
        $this->assertEquals('OK', $response->getContent());

        $order->refresh();
        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);

        $payment = $order->payment;
        $payment->refresh();
        $meta = $payment->payment_meta;
        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
        $this->assertSame('1234567890', $meta['vbank_num'] ?? null);
        $this->assertSame('홍길동', $meta['depositor_name'] ?? null);
        $this->assertArrayHasKey('no_tid', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('no_vacct', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('nm_input', $meta['pg_raw_response']);
    }

    public function test_vbank_notify_rejects_unissued_or_mismatched_account_context(): void
    {
        $order = $this->createTestOrder(30000);
        $this->markVbankIssued($order, 'VBANK_TID_ISSUED', '1234567890');
        $this->mockPluginSettings();

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/vbank-notify', $this->makeVbankNotifyPayload([
            'no_tid' => 'VBANK_TID_ATTACKER',
            'no_oid' => $order->order_number,
            'no_vacct' => '9999999999',
            'amt_input' => '30000',
        ]));

        $response->assertOk();
        $this->assertSame('FAIL', $response->getContent());

        $order->refresh();
        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
        $this->assertEquals(PaymentStatusEnum::WAITING_DEPOSIT, $order->payment->fresh()->payment_status);
    }

    public function test_vbank_notify_does_not_write_depositor_name_to_application_log(): void
    {
        $order = $this->createTestOrder(30000);
        $this->markVbankIssued($order, 'VBANK_TID_LOG', '1234567890');
        $this->mockPluginSettings();

        $this->spyApplicationLogKeepingActivityChannel();

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/vbank-notify', $this->makeVbankNotifyPayload([
            'no_tid' => 'VBANK_TID_LOG',
            'no_oid' => $order->order_number,
            'amt_input' => '30000',
            'nm_input' => '홍길동',
        ]));

        $response->assertOk();

        Log::shouldHaveReceived('info')
            ->with('KG Inicis: PC vbank deposit notify received', \Mockery::on(function (array $context): bool {
                return ! array_key_exists('depositor', $context);
            }))
            ->once();
    }

    public function test_mobile_callback_stores_sanitized_pg_response_only(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $tid = 'MOBILE_TID_'.uniqid();

        Http::fake([
            'fcmobile.inicis.com/smart/payReq.ini' => Http::response(http_build_query([
                'P_STATUS' => '00',
                'P_RMESG1' => '성공',
                'P_TID' => $tid,
                'P_OID' => $order->order_number,
                'P_AMT' => '50000',
                'P_TYPE' => 'CARD',
                'P_AUTH_DT' => now()->format('YmdHis'),
                'P_APPL_NUM' => 'MAPP123',
                'P_CARD_NUM' => '4330-****-****-1234',
                'P_CARD_ISSUER_NAME' => '신한카드',
                'P_CARD_QUOTA' => '00',
                'P_UNAME' => '홍길동',
                'P_EMAIL' => 'buyer@example.com',
                'P_MOBILE' => '01012345678',
            ]), 200),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/mobile/callback?'.http_build_query([
            'orderId' => $order->order_number,
            'selectedPaymentMethod' => 'kginicis_naverpay',
        ]), [
            'P_STATUS' => '00',
            'P_TID' => $tid,
            'P_REQ_URL' => 'https://fcmobile.inicis.com/smart/payReq.ini',
            'P_AMT' => '50000',
            'P_OID' => $order->order_number,
            'idc_name' => 'fc',
        ]);

        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");

        $payment = $order->payment;
        $payment->refresh();

        $this->assertEquals($tid, $payment->transaction_id);
        $this->assertEquals('MAPP123', $payment->card_approval_number);
        $this->assertEquals('4330-****-****-1234', $payment->card_number_masked);
        $this->assertSame('naverpay', $payment->embedded_pg_provider);

        $meta = $payment->payment_meta;
        $this->assertTrue($meta['pg_response_sanitized'] ?? false);
        $this->assertSame('kginicis_naverpay', $meta['selected_payment_method'] ?? null);
        $this->assertSame('naverpay', $meta['embedded_pg_provider'] ?? null);
        $this->assertSame('네이버페이', $meta['embedded_pg_provider_label'] ?? null);
        $this->assertSame($tid, $meta['pg_raw_response']['P_TID'] ?? null);
        $this->assertArrayNotHasKey('P_CARD_NUM', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('P_UNAME', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('P_EMAIL', $meta['pg_raw_response']);
        $this->assertArrayNotHasKey('P_MOBILE', $meta['pg_raw_response']);
    }

    public function test_mobile_callback_skips_auto_cancel_when_local_payment_was_already_completed_before_exception(): void
    {
        $order = $this->createTestOrder(50000);
        $this->mockPluginSettings();

        $tid = 'MOBILE_TID_POST_COMMIT_'.uniqid();

        $orderService = $this->createMock(OrderProcessingService::class);
        $orderService->method('findByOrderNumber')
            ->with($order->order_number)
            ->willReturn($order);
        $orderService->expects($this->once())
            ->method('completePayment')
            ->willReturnCallback(function (Order $callbackOrder, array $paymentData, ?int $paidAmount) use ($tid): void {
                DB::transaction(function () use ($callbackOrder, $paymentData, $paidAmount, $tid): void {
                    $callbackOrder->forceFill([
                        'order_status' => OrderStatusEnum::PAYMENT_COMPLETE,
                        'total_paid_amount' => $paidAmount,
                        'total_due_amount' => 0,
                        'paid_at' => now(),
                    ])->save();

                    $callbackOrder->payment()->update([
                        'payment_status' => PaymentStatusEnum::PAID,
                        'transaction_id' => $tid,
                        'card_approval_number' => $paymentData['card_approval_number'] ?? null,
                        'payment_meta' => $paymentData['payment_meta'] ?? [],
                        'paid_amount_local' => $paidAmount,
                        'paid_at' => now(),
                    ]);
                });

                throw new \RuntimeException('mobile post commit hook failed');
            });
        $this->app->instance(OrderProcessingService::class, $orderService);

        Http::fake([
            'fcmobile.inicis.com/smart/payReq.ini' => Http::response(http_build_query([
                'P_STATUS' => '00',
                'P_RMESG1' => '성공',
                'P_TID' => $tid,
                'P_OID' => $order->order_number,
                'P_AMT' => '50000',
                'P_TYPE' => 'CARD',
                'P_AUTH_DT' => now()->format('YmdHis'),
                'P_APPL_NUM' => 'MAPP999',
            ]), 200),
            'stginiapi.inicis.com/api/v1/refund' => Http::response(['resultCode' => '00'], 200),
        ]);

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/mobile/callback', [
            'P_STATUS' => '00',
            'P_TID' => $tid,
            'P_REQ_URL' => 'https://fcmobile.inicis.com/smart/payReq.ini',
            'P_AMT' => '50000',
            'P_OID' => $order->order_number,
            'idc_name' => 'fc',
        ]);

        $response->assertRedirect("/shop/orders/{$order->order_number}/complete");

        Http::assertNotSent(static fn ($request): bool => str_contains((string) $request->url(), '/v2/pg/refund'));

        $order->refresh();
        $this->assertEquals(OrderStatusEnum::PAYMENT_COMPLETE, $order->order_status);

        $payment = $order->payment->fresh();
        $this->assertEquals(PaymentStatusEnum::PAID, $payment->payment_status);
        $this->assertSame($tid, $payment->transaction_id);
    }

    public function test_mobile_vbank_notify_rejects_unissued_or_mismatched_account_context(): void
    {
        $order = $this->createTestOrder(30000);
        $this->markVbankIssued($order, 'MOBILE_VBANK_TID_ISSUED', '1234567890');
        $this->mockPluginSettings();

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/mobile/vbank-notify', [
            'P_STATUS' => '02',
            'P_TYPE' => 'VBANK',
            'P_TID' => 'MOBILE_VBANK_TID_ATTACKER',
            'P_MID' => self::TEST_MID,
            'P_OID' => $order->order_number,
            'P_AMT' => '30000',
            'P_AUTH_DT' => now()->format('YmdHis'),
            'P_FN_CD1' => '04',
            'P_FN_NM' => '국민은행',
            'P_RMESG1' => '9999999999|20260630235959',
            'P_UNAME' => '홍길동',
        ]);

        $response->assertOk();
        $this->assertSame('FAIL', $response->getContent());

        $order->refresh();
        $this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
        $this->assertEquals(PaymentStatusEnum::WAITING_DEPOSIT, $order->payment->fresh()->payment_status);
    }

    public function test_mobile_vbank_notify_does_not_write_depositor_name_to_application_log(): void
    {
        $order = $this->createTestOrder(30000);
        $this->markVbankIssued($order, 'MOBILE_VBANK_TID_LOG', '1234567890');
        $this->mockPluginSettings();

        $this->spyApplicationLogKeepingActivityChannel();

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/mobile/vbank-notify', [
            'P_STATUS' => '02',
            'P_TYPE' => 'VBANK',
            'P_TID' => 'MOBILE_VBANK_TID_LOG',
            'P_MID' => self::TEST_MID,
            'P_OID' => $order->order_number,
            'P_AMT' => '30000',
            'P_AUTH_DT' => now()->format('YmdHis'),
            'P_FN_CD1' => '04',
            'P_FN_NM' => '국민은행',
            'P_RMESG1' => '1234567890|20260630235959',
            'P_UNAME' => '홍길동',
        ]);

        $response->assertOk();

        Log::shouldHaveReceived('info')
            ->with('KG Inicis: mobile vbank deposit notify received', \Mockery::on(function (array $context): bool {
                return ! array_key_exists('depositor', $context);
            }))
            ->once();
    }

    /**
     * 동일 TID 가 두 번 통보되어도 중복 결제 처리하지 않고 OK 반환 (replay 방어).
     */
    public function test_vbank_notify_is_idempotent_on_duplicate_tid(): void
    {
        $order = $this->createTestOrder(30000);
        $this->markVbankIssued($order, 'VBANK_TID_DUP', '1234567890');
        $this->mockPluginSettings();

        $payload = $this->makeVbankNotifyPayload([
            'no_tid' => 'VBANK_TID_DUP',
            'no_oid' => $order->order_number,
            'amt_input' => '30000',
        ]);

        $this->post('/plugins/sirsoft-pay_kginicis/payment/vbank-notify', $payload)->assertOk();
        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/vbank-notify', $payload);

        $response->assertOk();
        $this->assertEquals('OK', $response->getContent(), '재처리 요청도 OK 반환 (replay 방어)');
    }

    public function test_vbank_notify_returns_fail_on_order_not_found(): void
    {
        $this->mockPluginSettings();

        $response = $this->post('/plugins/sirsoft-pay_kginicis/payment/vbank-notify', $this->makeVbankNotifyPayload([
            'no_oid' => 'NON_EXISTENT_ORDER',
        ]));

        $response->assertOk();
        $this->assertEquals('FAIL', $response->getContent());
    }

    /**
     * KG 이니시스 PC 가상계좌 입금통보 페이로드 빌더.
     *
     * 공식 매뉴얼 https://manual.inicis.com/pay/etc-noti.html#pc 의 필드명을 사용한다.
     * 테스트마다 일부 필드만 override 하기 위한 헬퍼.
     *
     * @param  array  $overrides  필드 override
     * @return array 입금통보 페이로드
     */
    private function makeVbankNotifyPayload(array $overrides = []): array
    {
        return array_merge([
            'no_tid' => 'VBANK_TID_'.uniqid(),
            'no_oid' => 'ORD-TEST-VBANK',
            'id_merchant' => 'INIpayTest',
            'dt_trans' => now()->format('Ymd'),
            'tm_trans' => now()->format('His'),
            'cd_bank' => '04',
            'no_vacct' => '1234567890',
            'amt_input' => '30000',
            'nm_inputbank' => '국민은행',
            'nm_input' => '홍길동',
        ], $overrides);
    }

    private function markVbankIssued(Order $order, string $tid, string $vbankNumber): void
    {
        $order->payment()->update([
            'payment_status' => PaymentStatusEnum::WAITING_DEPOSIT,
            'payment_method' => PaymentMethodEnum::VBANK,
            'transaction_id' => $tid,
            'vbank_number' => $vbankNumber,
            'payment_meta' => [
                'pay_method' => 'VBank',
                'mid' => self::TEST_MID,
                'is_test_mode' => true,
            ],
        ]);
    }
}