Files
Gnuboard7/plugins/_bundled/sirsoft-pay_nhnkcp/src/Controllers/AdminEscrowDeliveryController.php
T
HeuJung 7f457a05b3 fix(core,board,page,ecommerce,basic,pay): FULLTEXT 게이트·검색 실패 표면화와 페이지네이션/접두사 결함 정비
- 공개 : MATCH 는 커버 인덱스가 있을 때만 조립 — 부재 시 LIKE 폴백 + 1회 경고,
 카테고리 검색 예외를 categories_failed/search_failed 로 표면화하고 basic 템플릿이 오류 안내 렌더
- 공개 동근원: paginate page 명시 전달 (언어팩 check-updates, 상품 문의 목록)
- 공개 동근원: raw SQL 접두사/별칭 하드코딩 정리 (board 시더, 7.0.6 업그레이드 스텝,
 결제 3플러그인 컨트롤러 51지점 모델 파생 전환)
- audit 룰 3종 신설 + repository-raw-hardcoded-table 컨트롤러 확대, 확장 TestCase
 오토로더 중복 선언 가드 16지점, ja 언어팩 동기
2026-08-17 03:02:26 +09:00

216 lines
7.6 KiB
PHP

<?php
declare(strict_types=1);
namespace Plugins\Sirsoft\PayNhnkcp\Controllers;
// audit:allow api-doc-coverage 요청 파라미터·응답 구조 무변경 — 테이블명 리터럴을 모델 파생으로 정리한 내부 리팩토링 (#571)
use App\Helpers\ResponseHelper;
use App\Http\Controllers\Api\Base\AdminBaseController;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Modules\Sirsoft\Ecommerce\Models\Order;
use Modules\Sirsoft\Ecommerce\Models\OrderAddress;
use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
use Plugins\Sirsoft\PayNhnkcp\Concerns\SanitizesPgResponse;
use Plugins\Sirsoft\PayNhnkcp\Services\NhnKcpApiService;
/**
* KCP 에스크로 배송등록 관리자 컨트롤러
*
* 에스크로 결제 후 상품 발송 시 KCP에 운송장번호를 등록합니다.
* CLI mod_type=STE1 방식으로 배송정보를 전달합니다.
*/
class AdminEscrowDeliveryController extends AdminBaseController
{
use SanitizesPgResponse;
private const ESCROW_DELIVERY_RESPONSE_KEYS = [
'res_cd',
'res_msg',
'tno',
'deli_numb',
'deli_corp',
];
/** KCP 에스크로 택배사 코드표 */
private const COURIER_CODES = [
'04' => 'CJ대한통운',
'05' => '한진택배',
'06' => '로젠택배',
'08' => '롯데택배',
'09' => '우체국택배',
'11' => '경동택배',
'13' => '일양로지스',
'14' => '합동택배',
'20' => '드림택배',
'23' => '천일택배',
'26' => '건영택배',
'40' => '기타',
];
public function __construct(
private readonly NhnKcpApiService $apiService,
) {
parent::__construct();
}
/**
* 배송등록 폼 데이터 반환 (주소 자동완성 및 기등록 배송 이력 포함)
*/
/**
* 에스크로 배송 등록 폼 초기 데이터 조회
*
* 어드민 에스크로 배송 등록 화면에서 주문 정보 + 기본 배송지/수령인을 미리 채울 수 있도록 반환.
*
* @param string $orderNumber 주문번호
* @return JsonResponse 폼 초기 데이터 또는 404
*/
public function formData(string $orderNumber): JsonResponse
{
$payment = $this->findEscrowPayment($orderNumber);
if (! $payment) {
return ResponseHelper::success('common.success', null);
}
$address = DB::table((new OrderAddress)->getTable().' as a')
->join((new Order)->getTable().' as o', 'o.id', '=', 'a.order_id')
->where('o.order_number', $orderNumber)
->where('a.address_type', 'shipping')
->select([
'a.recipient_name',
'a.recipient_phone',
'a.zipcode',
'a.address',
'a.address_detail',
])
->first();
$meta = $payment->payment_meta ? json_decode($payment->payment_meta, true) : [];
$escrowDelivery = $meta['escrow_delivery'] ?? null;
return ResponseHelper::success('common.success', [
'has_escrow_payment' => true,
'tno' => $payment->transaction_id,
'courier_codes' => self::COURIER_CODES,
'prefill' => [
'recv_name' => $address?->recipient_name ?? '',
'recv_tel' => $address?->recipient_phone ?? '',
'recv_post' => $address?->zipcode ?? '',
'recv_addr' => trim(($address?->address ?? '').' '.($address?->address_detail ?? '')),
],
'registered_delivery' => $escrowDelivery,
]);
}
/**
* KCP에 배송정보 등록 (CLI mod_type=STE1)
*/
/**
* 에스크로 배송 등록 API 호출
*
* KCP 에스크로 API 로 배송 정보(택배사/송장번호/수령인 등) 등록. 등록 완료 시 구매확정 안내 자동 발송.
*
* @param Request $request 배송 정보 폼
* @param string $orderNumber 주문번호
* @return JsonResponse 등록 결과
*/
public function register(Request $request, string $orderNumber): JsonResponse
{
$deliNumb = trim((string) $request->input('deli_numb', ''));
$deliCorp = trim((string) $request->input('deli_corp', ''));
if ($deliNumb === '') {
return ResponseHelper::error('common.failed', 422, ['deli_numb' => ['운송장번호를 입력해주세요.']]);
}
if ($deliCorp === '' || ! array_key_exists($deliCorp, self::COURIER_CODES)) {
return ResponseHelper::error('common.failed', 422, ['deli_corp' => ['택배사를 선택해주세요.']]);
}
$payment = $this->findEscrowPayment($orderNumber);
if (! $payment) {
return ResponseHelper::error('common.failed', 404, null);
}
Log::info('KCP: escrow delivery register requested', [
'order_number' => $orderNumber,
'tno' => $payment->transaction_id,
'deli_numb' => $deliNumb,
'deli_corp' => $deliCorp,
]);
try {
$pgResponse = $this->apiService->registerEscrowDelivery(
tno: $payment->transaction_id,
ordrIdxx: $orderNumber,
deliNumb: $deliNumb,
deliCorp: $deliCorp,
);
$courierName = self::COURIER_CODES[$deliCorp];
$meta = $payment->payment_meta ? json_decode($payment->payment_meta, true) : [];
$meta['escrow_delivery'] = [
'registered_at' => now()->toDateTimeString(),
'deli_numb' => $deliNumb,
'deli_corp' => $deliCorp,
'courier_name' => $courierName,
'pg_response_sanitized' => true,
'pg_response' => $this->sanitizePgResponse($pgResponse, self::ESCROW_DELIVERY_RESPONSE_KEYS),
];
DB::table((new OrderPayment)->getTable())
->where('id', $payment->id)
->update([
'payment_meta' => json_encode($meta, JSON_UNESCAPED_UNICODE),
'updated_at' => now(),
]);
Log::info('KCP: escrow delivery registered', [
'order_number' => $orderNumber,
'tno' => $payment->transaction_id,
'deli_numb' => $deliNumb,
'courier_name' => $courierName,
]);
return ResponseHelper::success('common.success', [
'res_cd' => $pgResponse['res_cd'] ?? '0000',
'deli_numb' => $deliNumb,
'courier_name' => $courierName,
]);
} catch (\Exception $e) {
Log::error('KCP: escrow delivery register exception', [
'order_number' => $orderNumber,
'error' => $e->getMessage(),
]);
return ResponseHelper::error('common.failed', 500, [
'message' => [$e->getMessage()],
]);
}
}
private function findEscrowPayment(string $orderNumber): ?object
{
return DB::table((new OrderPayment)->getTable().' as p')
->join((new Order)->getTable().' as o', 'o.id', '=', 'p.order_id')
->where('o.order_number', $orderNumber)
->where('p.pg_provider', 'nhnkcp')
->where('p.is_escrow', true)
->whereNotNull('p.transaction_id')
->select([
'p.id',
'p.transaction_id',
'p.paid_amount_local',
'p.payment_meta',
])
->first();
}
}