fix(core,ecommerce,board,basic,pay_kginicis,pay_nhnkcp,pay_nicepayments): 7.0.6 회귀 3건·잠복 결함 3건 해소 + 통화 하드코딩 전수 제거
7.0.6 사이클에서 유입된 회귀 3건을 출시 전에 닫는다. 추가옵션 저장소의 반환 타입 선언이 실제 반환(중첩 맵)과 어긋나 추가옵션 있는 상품의 담기· 바로구매가 죽었고, 검색 엔진이 결과 소비 시점에 SELECT 를 재작성해 정렬이 참조하던 스코어 별칭을 지웠으며, 미들웨어 targets 가 늘어난 라우트를 따라가지 못해 비회원 현금영수증이 전면 불능이었다. 셋 다 정적 검사의 사각지대였으므로 룰 2건과 계약 테스트를 함께 세워 재발을 막는다. 같은 유형의 잠복 결함 3건(빈 반환의 타입 불일치 2건, 없는 메서드 호출 1건)도 호출 경로가 생기는 순간 fatal 이므로 함께 닫았다. 브라우저 검수 중 드러난 선행 결함 5건을 이어서 수정한다. 엔진이 event 키로 선언한 액션을 React prop 으로 연결하지 않아 오류 없이 조용히 무반응이었고, 연결한 뒤에는 커스텀 컴포넌트의 이벤트 payload 가 유실됐다. 비회원 주문상세 응답에 현금영수증 키가 없어 발급 결과에 도달할 수 없었으며, 입금확인과 현금영수증 발급이 base 통화 금액을 써서 결제 통화가 다른 주문에서 각각 저장 실패와 잘못된 증빙을 냈다. 마지막으로 통화 단위를 코드·문구에서 걷어내 설정으로 이관한다. 다국어 문구의 원/円, 프론트의 KRW 고정표와 리터럴 폴백 173건, 서버 포맷의 통화 코드 리터럴이 대상이며, 기본 통화가 원이 아닌 상점에서 값은 맞고 단위만 틀린 금액이 예외 없이 나가던 문제였다. 통화 판정을 설정 단일 출처로 모으고 규칙 3건을 정적 검사로 고정했다.
This commit is contained in:
1 parent
7f4e665827
commit
e21bff678f
167 files changed
+3980
-696
No files matched your search
@@ -22,6 +22,7 @@
|
||||
|
||||
### Fixed
|
||||
|
||||
- 결제 취소 기록의 환불 금액에 원화 단위가 고정 표기되던 문제를 수정했습니다. 해외 결제(엔화 등) 취소도 실제 결제 통화로 표시됩니다.
|
||||
|
||||
- 쇼핑몰 주소를 기본값이 아닌 값으로 바꾸거나 주소 없이 운영하는 상점에서, 결제를 마치거나 결제에 실패한 구매자가 존재하지 않는 페이지로 이동하던 문제를 수정했습니다. 이동 주소가 기본 주소로 고정돼 있었기 때문이며, 이제 상점 주소 설정을 따라갑니다. 이미 운영 중인 사이트도 업데이트 시 자동으로 반영되며, 이동 주소를 직접 입력해 두었다면 그 값은 그대로 유지됩니다. (#85 @hwaryeon1234 님께서 제보해주셨습니다.)
|
||||
- 안내 메시지가 번역되지 않고 내부 코드 그대로 표시되던 문제를 수정했습니다. 일본 편의점결제(CVS) 입금 통보 테스트·입금기한 만료 처리뿐 아니라 에스크로 배송 등록·구매확인 거부, 거래 조회, 정산 마감 등 이 플러그인의 모든 처리 결과에서 사용 중인 언어에 맞는 안내가 표시됩니다.
|
||||
|
||||
@@ -5,6 +5,6 @@ return [
|
||||
'cancel' => 'PG 결제 취소',
|
||||
],
|
||||
'description' => [
|
||||
'payment_cancel' => 'KG 이니시스 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount원).',
|
||||
'payment_cancel' => 'KG 이니시스 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount).',
|
||||
],
|
||||
];
|
||||
@@ -78,7 +78,7 @@ class CancelActivityLogListener implements HookListenerInterface
|
||||
'description_key' => 'sirsoft-pay_kginicis::activity_log.description.payment_cancel',
|
||||
'description_params' => [
|
||||
'order_number' => $order->order_number,
|
||||
'refund_amount' => number_format((int) $refundAmount),
|
||||
'refund_amount' => ecommerce_format_price((int) $refundAmount, $order->currency),
|
||||
],
|
||||
'properties' => [
|
||||
'tid' => $payment->transaction_id,
|
||||
|
||||
@@ -12,6 +12,8 @@
|
||||
|
||||
### Fixed
|
||||
|
||||
- 관리자 주문 상세의 거래 조회에서 취소·환불 금액에 원화 단위가 고정 표기되던 문제를 수정했습니다. 이제 주문 시점 기준 통화로 표시됩니다.
|
||||
- 결제 취소 기록의 환불 금액 표기도 결제 통화를 따르도록 수정했습니다.
|
||||
- 쇼핑몰 주소를 기본값이 아닌 값으로 바꾸거나 주소 없이 운영하는 상점에서, 결제를 마치거나 결제에 실패한 구매자가 존재하지 않는 페이지로 이동하던 문제를 수정했습니다. 이동 주소가 기본 주소로 고정돼 있었기 때문이며, 이제 상점 주소 설정을 따라갑니다. 이미 운영 중인 사이트도 업데이트 시 자동으로 반영되며, 이동 주소를 직접 입력해 두었다면 그 값은 그대로 유지됩니다. (#85 @hwaryeon1234 님께서 제보해주셨습니다.)
|
||||
- 이 플러그인이 설치된 사이트에서 관리자 주문 목록의 '일부취소' 표시와 적립예정 포인트·마일리지 사용 금액, 주문상품의 추가옵션 요약이 보이지 않던 문제를 수정했습니다. 결제 정보 칸에 테스트결제 표시를 덧붙이는 과정에서 목록 표 구성 전체를 옛 버전으로 되돌려 놓고 있었습니다.
|
||||
- 관리자 결제수단 설정에서 가상계좌·계좌이체·휴대폰결제에 PG사를 지정할 수 없던 문제를 수정했습니다. 해당 결제수단의 PG사 목록이 항상 비어 있어 기본 PG사만 사용할 수 있었고, 결제수단별로 다른 PG사를 지정하는 설정이 화면에서 불가능했습니다.
|
||||
|
||||
@@ -5,3 +5,4 @@
|
||||
| 문서 | 도메인 | 설명 |
|
||||
| --- | --- | --- |
|
||||
| [vbank.md](vbank.md) | `payment` | 가상계좌 입금통보·에스크로 공통통보 수신 경로와 발신 서버(IP) 확인 |
|
||||
| [transaction-status.md](transaction-status.md) | `admin` | 관리자 주문 상세의 거래 상태·취소·환불 조회 |
|
||||
@@ -0,0 +1,118 @@
|
||||
# 거래 조회 API 레퍼런스
|
||||
|
||||
> **소유**: 플러그인 `sirsoft-pay_nhnkcp`. 관리자 주문 상세에서 이 주문의 NHN KCP 거래 상태·취소·환불 현황을 조회한다.
|
||||
|
||||
---
|
||||
|
||||
## TL;DR (5초 요약)
|
||||
|
||||
```text
|
||||
1. 관리자 주문 상세의 "거래 조회" 가 호출하는 단일 엔드포인트다
|
||||
2. 이 주문에 nhnkcp 결제가 없으면 data 는 null (오류 아님)
|
||||
3. 금액 표기(*_formatted)는 주문 시점 기준 통화를 따른다 (원화 고정 아님)
|
||||
4. 취소·환불 금액 원본은 숫자 필드로 함께 제공된다
|
||||
5. 관리자 인증 + 주문 조회 권한이 필요하다
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 거래 상태 조회
|
||||
|
||||
| 항목 | 값 |
|
||||
| --- | --- |
|
||||
| 메서드/URI | `GET /api/plugins/sirsoft-pay_nhnkcp/admin/orders/{orderNumber}/transaction-status` |
|
||||
| 인증 | Bearer 토큰 (관리자) |
|
||||
| 권한 | 주문 조회 권한 |
|
||||
|
||||
### 경로 파라미터
|
||||
|
||||
| 이름 | 타입 | 필수 | 설명 |
|
||||
| --- | --- | --- | --- |
|
||||
| `orderNumber` | string | 필수 | 조회할 주문번호 |
|
||||
|
||||
### 응답 필드 (`data`)
|
||||
|
||||
이 주문에 NHN KCP 결제 기록이 없으면 `data` 는 `null` 이다.
|
||||
|
||||
| 필드 | 타입 | 설명 |
|
||||
| --- | --- | --- |
|
||||
| `tno` | string | KCP 거래번호 |
|
||||
| `app_no` | string\|null | 승인번호 |
|
||||
| `use_pay_method` | string\|null | 실제 사용된 결제수단 코드 |
|
||||
| `app_time` | string\|null | 승인 일시 (KCP 원본 형식) |
|
||||
| `res_cd` | string | KCP 응답 코드 (`0000` = 정상) |
|
||||
| `card_name` | string\|null | 카드사명 또는 은행명 |
|
||||
| `account` | string\|null | 가상계좌 번호 |
|
||||
| `bank_name` | string\|null | 입금 은행명 |
|
||||
| `payment_status` | string | 결제 상태 코드 |
|
||||
| `payment_status_label` | string | 결제 상태 표시명 (요청 언어) |
|
||||
| `payment_status_variant` | string | 상태 뱃지 색상 구분 |
|
||||
| `cancelled_amount` | number | 취소 금액 (주문 시점 기준 통화) |
|
||||
| `cancelled_amount_formatted` | string | 취소 금액 표기 — **주문 시점 기준 통화의 기호·자릿수** |
|
||||
| `cancelled_at` | string\|null | 취소 일시 |
|
||||
| `cancel_history` | array | 부분취소 이력 |
|
||||
| `refund_number` | string\|null | 환불 번호 |
|
||||
| `refund_status` | string\|null | 환불 상태 코드 |
|
||||
| `refund_status_label` | string\|null | 환불 상태 표시명 |
|
||||
| `refund_status_variant` | string\|null | 환불 상태 뱃지 색상 구분 |
|
||||
| `refund_amount` | number | 환불 금액 (주문 시점 기준 통화) |
|
||||
| `refund_amount_formatted` | string | 환불 금액 표기 — **주문 시점 기준 통화의 기호·자릿수** |
|
||||
| `refunded_at` | string\|null | 환불 완료 일시 |
|
||||
| `refund_pg_transaction_id` | string\|null | 환불 거래번호 |
|
||||
| `payment_method_display_label` | string | 화면 표시용 결제수단명 |
|
||||
| `_is_test_mode` | boolean | 테스트 결제 여부 |
|
||||
|
||||
> **금액 표기 통화**: `*_formatted` 는 주문 스냅샷의 기준 통화(`currency_snapshot.base_currency`)로 포맷한다. 운영자가 이후 상점 기본 통화를 바꿔도 과거 주문의 표기는 변하지 않는다. 스냅샷이 없는 예전 주문은 현재 기본 통화로 표기한다.
|
||||
|
||||
### 요청 예시
|
||||
|
||||
```http
|
||||
GET /api/plugins/sirsoft-pay_nhnkcp/admin/orders/20260807-0001/transaction-status
|
||||
Authorization: Bearer {token}
|
||||
```
|
||||
|
||||
### 응답 예시
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"message": "성공적으로 처리되었습니다.",
|
||||
"data": {
|
||||
"tno": "26438048818473",
|
||||
"app_no": "00812345",
|
||||
"use_pay_method": "CARD",
|
||||
"app_time": "20260807153012",
|
||||
"res_cd": "0000",
|
||||
"card_name": "신한카드",
|
||||
"account": null,
|
||||
"bank_name": null,
|
||||
"payment_status": "cancelled",
|
||||
"payment_status_label": "결제취소",
|
||||
"payment_status_variant": "danger",
|
||||
"cancelled_amount": 1100,
|
||||
"cancelled_amount_formatted": "1,100원",
|
||||
"cancelled_at": "2026-08-07 15:40:22",
|
||||
"cancel_history": [],
|
||||
"refund_number": "RF-20260807-0001",
|
||||
"refund_status": "completed",
|
||||
"refund_status_label": "환불완료",
|
||||
"refund_status_variant": "success",
|
||||
"refund_amount": 1100,
|
||||
"refund_amount_formatted": "1,100원",
|
||||
"refunded_at": "2026-08-07 15:41:03",
|
||||
"refund_pg_transaction_id": "26438048818473",
|
||||
"payment_method_display_label": "신용카드 (NHN KCP)",
|
||||
"_is_test_mode": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 결제 기록이 없을 때
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"message": "성공적으로 처리되었습니다.",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
@@ -5,6 +5,6 @@ return [
|
||||
'cancel' => 'PG 결제 취소',
|
||||
],
|
||||
'description' => [
|
||||
'payment_cancel' => 'NHN KCP 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount원).',
|
||||
'payment_cancel' => 'NHN KCP 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount).',
|
||||
],
|
||||
];
|
||||
@@ -62,6 +62,8 @@ class AdminTransactionController extends AdminBaseController
|
||||
'p.cancelled_at',
|
||||
'p.cancel_history',
|
||||
'p.currency',
|
||||
// 취소·환불 금액은 기준 통화 저장값이라 표기 통화도 주문 스냅샷을 따라야 한다
|
||||
'o.currency_snapshot',
|
||||
])
|
||||
->first();
|
||||
|
||||
@@ -82,6 +84,7 @@ class AdminTransactionController extends AdminBaseController
|
||||
$refundStatus = is_string($refund->refund_status ?? null)
|
||||
? RefundStatusEnum::tryFrom($refund->refund_status)
|
||||
: null;
|
||||
$baseCurrency = $this->resolveBaseCurrency($payment->currency_snapshot ?? null);
|
||||
$cancelledAmount = (float) ($payment->cancelled_amount ?? 0);
|
||||
$refundAmount = $refund ? (float) ($refund->refund_amount ?? 0) : 0.0;
|
||||
|
||||
@@ -99,7 +102,7 @@ class AdminTransactionController extends AdminBaseController
|
||||
'payment_status_label' => $paymentStatus?->label(),
|
||||
'payment_status_variant' => $paymentStatus?->variant(),
|
||||
'cancelled_amount' => $cancelledAmount,
|
||||
'cancelled_amount_formatted' => $this->formatKrwAmount($cancelledAmount),
|
||||
'cancelled_amount_formatted' => ecommerce_format_price($cancelledAmount, $baseCurrency),
|
||||
'cancelled_at' => $payment->cancelled_at,
|
||||
'cancel_history' => $this->decodeJsonArray($payment->cancel_history ?? null),
|
||||
'refund_number' => $refund->refund_number ?? null,
|
||||
@@ -107,7 +110,7 @@ class AdminTransactionController extends AdminBaseController
|
||||
'refund_status_label' => $refundStatus?->label(),
|
||||
'refund_status_variant' => $refundStatus?->variant(),
|
||||
'refund_amount' => $refundAmount,
|
||||
'refund_amount_formatted' => $this->formatKrwAmount($refundAmount),
|
||||
'refund_amount_formatted' => ecommerce_format_price($refundAmount, $baseCurrency),
|
||||
'refunded_at' => $refund->refunded_at ?? null,
|
||||
'refund_pg_transaction_id' => $refund->pg_transaction_id ?? null,
|
||||
'_base_pay_method_label' => $display['payment_method_label'],
|
||||
@@ -133,9 +136,20 @@ class AdminTransactionController extends AdminBaseController
|
||||
->first();
|
||||
}
|
||||
|
||||
private function formatKrwAmount(float $amount): string
|
||||
/**
|
||||
* 주문 시점 기준 통화 코드를 스냅샷에서 해석합니다.
|
||||
*
|
||||
* 취소·환불 금액은 기준 통화로 저장되므로, 표기 통화도 그 시점 기준 통화여야 한다.
|
||||
* 스냅샷이 없으면 현재 기본 통화로 폴백한다.
|
||||
*
|
||||
* @param mixed $snapshot currency_snapshot 컬럼값(JSON 문자열 또는 배열)
|
||||
* @return string|null 기준 통화 코드 (없으면 null → 현재 기본 통화)
|
||||
*/
|
||||
private function resolveBaseCurrency(mixed $snapshot): ?string
|
||||
{
|
||||
return number_format((int) round($amount)).'원';
|
||||
$decoded = is_string($snapshot) ? json_decode($snapshot, true) : $snapshot;
|
||||
|
||||
return is_array($decoded) ? ($decoded['base_currency'] ?? null) : null;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -76,7 +76,7 @@ class CancelActivityLogListener implements HookListenerInterface
|
||||
'description_key' => 'sirsoft-pay_nhnkcp::activity_log.description.payment_cancel',
|
||||
'description_params' => [
|
||||
'order_number' => $order->order_number,
|
||||
'refund_amount' => number_format((int) $refundAmount),
|
||||
'refund_amount' => ecommerce_format_price((int) $refundAmount, $order->currency),
|
||||
],
|
||||
'properties' => [
|
||||
'tno' => $payment->transaction_id,
|
||||
|
||||
+3
-1
@@ -130,7 +130,9 @@ class AdminTransactionControllerTest extends PluginTestCase
|
||||
->assertJsonPath('data.res_cd', '0000')
|
||||
->assertJsonPath('data.payment_status', PaymentStatusEnum::CANCELLED->value)
|
||||
->assertJsonPath('data.cancelled_amount', 1100)
|
||||
->assertJsonPath('data.cancelled_amount_formatted', '1,100원')
|
||||
// 표기 통화는 주문 시점 기준 통화가 정한다 — 원화를 문자열로 못 박으면
|
||||
// 기준 통화가 다른 상점에서 값은 맞고 단위만 틀린 증빙이 화면에 뜬다.
|
||||
->assertJsonPath('data.cancelled_amount_formatted', ecommerce_format_price(1100))
|
||||
->assertJsonPath('data.refund_status', RefundStatusEnum::COMPLETED->value)
|
||||
->assertJsonPath('data.refund_pg_transaction_id', '26438048818473');
|
||||
|
||||
|
||||
@@ -12,6 +12,7 @@
|
||||
|
||||
### Fixed
|
||||
|
||||
- 결제 취소 기록과 환불 금액 오류 안내에 원화 단위가 고정 표기되던 문제를 수정했습니다. 이제 실제 결제 통화로 표시됩니다.
|
||||
- 쇼핑몰 주소를 기본값이 아닌 값으로 바꾸거나 주소 없이 운영하는 상점에서, 결제를 마치거나 결제에 실패한 구매자가 존재하지 않는 페이지로 이동하던 문제를 수정했습니다. 이동 주소가 기본 주소로 고정돼 있었기 때문이며, 이제 상점 주소 설정을 따라갑니다. 이미 운영 중인 사이트도 업데이트 시 자동으로 반영되며, 이동 주소를 직접 입력해 두었다면 그 값은 그대로 유지됩니다. (#85 @hwaryeon1234 님께서 제보해주셨습니다.)
|
||||
- 이 플러그인이 설치된 사이트에서 관리자 주문 목록의 '일부취소' 표시와 적립예정 포인트·마일리지 사용 금액, 주문상품의 추가옵션 요약이 보이지 않던 문제를 수정했습니다. 결제 정보 칸에 테스트결제 표시를 덧붙이는 과정에서 목록 표 구성 전체를 옛 버전으로 되돌려 놓고 있었습니다.
|
||||
- 관리자 결제수단 설정에서 가상계좌·계좌이체·휴대폰결제에 PG사를 지정할 수 없던 문제를 수정했습니다. 해당 결제수단의 PG사 목록이 항상 비어 있어 기본 PG사만 사용할 수 있었고, 결제수단별로 다른 PG사를 지정하는 설정이 화면에서 불가능했습니다.
|
||||
|
||||
@@ -5,6 +5,6 @@ return [
|
||||
'cancel' => 'PG 결제 취소',
|
||||
],
|
||||
'description' => [
|
||||
'payment_cancel' => '나이스페이먼츠 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount원).',
|
||||
'payment_cancel' => '나이스페이먼츠 결제 취소가 확인되었습니다 (주문 :order_number, 환불금액 :refund_amount).',
|
||||
],
|
||||
];
|
||||
@@ -14,7 +14,7 @@ return [
|
||||
'vbank_refund_amount_mismatch' => '요청 환불 금액이 DB의 취소 가능 금액과 일치하지 않습니다.',
|
||||
'vbank_refund_already_processing' => '이미 가상계좌 환불 처리가 진행 중입니다.',
|
||||
'vbank_completed_requires_bank_info' => '가상계좌 입금 완료 건은 환불계좌 정보가 필요합니다. 관리자 API를 통해 환불을 진행해주세요.',
|
||||
'invalid_refund_amount' => '환불 금액이 유효하지 않습니다. (요청: :amount원)',
|
||||
'invalid_refund_amount' => '환불 금액이 유효하지 않습니다. (요청: :amount)',
|
||||
],
|
||||
'refund' => [
|
||||
'missing_tid' => '거래 ID(TID)가 없어 환불을 진행할 수 없습니다.',
|
||||
|
||||
+1
-1
@@ -77,7 +77,7 @@ class CancelActivityLogListener implements HookListenerInterface
|
||||
'description_key' => 'sirsoft-pay_nicepayments::activity_log.description.payment_cancel',
|
||||
'description_params' => [
|
||||
'order_number' => $order->order_number,
|
||||
'refund_amount' => number_format((int) $refundAmount),
|
||||
'refund_amount' => ecommerce_format_price((int) $refundAmount, $order->currency),
|
||||
],
|
||||
'properties' => [
|
||||
'tid' => $payment->transaction_id,
|
||||
|
||||
@@ -98,7 +98,7 @@ class PaymentRefundListener implements HookListenerInterface
|
||||
return [
|
||||
'success' => false,
|
||||
'error_code' => 'INVALID_REFUND_AMOUNT',
|
||||
'error_message' => __('sirsoft-pay_nicepayments::messages.errors.invalid_refund_amount', ['amount' => $cancelAmt]),
|
||||
'error_message' => __('sirsoft-pay_nicepayments::messages.errors.invalid_refund_amount', ['amount' => ecommerce_format_price($cancelAmt, $order->currency)]),
|
||||
'transaction_id' => null,
|
||||
];
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user