Main API결제 API
결제 API 개요
CandyPay 결제 처리 API
결제 API
CandyPay를 통한 결제 처리 API입니다.
Base URL: /ai/payments
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 예 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /ai/payments/confirm | 결제 승인 | 필요 |
POST | /ai/payments/collab/confirm | Collab 결제 승인 | 필요 |
GET | /ai/payments/{paymentKey} | 결제 정보 조회 | 필요 |
결제 플로우
결제 준비
프론트엔드에서 CandyPay SDK로 결제 UI를 호출합니다.
결제 정보 입력
사용자가 결제 정보를 입력하고 결제를 진행합니다.
결제 승인 요청
CandyPay에서 반환된 paymentKey와 orderId로 /ai/payments/confirm API를 호출합니다.
결제 완료
서버에서 결제를 승인하고 주문 정보를 저장합니다.
결제 상태
| 상태 | 설명 |
|---|---|
READY | 결제 대기 |
IN_PROGRESS | 결제 진행중 |
DONE | 결제 완료 |
CANCELED | 결제 취소 |
FAILED | 결제 실패 |
결제 실패 시 모든 실패 정보는 TB_CANDY_PAYMENT_FAILURE 테이블에 자동으로 로깅됩니다.