feat: 토스 페이먼츠 설정 및 세팅 (MIKKI-216)

Author: swjoon

backend/src/main/java/com/backend/global/config/WebConfig.java

@@ -0,0 +1,24 @@
+package com.backend.global.config;
+
+import java.time.Duration;
+
+import org.springframework.boot.web.client.RestTemplateBuilder;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.MediaType;
+import org.springframework.web.client.RestTemplate;
+
+@Configuration
+public class WebConfig {
+
+	@Bean
+	public RestTemplate restTemplate(RestTemplateBuilder builder) {
+		return builder
+			.defaultHeader(HttpHeaders.ACCEPT, MediaType.APPLICATION_JSON_VALUE)
+			.defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
+			.connectTimeout(Duration.ofSeconds(3))    //서버 연결 시도 최대 시간
+			.readTimeout(Duration.ofSeconds(5))    //데이터 응답 대기 최대 시간
+			.build();
+	}
+}

backend/src/main/java/com/backend/global/payment/TossPaymentHttpClient.java

@@ -0,0 +1,102 @@
+package com.backend.global.payment;
+
+import java.util.Map;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.http.HttpEntity;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.HttpMethod;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.stereotype.Component;
+import org.springframework.web.client.HttpStatusCodeException;
+import org.springframework.web.client.RestTemplate;
+
+import com.backend.global.payment.dto.request.TossCancelRequest;
+import com.backend.global.payment.dto.request.TossPaymentRequest;
+import com.backend.global.payment.dto.response.TossCancelResponse;
+import com.backend.global.payment.dto.response.TossPaymentResponse;
+import com.backend.global.payment.exception.PaymentErrorCode;
+import com.backend.global.payment.exception.PaymentException;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class TossPaymentHttpClient {
+
+	private static final String TOSS_PAYMENT_URL = "https://api.tosspayments.com/v1/payments";
+
+	private final RestTemplate restTemplate;
+	private final ObjectMapper objectMapper;
+
+	@Value("${api.toss.secret-key}")
+	private String tossApiSecretKey;
+
+	public TossPaymentResponse sendPaymentConfirmRequest(final TossPaymentRequest request) {
+		String confirmUrl = TOSS_PAYMENT_URL + "/confirm";
+
+		HttpHeaders headers = new HttpHeaders();
+		headers.setContentType(MediaType.APPLICATION_JSON);
+		headers.setBasicAuth(tossApiSecretKey, "");
+
+		HttpEntity<TossPaymentRequest> entity = new HttpEntity<>(request, headers);
+
+		try {
+			ResponseEntity<TossPaymentResponse> responseEntity = restTemplate.exchange(
+				confirmUrl,
+				HttpMethod.POST,
+				entity,
+				TossPaymentResponse.class
+			);
+			return responseEntity.getBody();
+		} catch (HttpStatusCodeException e) {
+			handleApiError(e);
+			throw new PaymentException(PaymentErrorCode.TOSS_API_ERROR);
+		}
+	}
+
+	public TossCancelResponse cancelPayment(final String paymentKey, final String cancelReason, final Long amount) {
+		String cancelUrl = TOSS_PAYMENT_URL + "/" + paymentKey + "/cancel";
+
+		HttpHeaders headers = new HttpHeaders();
+		headers.setContentType(MediaType.APPLICATION_JSON);
+		headers.setBasicAuth(tossApiSecretKey, "");
+
+		TossCancelRequest cancelRequest = TossCancelRequest.of(cancelReason, amount);
+
+		HttpEntity<TossCancelRequest> entity = new HttpEntity<>(cancelRequest, headers);
+
+		try {
+			ResponseEntity<TossCancelResponse> response = restTemplate.exchange(
+				cancelUrl,
+				HttpMethod.POST,
+				entity,
+				TossCancelResponse.class
+			);
+			log.info("Toss 결제 취소 완료: paymentKey={}, amount={}", paymentKey, amount);
+
+			return response.getBody();
+		} catch (HttpStatusCodeException e) {
+			log.error("Toss 결제 취소 실패: {}", e.getResponseBodyAsString());
+
+			throw new PaymentException(PaymentErrorCode.TOSS_API_CANCEL_FAILED);
+		}
+	}
+
+	private void handleApiError(HttpStatusCodeException e) {
+		try {
+			Map<String, Object> errorResponse = objectMapper
+				.readValue(e.getResponseBodyAsString(), new TypeReference<>() {
+				});
+
+			log.error("Toss API Error: code={}, message={}", errorResponse.get("code"), errorResponse.get("message"));
+		} catch (Exception ex) {
+			log.error("Failed to parse Toss API error", ex);
+		}
+	}
+}

backend/src/main/java/com/backend/global/payment/dto/request/TossCancelRequest.java

@@ -0,0 +1,19 @@
+package com.backend.global.payment.dto.request;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+import lombok.Builder;
+
+@Builder
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public record TossCancelRequest(
+	String cancelReason,
+	Long cancelAmount
+) {
+	public static TossCancelRequest of(final String cancelReason, final Long cancelAmount) {
+		return TossCancelRequest.builder()
+			.cancelReason(cancelReason)
+			.cancelAmount(cancelAmount)
+			.build();
+	}
+}

backend/src/main/java/com/backend/global/payment/dto/request/TossPaymentRequest.java

@@ -0,0 +1,45 @@
+package com.backend.global.payment.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Builder;
+
+/**
+ * 토스 결제 요청
+ *
+ * @param paymentKey
+ * @param amount
+ * @param orderId
+ */
+@Builder
+public record TossPaymentRequest(
+	@NotBlank
+	@Schema(description = "토스에서 발급하는 결제 고유 식별자")
+	String paymentKey,
+
+	@NotNull
+	@Min(0)
+	@Schema(description = "결제 금액")
+	Long amount,
+
+	@NotBlank
+	@Size(min = 6, max = 64)
+	@Schema(description = "주문번호, 결제 요청에서 직접 생성한 영문 대소문자, 숫자, '-', '_'로 이루어진 6자 이상 64이하 문자열")
+	String orderId
+) {
+	public static TossPaymentRequest from(
+		final String paymentKey,
+		final Long amount,
+		final String orderId) {
+
+		return TossPaymentRequest.builder()
+			.paymentKey(paymentKey)
+			.amount(amount)
+			.orderId(orderId)
+			.build();
+	}
+}
+

backend/src/main/java/com/backend/global/payment/dto/response/TossCancelResponse.java

@@ -0,0 +1,11 @@
+package com.backend.global.payment.dto.response;
+
+import java.time.OffsetDateTime;
+
+public record TossCancelResponse(
+	String status,
+	String cancelReason,
+	Long canceledAmount,
+	OffsetDateTime canceledAt
+) {
+}

backend/src/main/java/com/backend/global/payment/dto/response/TossPaymentResponse.java

@@ -0,0 +1,28 @@
+package com.backend.global.payment.dto.response;
+
+import java.time.OffsetDateTime;
+
+import lombok.Getter;
+
+@Getter
+public class TossPaymentResponse {
+	private String paymentKey;
+	private String orderId;
+	private String method;
+	private OffsetDateTime approvedAt;
+	private Long totalAmount;
+	private String status;
+	private Card card;
+	private Receipt receipt;
+
+	@Getter
+	public static class Card {
+		private String number;
+		private String approveNo;
+	}
+
+	@Getter
+	public static class Receipt {
+		private String url;
+	}
+}

backend/src/main/java/com/backend/global/payment/exception/PaymentErrorCode.java

@@ -0,0 +1,20 @@
+package com.backend.global.payment.exception;
+
+import org.springframework.http.HttpStatus;
+
+import com.backend.global.exception.ErrorCode;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum PaymentErrorCode implements ErrorCode {
+
+	TOSS_API_ERROR(HttpStatus.BAD_REQUEST, 16001, "결제 오류가 발생했습니다."),
+	TOSS_API_CANCEL_FAILED(HttpStatus.BAD_REQUEST, 16002, "결제 취소 오류가 발생했습니다.");
+
+	private final HttpStatus httpStatus;
+	private final Integer code;
+	private final String message;
+}

backend/src/main/java/com/backend/global/payment/exception/PaymentException.java

@@ -0,0 +1,22 @@
+package com.backend.global.payment.exception;
+
+import com.backend.global.exception.ErrorCode;
+import com.backend.global.exception.GlobalException;
+
+import lombok.Getter;
+
+@Getter
+public class PaymentException extends GlobalException {
+
+	private final ErrorCode errorCode;
+
+	public PaymentException(final ErrorCode errorCode) {
+		super(errorCode);
+		this.errorCode = errorCode;
+	}
+
+	public PaymentException(final Throwable cause, final ErrorCode errorCode) {
+		super(cause, errorCode);
+		this.errorCode = errorCode;
+	}
+}