캠페인 예산 입금

기존 크레딧 잔액에서 차감하여 캠페인 예산에 입금합니다.

이 API는 초기 결제와 추가 입금 모두 처리합니다.

첫 번째 호출: "캠페인 초기 결제"로 기록
이후 호출: "캠페인 추가 입금"으로 기록

이 API는 캔디페이 결제 없이 기존에 충전된 크레딧만 사용합니다. 크레딧 충전은 /ai/payments/credit/confirm을 사용하세요.

항목	값
메서드	`POST`
경로	`/ai/payments/collab/confirm`
인증	필요 (기업 토큰)

요청

POST /ai/payments/collab/confirm HTTP/1.1
Host: api.glowb.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
Content-Type: application/json

{
  "collabNo": 123,
  "amount": 100000
}

curl -X POST "https://api.glowb.com/ai/payments/collab/confirm" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "collabNo": 123,
    "amount": 100000
  }'

const response = await fetch('/ai/payments/collab/confirm', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    collabNo: 123,
    amount: 100000
  })
});
const result = await response.json();

Request Body 스키마

Prop

Type

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "캠페인 결제 성공",
  "data": {
    "collabNo": 123,
    "amount": 100000,
    "remainCredit": 400000,
    "transactionId": 45,
    "status": "SUCCESS",
    "paidAt": "2025-01-15T10:30:00"
  }
}

응답 스키마

Prop

Type

에러 응답

상태 코드	에러 코드	설명
400	`INVALID_USER`	기업 정보를 찾을 수 없음
400	`INVALID_DATA`	캠페인을 찾을 수 없음
400	`INVALID_DATA`	크레딧 잔액 부족
500	`INTERNAL_SERVER_ERROR`	서버 오류

{
  "status": 400,
  "code": "INVALID_DATA",
  "message": "크레딧 잔액이 부족합니다. 현재: 50000, 필요: 100000",
  "data": null
}

결제 처리 흐름

기업 정보 조회 (토큰에서 memberId 추출)
크레딧 잔액 확인 (부족 시 에러 반환)
캠페인 조회
캠페인 상태를 CAMPAIGN_GUIDELINE으로 변경
기존 입금 내역 확인 → description 결정
- 기존 입금 없음: "캠페인 초기 결제"
- 기존 입금 있음: "캠페인 추가 입금"
크레딧 차감 + CAMPAIGN_DEPOSIT 거래 기록 저장
결제 결과 반환

결제 전 반드시 크레딧이 충분히 충전되어 있어야 합니다. 크레딧 충전: POST /ai/payments/credit/confirm

예산 관리

이 API로 입금된 금액은 캠페인 예산으로 관리됩니다:

항목	설명
총 예산	해당 캠페인의 `CAMPAIGN_DEPOSIT` 거래 합계
사용 금액	크리에이터 제안(PROPOSAL) 시 잠긴 금액
가용 예산	총 예산 - 사용 금액

캠페인 완료 시 사용하지 않은 잔액은 자동으로 크레딧으로 환급됩니다.

캠페인 상태 변경

초기 결제 성공 시 캠페인 상태가 자동으로 변경됩니다:

결제 전	결제 후
`CAMPAIGN_PAYMENT`	`CAMPAIGN_GUIDELINE`

추가 입금 시에는 캠페인 상태가 변경되지 않습니다.

POST /ai/payments/collab/confirm