[셸위:게임 친구 매칭 사이트] 카카오 페이 API - 결제 취소 기능

[셸위:게임 친구 매칭 사이트] 카카오 페이 API - 결제 취소 기능

https://whatsthatsound.tistory.com/675

[셸위:게임 친구 매칭 사이트] 카카오 페이 API - 결제 기능

---

환불 관리 페이지

 

- 앞서 진행한 카카오페이 결제 API에서는 카카오페이 서버에 결제 정보를 저장했었다. 이번에는 해당 정보를 바탕으로 결제 취소기능을 만드는 것에 대해 설명해보고자 한다. 이번에도 똑같이 카카오페이 결제 취소 API를 사용해보고자 한다.

 

https://developers.kakaopay.com/docs/payment/online/cancellation

카카오페이 | 개발자센터

 

 

 내가 사용한 결제 취소 로직은 아래와 같다.

나는 유저 측에서 전송한 결제 취소 정보를 승인하고, API 측으로 정보를 전송해주는 기능을 만들었다. 결제 취소의 경우는 이미 검증된 정보를 사용하는 것이기 때문에, 결제 때와 같이 까다로운 정보 검증이 필요하지는 않다고 선생님께서 말씀하셨다.

관리자 측에서 환불 신청을 받아, API에 정보를 전송하는 로직

 

 

1. AdminRefund.jsp

-화면은 위와 같다. [환불 미완료] 버튼을 클릭하면, 해당 결제 정보를 서버에 fetch로 전송하게 된다.

-이 때, 해당 결제 정보에서 platform(결제 방식-카카오/토스)에 따라 다른 메서드로 요청이 전송된다.

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ include file="/WEB-INF/view/layout/adminHeader.jsp"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>

<link rel="stylesheet" href="/css/adminRefund.css">
	<div class="main-board">
	<h1>환불 내역 관리</h1>
	<c:if test="${refundList != null}">
			<table class="table">
				<tr>
					<th>id</th>
					<th>주문번호</th>
					<th>유저명</th>
					<th>환불 신청 일자</th>
					<th>플랫폼</th>
					<th>처리 상태</th>
				</tr>
			<c:forEach var="refundDto" items="${refundList}">
				<tr>
					<td>${refundDto.id}</td>
					<td>${refundDto.orderId}</td>
					<td>${refundDto.userId}</td>
					<td>${refundDto.createdAt}</td>
					<td><c:if test="${refundDto.platform == 1 }">카카오페이</c:if>
						<c:if test="${refundDto.platform == 2 }">토스페이먼츠</c:if>
					</td>
					<td><c:if test="${refundDto.status == 0 }">
						<button class="refund-table" onclick="decideRefund(${refundDto.platform}, ${refundDto.id}, ${refundDto.orderId}, ${refundDto.userId},)">환불 미완료</button></c:if>
						<c:if test="${refundDto.status == 1 }"><div>환불 처리 완료</div></c:if>
					</td>
					</tr>
			</c:forEach>
			</table>
	</c:if>
	
	</div>
	<script>
		function decideRefund(platform, id){
			console.log(platform, id);
			
			// 카카오페이 결제 - 환불 처리
			if(platform == 1){
				fetch(`http://localhost:8080/admin/refund/send-request/kakao`, {
		            method: "POST",
		            headers: {
		                "Content-Type": "application/json",
		                // "charset"은 필요하지 않음. 브라우저가 자동으로 처리
		            },
		            body: JSON.stringify({"id" : id}) // 요청 본문에 데이터를 포함
		        })
			}
			}
			
			
			// 토스 페이 환불 처리
			if(platform == 2){
				fetch(`http://localhost:8080/admin/refund/send-request/toss`, {
		            method: "POST",
		            headers: {
		                "Content-Type": "application/json",
		                // "charset"은 필요하지 않음. 브라우저가 자동으로 처리
		            },
		            body: JSON.stringify({"id" : id}) // 요청 본문에 데이터를 포함
		        })
			}
			 
		}
		
		
	</script>

<%@ include file="/WEB-INF/view/layout/adminFooter.jsp"%>

 

 

2. AdminRefundController

-컨트롤러 측에서는 service 단으로 API 요청을 하게끔 명령을 전송한다.

	
	/**
	 * 카카오 - 환불 처리
	 * @param refundData
	 * @return
	 */
	@PostMapping("/send-request/kakao")
	@ResponseBody
	public String sendRefundToKakao(@RequestBody IdDTO id, Model model) {
		
		Refund refund = refundService.getRefundById(Integer.parseInt(id.getId()));
		
		refundService.updateRefundStatus(Integer.parseInt(id.id));
		
		// 환불 요청
		RefundResponseDTO refundResponseDTO = refundService.readyRefundForKakao(refund);
		
		// 환불 결과 받아오기
		new ResponseEntity<>(refundResponseDTO,HttpStatus.OK);
		
		List<RefundDTO> refundList = refundService.getAllRefundDto(10, 0);
		model.addAttribute("refundList", refundList);

		return "/admin/adminRefund";
	}

 

 

3. AdminRefundService

-Service 측에서는 controller가 전송한 정보에 따라 요청을 처리하고, API에게 HttpEntity와 RestTemplate를 통해 HTTP 메세지를 통해 메세지를 전달한다. 이후 RefundResponseDTO에 응답 정보를 저장하게 된다!

-getHeaders() 메서드에서는 내 Authorization -secret key의 정보와 method를 정의해 HttpHeaders를 만든다.

/**
	 * 카카오 페이 - 환불 처리
	 * @param refund
	 * @return
	 */
	public com.example.demo.dto.RefundResponseDTO readyRefundForKakao(Refund refundDto) {
		
		// order amount 찾기
		Order order = orderRepository.selectOrderById(refundDto.orderId);
		OrderDetail orderDetail = orderDetailRepository.selectOrderDetailByOrderId(order.orderId);
		Long cancelAmount = order.getAmount();
		
		Map<String,String> parameters = new HashMap<>();
		parameters.put("cid", "-----------");
		parameters.put("tid", orderDetail.tid);
		parameters.put("cancel_amount", (cancelAmount.toString()));
		parameters.put("cancel_tax_free_amount", "0");
		parameters.put("cancel_vat_amount", "0");
		parameters.put("cancel_available_amount",order.getAmount().toString());
		
		// HttpMessage 만들기
		HttpEntity<Map<String,String>> requestEntity = new HttpEntity(parameters,this.getKakaoHeaders());
		System.out.println(requestEntity);
		RestTemplate template = new RestTemplate();
		// 환불 요청 url
        String url = "https://open-api.kakaopay.com/online/v1/payment/cancel";
        
        // 응답 객체 생성
        RefundResponseDTO refundResponse = template.postForObject(url, requestEntity, RefundResponseDTO.class);
        System.out.println(refundResponse);
        return refundResponse;
	}

 

 

4. AdminRefundResponseDTO.class

RefundResponseDTO의 변수들은 Kakao Payment 결제취소 API의 Response Body와 동일하다!

package com.example.demo.dto;

import com.example.demo.repository.model.Amount;
import com.example.demo.repository.model.ApprovedCancelAmount;
import com.example.demo.repository.model.CancelAvailableAmount;
import com.example.demo.repository.model.CanceledAmount;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;


@ToString
@Data
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class RefundResponseDTO {
	
	public String aid;
	public String tid;
	public String cid;
	public String status;
	public String partnerOrderId;
	public String partnerUserId;
	public String paymentMethodType;
	public Amount amount;
	public ApprovedCancelAmount approvedCancelAmount;
	public CanceledAmount canceledAmount;
	public CancelAvailableAmount cancelAvailableAmount;
	public String itemName;
	public String item_code;
	public Integer quantity;
	public String created_at;
	public String approved_at;
	public String canceled_at;
	public String payload;
}

---

-결제 API를 하고 난 뒤라 그런지, 결제 취소 API의 경우에는 한결 더 수월했다!

-결제가 제대로 승인되지 않은 경우에는 에러가 발생할 수 있으니 유의하면 좋다...