SaaS API결제 및 예산
웰컴 크레딧 지급
로그인한 기업에게 결제 없이 계정당 1회 이벤트 크레딧을 지급합니다.
웰컴 크레딧 지급
로그인한 기업에게 결제 없이 계정당 1회 이벤트(웰컴) 크레딧을 지급합니다. 지급된 크레딧은 글로벌 잔액(remainCredit)에 더해지며, 크레딧 거래 내역에도 함께 기록됩니다.
기업 본인(로그인 상태)이 호출하는 셀프서비스 API입니다. JWT의 사용자로 본인 계정을 식별합니다.
HTTP 요청
POST /ai/payments/credit/promotion
Authorization: Bearer {access_token}요청 본문은 필요하지 않습니다. 지급 금액과 프로모션 코드는 서버에서 고정됩니다 (현재 50,000원, 코드 WELCOME).
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "이벤트 크레딧이 지급되었습니다.",
"data": {
"remainCredit": 50000,
"grantedAmount": 50000
}
}응답 필드 설명
| 필드 | 타입 | 설명 |
|---|---|---|
remainCredit | Integer | 지급 후 기업의 글로벌 크레딧 잔액 |
grantedAmount | Integer | 이번에 지급된 금액 (50000) |
에러 응답
| 상태 코드 | 코드 | 설명 |
|---|---|---|
401 | - | 인증 실패 (로그인 필요) |
404 | INVALID_USER | 사용자(기업)를 찾을 수 없음 |
409 | ALREADY_CLAIMED_PROMOTION | 이미 웰컴 크레딧을 받은 계정 |
500 | INTERNAL_SERVER_ERROR | 서버 오류 |
이미 지급받은 계정이 다시 호출하면 잔액 변동 없이 409가 반환됩니다.
{
"status": 409,
"code": "ALREADY_CLAIMED_PROMOTION",
"message": "이미 받은 이벤트 크레딧입니다.",
"data": null
}사용 예시
cURL
curl -X POST "https://api.glowb.com/ai/payments/credit/promotion" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"JavaScript (fetch)
const response = await fetch(
'https://api.glowb.com/ai/payments/credit/promotion',
{
method: 'POST',
headers: {
'Authorization': `Bearer ${accessToken}`,
'Content-Type': 'application/json'
}
}
);
const result = await response.json();
console.log('지급 후 잔액:', result.data.remainCredit);동작 방식
- 로그인한 기업 계정을 식별한 뒤, 이중 지급 방지를 위해 해당 계정 행을 잠급니다.
- 이미 웰컴 크레딧을 받은 이력이 있으면 409를 반환합니다.
- 없으면 글로벌 크레딧을 5만원 증가시키고, 크레딧 거래 내역(
PROMOTION타입)에 기록합니다.
- 계정당 1회만 지급됩니다. 버튼을 빠르게 여러 번 눌러도 1회만 처리됩니다.
- 실제 결제(CandyPay) 없이 무료로 지급되는 프로모션 크레딧입니다.
- 지급 내역은 크레딧 내역 조회 API에서 함께 확인할 수 있습니다.
관련 API
- 캠페인 예산 요약 조회 - 캠페인 예산 현황 조회