Main API결제 API
GET /ai/payments/credits/history
크레딧 내역 조회
크레딧 내역 조회
기업의 크레딧 사용 및 충전 내역을 조회합니다.
현재 잔액과 함께 모든 크레딧 거래 내역을 최신순으로 반환합니다.
| 항목 | 값 |
|---|---|
| 메서드 | GET |
| 경로 | /ai/payments/credits/history |
| 인증 | 필요 (기업 토큰) |
요청
GET /ai/payments/credits/history HTTP/1.1
Host: api.glowb.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...curl "https://api.glowb.com/ai/payments/credits/history" \
-H "Authorization: Bearer {access_token}"const response = await fetch('/ai/payments/credits/history', {
headers: {
'Authorization': `Bearer ${accessToken}`
}
});
const result = await response.json();응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "크레딧 내역 조회 성공",
"data": {
"remainCredit": 500000,
"transactions": [
{
"id": 10,
"transactionType": "PAYMENT",
"transactionTypeName": "결제 충전",
"amount": 100000,
"balanceAfter": 500000,
"collabNo": 123,
"candyPaymentId": "intent_1234567890",
"description": "캠페인 결제",
"createdAt": "2024-01-15T10:30:00",
"createdBy": "user123",
"refundable": true,
"refundableReason": "모집 시작 전 - 환불 가능"
},
{
"id": 9,
"transactionType": "CREDIT_USE",
"transactionTypeName": "크레딧 사용",
"amount": -50000,
"balanceAfter": 400000,
"collabNo": 122,
"candyPaymentId": null,
"description": "크레딧 사용",
"createdAt": "2024-01-14T15:20:00",
"createdBy": "user123",
"refundable": null,
"refundableReason": null
},
{
"id": 8,
"transactionType": "PAYMENT",
"transactionTypeName": "결제 충전",
"amount": 100000,
"balanceAfter": 450000,
"collabNo": null,
"candyPaymentId": "intent_0987654321",
"description": "순수 크레딧 충전",
"createdAt": "2024-01-13T09:00:00",
"createdBy": "user123",
"refundable": true,
"refundableReason": "환불 가능"
}
]
}
}응답 스키마
Prop
Type
Transaction 스키마
Prop
Type
환불 가능 여부 (refundable)
| 충전 유형 | 조건 | refundable | refundableReason |
|---|---|---|---|
| 캠페인 결제 | 모집 시작 전 | true | "모집 시작 전 - 환불 가능" |
| 캠페인 결제 | 모집 시작 후 | false | "모집이 시작되어 환불 불가" |
| 순수 크레딧 충전 | - | true | "환불 가능" |
| 기타 거래 | - | null | null |
환불 가능 단계
CAMPAIGN_REVIEW(캠페인 검토)CAMPAIGN_PAYMENT(캠페인비 결제)CAMPAIGN_GUIDELINE(가이드라인 작성)
CREATOR_RECRUIT (크리에이터 모집) 단계 이후에는 환불이 불가능합니다.
거래 유형 (transactionType)
| 유형 | 설명 | 금액 부호 |
|---|---|---|
PAYMENT | 결제 충전 | 양수 (+) |
REFUND | 환불 | 음수 (-) |
CREDIT_USE | 크레딧 사용 | 음수 (-) |
CREDIT_ADD | 관리자 추가 | 양수 (+) |
CREDIT_DEDUCT | 관리자 차감 | 음수 (-) |
에러 응답
| 상태 코드 | 에러 코드 | 설명 |
|---|---|---|
| 400 | INVALID_USER | 기업 정보를 찾을 수 없음 |
| 401 | UNAUTHORIZED | 인증 토큰 없음 또는 만료 |
| 500 | INTERNAL_SERVER_ERROR | 서버 오류 |
{
"status": 400,
"code": "INVALID_USER",
"message": "기업 정보를 찾을 수 없습니다",
"data": null
}