📌 SpringBoot에서 카카오페이 결제 API 연동하기

📅 2025-05-14

📝 학습 내용

---

1️⃣ 카카오페이 API 연동 준비

✅ 카카오 디벨로퍼 설정

1. 카카오 디벨로퍼스 로그인
2. 애플리케이션 생성
3. 앱 키 확인 및 발급
   • JavaScript 키
   • REST API 키
   • Admin 키
   • ✅ Secret Key (dev) ← 결제 연동 시 사용
4. 플랫폼 등록
   • 도메인 등록: http://localhost:8090

---

2️⃣ 결제 준비 API 호출 (/kakao/pay/req)

✅ 요청 흐름

• 서버에서 카카오페이 결제 준비 API 호출
• 응답으로 tid와 결제 리다이렉트 URL 획득

✅ 주요 URL

• API 엔드포인트: https://open-api.kakaopay.com/online/v1/payment/ready
• 응답에 포함되는 리다이렉트 URL:
  • next_redirect_pc_url
  • next_redirect_mobile_url
  • android_app_scheme, ios_app_scheme

✅ 컨트롤러 코드

package com.example.demo.C04Kakao;

import lombok.extern.slf4j.Slf4j;
import org.json.simple.JSONObject;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpMethod;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.client.RestTemplate;

@Controller
@Slf4j
@RequestMapping("/kakao/pay")
public class C04KakaoPayController {
    private String SECRET_KEY = "dev secret key 사용"; 

    @GetMapping("/req")
    @ResponseBody
    public void req() {
        log.info("GET /kakao/pay/req...");

        // 1. 요청 URL
        String url = "https://open-api.kakaopay.com/online/v1/payment/ready";

        // 2. 헤더 설정
        HttpHeaders header = new HttpHeaders();
        header.add("Authorization", "SECRET_KEY " + SECRET_KEY);
        header.add("Content-Type", "application/json");

        // 3. 바디 설정 (JSON 형식)
        JSONObject params = new JSONObject();
        params.put("cid", "TC0ONETIME");
        params.put("partner_order_id", "partner_order_id");
        params.put("partner_user_id", "partner_user_id");
        params.put("item_name", "초코파이");
        params.put("quantity", "1");
        params.put("total_amount", "2200");
        params.put("vat_amount", "200");
        params.put("tax_free_amount", "0");
        params.put("approval_url", "http://localhost:8090/kakao/pay/success");
        params.put("fail_url", "http://localhost:8090/kakao/pay/fail");
        params.put("cancel_url", "http://localhost:8090/kakao/pay/cancel");

        // 4. 요청 보내기
        HttpEntity<JSONObject> entity = new HttpEntity<>(params, header);
        RestTemplate rt = new RestTemplate();
        ResponseEntity<String> response = rt.exchange(url, HttpMethod.POST, entity, String.class);

        // 5. 응답 출력
        System.out.println(response);
    }

    // 결제 성공 시
    @GetMapping("/success")
    @ResponseBody
    public void success() {
        log.info("GET /kakao/pay/success...");
    }

    // 결제 실패 시
    @GetMapping("/fail")
    @ResponseBody
    public void fail() {
        log.info("GET /kakao/pay/fail...");
    }

    // 결제 취소 시
    @GetMapping("/cancel")
    @ResponseBody
    public void cancel() {
        log.info("GET /kakao/pay/cancel...");
    }
}

---

🔹 콘솔 응답 예시

{
  "tid": "T823e8ef555b0f374b0d",
  "next_redirect_pc_url": "https://online-payment.kakaopay.com/mockup/bridge/pc/pg/one-time/payment/...",
  "next_redirect_mobile_url": "...",
  "android_app_scheme": "...",
  "ios_app_scheme": "..."
}

• 브라우저에서 http://localhost:8090/kakao/pay/req를 호출하면 위와 같은 응답을 확인할 수 있음
• 실제 서비스에서는 response.getBody()에서 URL을 추출해 사용자에게 리다이렉트 처리를 해야 함

---

🔥 정리

• 카카오페이 결제는 2단계로 진행됨
  1. 결제 준비 API 요청 → tid, redirect_url 수신
  2. 결제 승인 API에서 pg_token 사용해 최종 결제 처리
• 현재는 결제 준비 단계까지 구현됨 (승인 요청은 추후 구현)

---

🔗 참고 자료

• 카카오페이 결제 가이드 공식 문서

---