[KakaoPay] 카카오페이 단건 결제 과정 중 겪은 오류 모음

오류의 원인들

• (구) 카카오페이 API 에서 2024에 새로 바뀌면서 필요없어진 필드값 때문에
• Jackson 모듈 
• url 실수
• key값을 dev용으로 안써서
• 필드 불일치
• 인증 키 변경됨
  • (구)  headers.set("Authorization", "KakaoAK " + kakaoPayConfig.getSecretKeyDev());
  • (신)  headers.set("Authorization", "SECRET_KEY " + kakaoPayConfig.getSecretKeyDev());

 

 

카카오가 제공하는 결제 오류코드 정리 엑셀파일

카카오페이 결제 오류코드 v1.5.xlsx

0.07MB

카카오 제공  오류코드 정리 엑셀파일

 

 

 

 

내가 겪은 오류 메세지 정리

 

오류 메세지	Create breakpoint	원인 (추측)	해결방법
org.springframework.web.client.HttpClientErrorException$BadRequest	400 Bad Request: "{"error_code":-400,"error_message":"잘못된 요청"}"		url수정 String requestUrl = "https://open-api.kakaopay.com/online/v1/payment/ready"; key 수정 "SECRET_KEY " + kakaoPayConfig.getSecretKeyDev()
org.springframework.web.client.HttpClientErrorException$NotFound	404 Not Found: "{"timestamp":"2024-03-27T14:49:47.670+00:00","status":404,"error":"Not Found","path":"/"}"		url수정 String requestUrl = "https://open-api.kakaopay.com/online/v1/payment/ready"; key 수정 "SECRET_KEY " + kakaoPayConfig.getSecretKeyDev()
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException	: Unrecognized field "tms_result" (class com.labmate.riddlebox.dto.kakaopay.PaymentResponseDTO), not marked as ignorable (7 known properties: "android_app_scheme", "ios_app_scheme", "next_redirect_mobile_url", "next_redirect_app_url", "tid", "next_redirect_pc_url", "created_at"])	문서에 없는 필드 때문 카카오 문의센터 글로 추측하자면 새로운 API로 바꾸면서 필요없어진 기존 API 필드인듯	PaymentResponseDTO에 private boolean tms_result; 추가 매칭 안되는 필드 무시하기 애너테이션 추가 @JsonIgnoreProperties(ignoreUnknown = true)
org.springframework.web.client.HttpClientErrorException$BadRequest	400 Bad Request: "{"extras":null,"error_message":"totalAmount, taxFreeAmount, vatAmount, greenDeposit is invalid!","error_code":-722}"	카카오 에러코드 설명으로는 금액 정보가 잘못된 경우	Amount 클래스에 필드 추가 private Integer taxFreeAmount; // 비과세 금액 private Integer vatAmount; // 부가세 금액
com.fasterxml.jackson.databind.exc.InvalidDefinitionException	Java 8 date/time type `java.time.LocalDateTime` not supported by default: add Module "com.fasterxml.jackson.datatype:jackson-datatype-jsr310" to enable handling		의존성 추가 // Java 8 날짜/시간 지원을 위한 Jackson 모듈 등록 implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.13.0'  // Java 8 날짜/시간 모듈 등록 // ObjectMapper 인스턴스 생성 ObjectMapper objectMapper = new ObjectMapper(); // Java 8 날짜/시간 모듈 등록 objectMapper.registerModule(new JavaTimeModule());
org.springframework.web.client.HttpClientErrorException$NotFound	404 Not Found: "{"error_code":-404,"error_message":"리소스 미존재"}"		URL 수정 online이 빠져있었음 https://open-api.kakaopay.com/online/v1/payment/approve
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:	Unrecognized field "sid"	결제카톡은 왔지만 오류메세지 출력됨 정의안한 필드 있을 수도 있고, jackson 날짜시간 코드 추가 안해서 그런듯	// 필드 추가 KakaoPaymentApproveResponseDTO  에 private String sid;  애너테이션 추가 @JsonIgnoreProperties(ignoreUnknown = true) public class KakaoPaymentApproveResponseDTO 생성자에서 모듈 한번에 등록해서 Java 8 날짜/시간 API 지원 활성화 this.objectMapper = new ObjectMapper(); this. objectMapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:	Unrecognized field "tax_free"	있는 필드 인식 못함 Amount 클래스에서 tax_free 필드를 인식하지 못하는 문제 클래스 변수명을 카멜케이스로 수정(실수로 db처럼 선언해버림)	[1] 애너테이션 붙이거나 @JsonProperty("tax_free") private Integer taxFree; [2]ObjectMapper 설정 전체변경 this.objectMapper.setPropertyNamingStrategy( PropertyNamingStrategies.SNAKE_CASE);