Files
HeuJung 3ebbda5d86 feat(board,ecommerce,pay,verification,templates,core): 문의 답변 사슬·답글 삭제 정책·검증 계약 + 실패 사유 표면화 전수
공개 (답변 중복 등록)/(문의 삭제 시 답변 잔존) 수정과 동형 결함 전수 해소.

- 문의 답변 단일성: 1차(피벗 is_answered) + 2차(게시판 리스너 duplicate 마커) 이중 방어,
 경합 경로에서도 사유(reply_already_exists 422)가 보존되도록 훅 반환 계약 확장
- 질문·답변·피벗 생명주기 대칭: 삭제/복원/영구삭제 훅 연동 + 고아 데이터 백필 업그레이드 스텝
- 게시판별 답글 삭제 정책(cascade/block) 신설, 정렬 화이트리스트·per_page 게이트
 (전량 조회 소비처 200/999 를 수용하는 상한 999 — 조였다가 관리자 화면 2곳 422 회귀 즉시 정정)
- 결제/본인인증 플러그인 검증 계약: FormRequest 15종 승격 + 컨트롤러 catch 정합.
 거래 조회 tid 상한은 저장 컬럼(varchar 100) 기준 — 해외 CBT TID(40자) 수용
- onError 토스트 고정 문구 전수 해소(67건/50파일/15확장) — 서버 실패 사유를 그대로 표면화,
 change-password 오변수(response→error) 교정
- 코어 플러그인 설정 검증 안내의 항목 표시명이 스키마 라벨(ko/en) 폴백에 덮여 요청 로케일
 (ja) 라벨을 잃던 회귀 정정 — 번역 등록이 있으면 그것을 우선 (7.0.7 미출시 기능 자체 결함)
- 사전 결함 정리(Icon 등가표 27·darkmode 2·validated 통일), API 문서·CHANGELOG·ja 팩 동기
- develop(60652fdc0) 리베이스: getTable 정비와 병합 — 양측 의도 보존 (충돌 18파일)
2026-08-17 17:04:44 +09:00

2.1 KiB

Payment(결제창 서명) API 레퍼런스

소유: plugin sirsoft-pay_nicepayments · 사람이 서술한 레퍼런스. 이 경로는 결제창(브라우저) 흐름이 호출하는 web 라우트로, 표준 관리자 JSON API 표면이 아니다.


TL;DR (5초 요약)

1. 결제창 호출 직전 브라우저가 서명값(SignData)을 발급받는 경로다
2. amt(정수)·moid(max 64) 형식 위반은 422 (SignDataRequest — 종전 400 에서 422 로 표준화)
3. 주문 실존·구매자 일치·나이스페이 결제 건 여부를 서버가 재검증한다 (금액 조작 방지)
4. 과도 호출은 429 (주문번호 기준 rate limit)
5. 응답은 envelope 없이 { ediDate, signData, mid } 원시 JSON (결제창 SDK 계약)

POST /plugins/sirsoft-pay_nicepayments/payment/sign-data

  • 라우트명: web.plugins.sirsoft-pay_nicepayments.payment.sign-data
  • 컨트롤러: Plugins\Sirsoft\PayNicepayments\Controllers\PaymentCallbackController@signData
  • 인증/권한: web 라우트 (세션/비회원 주문 검증은 구매자 대조로 수행)

요청 파라미터

이름 위치 타입 필수 허용값 용도
amt body integer 예 1 ~ 999999999999 결제 금액. 서버가 주문 금액과 대조하므로 임의 값은 서명 발급이 거절된다
moid body string 예 max 64 주문번호(MOID)

응답 (200)

{
    "ediDate": "20260817143000",
    "signData": "…SHA-256 서명…",
    "mid": "nictest00m"
}

응답은 코어 envelope 를 쓰지 않는다 — 나이스페이 결제창 SDK 가 소비하는 원시 JSON 계약이다. 클라이언트는 response.ok 만 검사한다.

오류 응답

상태 조건
422 amt/moid 형식 위반 (SignDataRequest — 종전 400 응답을 422 로 표준화) / 주문 없음 / 나이스페이 결제 건이 아님
403 구매자 대조 실패 (다른 사용자의 주문번호로 서명 요청)
429 주문번호 기준 rate limit 초과 (60초 내 20회)