fix(performance): 카페24 결제합계 = 실결제 + 적립금 + 예치금 + 네이버포인트

9/23 대조 진단으로 확인: 카페24 일별 매출내역 결제합계 1,874,738 =
실결제 1,713,128(initial payment_amount) + 적립금 10,110 + 예치금 0 +
네이버포인트 151,500(주문 naver_point). "상품구매금액 + 배송비 − 할인 − 쿠폰"은
1,874,800 으로 할인 필드에 안 잡히는 차이(62원)가 남는다 — 카페24 화면의
상품구매금액은 결제 금액에서 거꾸로 맞춘 값. 상품추가할인은 0 이라 원인 아님.

- order_total / order_total_now: 실결제 + 적립금 + 예치금 + 네이버포인트
  (모두 0인 주문만 상품식)
- 품목 상품추가할인 차감 제거(직전 커밋의 잘못된 추정)
- 대조 표: 실결제·적립금·예치금·네이버포인트 줄을 카페24 열과 비교,
  상품식은 참고 줄로
- 테스트 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 22:08:18 +09:00
parent 20d19792dd
commit 398e5181fd
6 changed files with 56 additions and 52 deletions
+4 -3
View File
@@ -42,7 +42,7 @@
| 사건 | 조회 | 금액·날짜 |
|---|---|---|
| SALE(결제합계) | `GET /admin/orders` `date_type=pay_date`, `embed=items`, `paid=T` | +(상품구매금액 + 배송비 − 할인 − 쿠폰), `initial_order_amount`(결제 당시 금액 — 환불을 따로 빼므로 취소 후 금액 X), 결제일. 주문 1건 = 사건 1건(`{order_id}-PAY`) |
| SALE(결제합계) | `GET /admin/orders` `date_type=pay_date`, `embed=items`, `paid=T` | +(실결제금액 + 적립금 + 예치금 + 네이버포인트), `initial_order_amount` + 주문 `naver_point`(결제 당시 금액 — 환불을 따로 빼므로 취소 후 금액 X), 결제일. 주문 1건 = 사건 1건(`{order_id}-PAY`) |
| CANCEL / RETURN(환불합계) | `GET /admin/refunds` `date_type=refund_date`, `status=T` | −(실제 환불액 + 적립금·예치금 환불), 환불완료일. 환불코드 R… = 반품, 그 밖 = 취소. 사건 ID = 환불코드 |
| CANCEL / RETURN(환불 목록 없는 취소·반품) | `GET /admin/orders` `date_type=cancel_date|return_complete_date`, `embed=items` — 품목 상태 C40~43/R40~43 이고 앞뒤 60일 환불 목록(완료일·접수일)에 그 주문이 없을 때 | −(판매가+옵션)×수량 − 품목 할인·쿠폰, 품목 취소일(반품은 반품완료일). 네이버페이 취소가 여기 해당 (네이버가 환불해 카페24 환불 목록에 없음). 사건 ID = `c24:{품목코드}-CL` (`unrefunded_claims`) |
@@ -73,8 +73,9 @@
저장값만 틀림 → 예전 규칙으로 받은 것([다시 가져오기] 버튼), API 값도 틀림 → 규칙 차이(결제/환불) → 날짜 클릭으로 그날 대조.
날짜를 눌러 연 대조 표에는 붙여넣은 카페24 열(주문수·품목수·상품구매금액·배송비·할인·쿠폰·실결제·적립금·예치금·결제·환불·순매출)과
열별 차이가 같이 나온다.
- 결제합계의 상품구매금액 = 판매가 합계 − **품목 상품추가할인**(`items[].additional_discount_price`). 주문 금액(initial_order_amount)에는
이 할인이 없다(2026-09 실데이터: 카페24 상품구매금액이 100원 단위가 아닌 날만 결제합계가 그만큼 많았음, 예 9/23 +62).
- **결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트**(initial_order_amount 의 payment_amount·points_spent_amount·
credits_spent_amount + 주문의 naver_point). "상품구매금액 + 배송비 − 할인 − 쿠폰"은 할인 필드에 안 잡히는 차이가 있어 쓰지 않음
(2026-09-23: 카페24 1,874,738 = 1,713,128 + 10,110 + 151,500, 상품식 1,874,800). 네 값이 모두 0인 주문만 상품식.
### 연동 단계 체크리스트(쇼핑몰마다)