토스페이먼츠 시리즈 (4) _ 카드 결제 3

프론트에서 결제 요청 -> 백엔드에서 요청 검증 후 필요한 정보와 함께 반환 -> 프론트에서 토스페이먼츠 호출 -> 토스페이먼츠에서 결제 결과를 성공/실패 콜백 주소로 리다이렉트 하는 과정 중 성공까지 완료하였다.

 

이제 토스페이먼츠가 실패 시 콜백 주소로 리다이렉트한 요청에 대해 처리를 진행해보자.

---

실패 시 콜백 응답 처리

Payment Controller

@GetMapping("/fail")
@ApiOperation(value = "결제 실패 리다이렉트", notes = "결제 실패 시 에러코드 및 에러메시지를 반환합니다.")
public SingleResult<PaymentResHandleFailDto> requestFail(
        @ApiParam(value = "에러 코드", required = true) @RequestParam(name = "code") String errorCode,
        @ApiParam(value = "에러 메시지", required = true) @RequestParam(name = "message") String errorMsg,
        @ApiParam(value = "우리측 주문 고유 번호", required = true) @RequestParam(name = "orderId") String orderId
) {
    try {
        return responseService.getSingleResult(
                paymentService.requestFail(errorCode, errorMsg, orderId)
        );
    } catch (Exception e) {
        e.printStackTrace();
        throw new BussinessException(e.getMessage());
    }
}

• 기본적으로 실패 리다이렉트를 받기위한 메서드를 Controller에 추가해주자.
• 파라미터 키가 code, message 이므로 @RequestParam()에 바인딩을 위한 이름을 따로 명시해주었다.

Payment 응답 실패 시 반환용 DTO

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class PaymentResHandleFailDto {
	String errorCode;
	String errorMsg;
	String orderId;
}

• 따로 저장하지는 않고 응답 반환용으로만 만들어주었다.

Payment Service

@Transactional
public PaymentResHandleFailDto requestFail(String errorCode, String errorMsg, String orderId) {
    Payment payment = paymentRepository.findByOrderId(orderId)
            .orElseThrow(() -> new BussinessException(ExMessage.PAYMENT_ERROR_ORDER_NOTFOUND));
    payment.setPaySuccessYn("N");
    payment.setPayFailReason(errorMsg);

    return PaymentResHandleFailDto
            .builder()
            .orderId(orderId)
            .errorCode(errorCode)
            .errorMsg(errorMsg)
            .build();
}

• 실패 응답을 처리하는 실제 로직 부분이다.
• Payment Entity에 payFailReason 컬럼을 추가해주었다. 응답 에러 메시지를 파싱받는다.
• 이후 반환용 dto를 통해 실패 내용을 감싸서 반환한다.

이제 실제 테스트를 진행해보려고 하는데...!

 

어떻게 결제를 진행해보아도 도저히 결제 실패를 낼 수가 없었다. 잔액이 없는 카드로 결제를 시도했는데도 되는걸 봐서 테스트용 계정의 한계인듯 하다... 

따라서 그냥 URL로 원하는 값을 전달해주고 잘 반환하는지 정도만 테스트를 진행했다.

 

실패 리다이렉트 URL

응답 처리 확인

응답 실패 DB 저장 확인

좀 애매한 테스트이긴 하지만 원하는대로 DB에도 저장이 되었고 반환값도 제대로 확인이 되었다.

 

이렇게 실패 시 응답 처리까지 완료 하므로서 카드 결제 파트를 완료하였다.

 

이어서 결제 취소, 결제 조회, 거래 정산 조회를 추가적으로 개발하고, 토스페이먼츠가 아닌 금융결제원의 계좌실명조회까지 이어서 구현하도록 하겠다.

 

 

---

Reference

https://docs.tosspayments.com