SDK 오류의 해석, 취소 결과 확인과 재시도 기준, 추가로 문의하신 테스트 승인 처리에 대해 안내 드립니다.

1. 오류 필드와 UNKNOWN·2666의 의미

TossFrontSDKError의 name은 오류 유형, invokeName은 호출한 기능명, code는 전달된 오류 코드, message는 오류 설명, raw는 원본 오류 데이터입니다.

UNKNOWN은 전달된 오류 데이터에 code가 없을 때 SDK가 사용하는 기본값입니다. 전달해 주신 예시도 raw에 message만 있어 UNKNOWN으로 표시됩니다. message 안의 2666을 SDK가 별도 code 필드로 변환하지는 않습니다. API별 파라미터·응답 및 조회 오류는 Payment API 가이드를 참고해 주세요.

2666의 정확한 원인과 발생 단계는 실제 단말기 호출·응답 로그 확인이 필요합니다. 현재 글에는 대상 단말기와 발생 시각이 없어 해당 거래 로그를 확인하지 못했습니다. 앱 ID, 프론트 시리얼번호·앱 버전, 사용 VAN, 발생 일시(한국 시간)를 개발자센터 메일로 전달 부탁 드립니다. 카드번호·현금영수증 식별번호 등 개인정보는 보내지 않으셔도 됩니다.

2. 예외 발생 후 실제 거래 상태 확인

SDK 예외나 UNKNOWN만으로 실제 승인·취소 여부를 일괄 판단하지 마세요. getPayment와 getPaymentCancel은 VAN에 거래 상태를 다시 조회하는 API가 아니라, 요청한 단말기에 저장된 성공 응답을 복구하는 API입니다.

getPaymentCancel의 PAYMENT_NOT_FOUND는 해당 paymentKey의 취소 성공 응답이 단말 캐시에 없다는 뜻이지, 실제 거래가 취소되지 않았다는 확정 결과는 아닙니다. 캐시는 성공 결과만 저장하며, 보관기간 만료나 저장 가능한 건수 제한 등의 영향도 받습니다.

먼저 취소를 요청한 동일 단말기에서 원래 paymentKey로 조회해 주세요. 결과를 복구하지 못하면 자동 재시도를 멈추고, 원승인번호·승인 시각·금액을 기준으로 VAN 대리점을 통해 실제 승인·취소 상태를 확인해 주세요. 승인 캐시와 취소 캐시는 별도이므로, getPayment에 승인 결과가 남아 있다는 이유만으로 미취소로 판단하지 않아야 합니다.

3. 동일 paymentKey로 재요청하는 경우

같은 paymentKey를 전달하는 것만으로 중복 거래가 자동 차단되지는 않습니다. 결과가 미확정인 상태에서는 자동으로 승인·취소를 반복하지 마세요. 취소 재요청은 원거래의 실제 상태를 먼저 확인하고 원승인 정보를 그대로 사용해야 합니다.

4. 테스트 현금영수증 승인 처리

실제 현금영수증을 발급한 테스트 건은 테스트 후 취소 처리해 주세요. 단순 화면·결제 흐름 확인이 목적이라면 현금 결제 > 현금영수증 미발급 방식으로 테스트하시는 것을 권장합니다. 자진발급 설정에 따라 실제 발급될 수 있으므로 응답의 cash.isCashReceipt도 확인해 주세요.

미취소 내역의 구체적인 처리 영향은 등록된 VAN·가맹점 조건에 따라 확인이 필요하므로, 해당 VAN 대리점에 확인 부탁 드립니다. 결제 테스트 가이드도 함께 참고해 주세요.