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 는 그대로 동작한다.
This commit is contained in:
HeuJung committed 2026-08-06 12:58:59 +09:00
1 parent a9f85ff92b
commit faa79b0ae1
95 files changed
+6637 -1372

No files matched your search

@@ -4,7 +4,7 @@ namespace Modules\Sirsoft\Ecommerce\Tests\Unit\Requests;
use Illuminate\Support\Facades\Validator;
use Modules\Sirsoft\Ecommerce\Http\Requests\Admin\StoreBanksRequest;
use Tests\TestCase;
use Modules\Sirsoft\Ecommerce\Tests\ModuleTestCase;
/**
* 은행 목록 저장 요청 검증 테스트
@@ -15,7 +15,7 @@ use Tests\TestCase;
* - 현재 로케일 은행명만 필수
* - 빈 배열 허용
*/
class StoreBanksRequestTest extends TestCase
class StoreBanksRequestTest extends ModuleTestCase
{
/**
* 은행명 검증은 "현재 앱 로케일" 필드만 필수로 본다. 테스트 데이터가 ko/en 을 제공하므로
@@ -30,12 +30,11 @@ class StoreBanksRequestTest extends TestCase
/**
* 검증 수행
*
* @param array $data 검증 대상 데이터
* @return \Illuminate\Validation\Validator
* @param array $data 검증 대상 데이터
*/
protected function validate(array $data): \Illuminate\Validation\Validator
{
$request = new StoreBanksRequest();
$request = new StoreBanksRequest;
return Validator::make($data, $request->rules());
}