인증 방식
🔑 API Key
요금
2.9% + $0.30/건 (국내 카드 추가 수수료)
Base URL
api.stripe.com/v1
태그
결제, Stripe
서비스 소개
Stripe는 전 세계 개발자가 가장 많이 사용하는 결제 API입니다. 신용카드, Apple Pay, Google Pay, Alipay 등 다양한 결제 수단을 단일 API로 지원합니다. 구독 관리, 웹훅, 결제 분석 등 결제에 필요한 모든 기능을 제공합니다.
🚀 시작하기
- 1
Stripe 계정 생성
dashboard.stripe.com → 계정 생성 (테스트 키 즉시 발급)
- 2
SDK 설치
npm install stripe (서버) — 클라이언트 키는 불필요 (Checkout 방식)
- 3
Checkout Session 생성
서버에서 Checkout Session 생성 → 클라이언트에서 URL로 리다이렉트
- 4
웹훅 설정
결제 완료 이벤트를 서버로 받아 DB 업데이트 (선택사항)
📋 응답 예시
{
"id": "cs_test_a1...",
"object": "checkout.session",
"payment_status": "paid",
"amount_total": 2900,
"currency": "usd",
"customer_email": "user@example.com",
"metadata": { "userId": "123", "plan": "pro" }
}💡 코드 예제
JavaScriptNext.js API Route
import Stripe from 'stripe'
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
apiVersion: '2026-05-27.dahlia',
})
// 결제 세션 생성
export async function POST(req: Request) {
const { priceId, userId } = await req.json()
const session = await stripe.checkout.sessions.create({
mode: 'payment', // 또는 'subscription'
payment_method_types: ['card'],
line_items: [{
price_data: {
currency: 'usd',
product_data: { name: 'Pro 플랜' },
unit_amount: 2900, // $29.00
},
quantity: 1,
}],
metadata: { userId },
success_url: `${process.env.NEXT_PUBLIC_URL}/payment/success?session_id={CHECKOUT_SESSION_ID}`,
cancel_url: `${process.env.NEXT_PUBLIC_URL}/payment/cancel`,
})
return Response.json({ url: session.url })
}PythonPython (FastAPI)
import stripe
stripe.api_key = "sk_test_..."
session = stripe.checkout.Session.create(
mode="payment",
line_items=[{
"price_data": {
"currency": "usd",
"product_data": {"name": "Pro Plan"},
"unit_amount": 2900,
},
"quantity": 1,
}],
success_url="https://yoursite.com/success?session_id={CHECKOUT_SESSION_ID}",
cancel_url="https://yoursite.com/cancel",
)
print(session.url) # 이 URL로 리다이렉트