- 공개 : 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 언어팩 동기
216 lines
7.6 KiB
PHP
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();
|
|
}
|
|
}
|