📌5.6.46→5.6.47 변경 비교

[릴리즈 노트]

• 버전: 5.6.47
• 배포일: 2026-11-06
• 패치 기준: 5.6.46
• DB업그레이드: 필수
  • 20261106_001_toss_identifier_collation
• 삭제 대상 파일: 없음

[개발자 노트]
쇼핑몰은 결제할 때 받은 거래번호로 나중에 그 결제를 찾습니다. 가상계좌에 돈이 들어왔을 때 어느 주문의 입금인지 확인하거나, 고객이 취소를 요청했을 때 원래 결제를 찾는 데 쓰입니다. 토스페이먼츠는 앞으로 이 번호가 최대 200자까지 길어질 수 있다고 안내했습니다. 번호 일부가 잘리거나 대소문자가 달라지면 결제는 이미 끝났어도 쇼핑몰에서 원래 거래를 찾지 못할 수 있습니다. 이번 패치는 토스가 준 번호를 그대로 저장하고 다시 사용하도록 합니다. 기존 주문의 거래번호는 그대로 쓸 수 있습니다.

부분취소에서는 같은 요청을 두 번 보내는 상황도 고려했습니다. 예를 들어 500원을 환불한 직후 화면이 멈추면, 관리자는 취소가 실패했다고 생각해 다시 시도할 수 있습니다. 하지만 토스에서는 이미 500원을 환불했을 수 있습니다. 이번 버전은 토스 신모듈의 환불 잔액과 쇼핑몰 기록이 다르면 추가 취소를 멈추고, 관리자가 거래내역을 먼저 확인하도록 안내합니다.

[패치 노트]

• XPay 거래번호(TID)와 토스 신모듈 결제키(paymentKey)의 대소문자와 특수문자를 주문·개인결제 조회, 가상계좌 통보, 취소 요청에서 보존합니다.
• 관리자 부분취소 금액은 고객에게 돌려줄 금액과 결제 잔액 중 작은 금액을 넘을 수 없습니다. 이미 환불액이 바뀐 주문에서 이전에 열어 둔 취소 창을 제출하면 다시 확인하도록 안내합니다.
• XPay는 과세분만 쇼핑몰에서 부분취소할 수 있습니다. 공개 매뉴얼에서 면세분을 취소 총액에 어떻게 포함해야 하는지 확인하기 어려워, 면세분이 포함된 요청은 차단합니다. 이런 건은 토스 상점관리자에서 처리한 뒤 쇼핑몰 환불액과 잔액을 대조해 주세요.

[업데이트 안내]

1. 파일과 DB를 백업하고 업데이트 중 주문 접수를 중지합니다.
2. 5.6.46 사용자는 패치 ZIP을, 이전 버전 사용자는 전체 배포본을 기준으로 사용자 수정 사항을 병합합니다. 기존 data와 DB 설정을 보존합니다.
3. 관리자 DB 업그레이드에서 전체 마이그레이션을 실행합니다. 쇼핑몰 거래번호 컬럼의 비교 방식을 변경하므로 ALTER 권한과 테이블 변경 시간을 확보해 주세요. 실패 시 오류와 권한을 확인한 뒤 다시 실행합니다.
4. 캐시를 정리하고 주문·개인결제 조회 및 사용하는 PG의 관리자 취소 화면을 확인한 후 서비스를 재개합니다.