인증 방식
🔑 API Key
요금
거래 수수료 1.5~3% (협의)
Base URL
open-api.kakaopay.com
태그
결제, 카카오페이
서비스 소개
카카오페이 API는 카카오톡 앱 내 간편결제 서비스입니다. 단건 결제뿐 아니라 정기결제(구독 서비스), 자동결제를 지원합니다. 카카오 계정과 연동되어 별도 회원가입 없이 결제가 가능하며, 모바일 UX가 매우 우수합니다.
🚀 시작하기
- 1
카카오페이 가맹점 신청
developers.kakaopay.com → 가맹점 신청 → 사업자 서류 제출
- 2
테스트 키 발급
심사 전 테스트 키로 개발 시작 가능
- 3
CID·Secret Key 발급
가맹점 코드(CID)와 Admin Key 발급
- 4
결제 준비 → 승인 플로우
단건결제: 결제 준비(서버) → 카카오 결제 페이지(클라이언트) → 결제 승인(서버)
📋 응답 예시
{
"tid": "T469b847306d7b2dc394",
"next_redirect_pc_url": "https://online-pay.kakao.com/...",
"next_redirect_mobile_url": "https://online-pay.kakao.com/...",
"created_at": "2024-01-15T21:00:00"
}💡 코드 예제
JavaScriptNode.js (결제 준비)
const CID = 'TC0ONETIME' // 테스트용
const ADMIN_KEY = process.env.KAKAOPAY_ADMIN_KEY!
async function readyPayment(orderId: string, userId: string, itemName: string, amount: number) {
const res = await fetch('https://open-api.kakaopay.com/online/v1/payment/ready', {
method: 'POST',
headers: {
'Authorization': `SECRET_KEY ${ADMIN_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
cid: CID,
partner_order_id: orderId,
partner_user_id: userId,
item_name: itemName,
quantity: 1,
total_amount: amount,
tax_free_amount: 0,
approval_url: `${process.env.NEXT_PUBLIC_URL}/payment/success`,
fail_url: `${process.env.NEXT_PUBLIC_URL}/payment/fail`,
cancel_url: `${process.env.NEXT_PUBLIC_URL}/payment/cancel`,
}),
})
return res.json() // next_redirect_pc_url로 리다이렉트
}