DEVELOPERS · REFERENCE엔드포인트와 이벤트,
엔드포인트와 이벤트,
전부 여기에.
API 엔드포인트
| METHOD | PATH | 설명 |
|---|---|---|
| POST | /api/v1/orders | 주문 생성 — 금액·주문명·sourceApp |
| GET | /api/v1/orders/{id} | 주문 상태와 결제 결과 조회 |
| POST | /api/v1/payments/confirm | 결제 승인 (PG paymentKey 교환) |
| POST | /api/v1/payments/{id}/refund | 전액 · 부분 환불 |
| GET | /api/v1/billing/balance | 크레딧 잔액 조회잔액은 항상 0 — 충전이 제공되지 않습니다 |
| POST | /api/v1/billing/debit | 크레딧 차감 (멱등)현재 제공하지 않음 · 403 credits_disabled |
| GET | /api/v1/subscriptions | 이용권 목록과 만료 예정일 |
| POST | /api/v1/cash-receipts | 현금영수증 발급 |
전체 목록과 요청 · 응답 스키마는 API 레퍼런스 문서에 있습니다.
WEBHOOK 이벤트
- budget.alert.triggered
- credit.consumed
- credit.refunded
- credit.topped_up
- entitlement.granted
- entitlement.revoked
- payment.completed
- payment.failed
- payment.partial_refunded
- payment.refunded
- subscription.cancelled
- subscription.created
- subscription.paused
- subscription.plan_changed
- subscription.renewal_failed
- subscription.renewed
- subscription.resumed
- wallet.balance_low
01
인증 · 서비스 키
서버에서 X-Api-Key 헤더로 mpsk_ 키를 보냅니다. 브라우저에 노출하지 마세요.
02
사용자 컨텍스트
X-User-Id 헤더로 Connect SSO 에서 검증한 사용자 ID 를 전달합니다.
03
서명 검증
웹훅은 서명 헤더로 검증합니다. 검증 실패 요청은 즉시 4xx 로 거절하세요.
04
Dead letter 재처리
전달 실패한 이벤트는 큐에 남고, 어드민 화면에서 재처리할 수 있습니다.