SaaS API기업 주도 캠페인 플로우
결제 요청
기업이 가이드라인 초안 작성 후 결제를 요청합니다. UNPAID → PAYMENT_PENDING 전환 및 영업팀 슬랙 알림.
결제 요청
기업 주도(BUSINESS_DIRECT) 캠페인에서 기업이 가이드라인 초안 작성을 마친 뒤 결제를 요청합니다.
결제 상태를 UNPAID → PAYMENT_PENDING 으로 전환하고, 결제-정산 알리미 슬랙 채널(slack.payment-alert.channel-id)에 알림을 발송합니다.
기존 영업팀 결제 요청 API(POST /ai/campaign-payment-request/{campaignNo})와 다른 API 입니다.
그쪽은 관리자가 이미 결제미완으로 등록한 기존 플로우 캠페인에 대해 처리를 재촉하는 알림이고,
이 API 는 기업 주도 플로우의 최초 결제 요청입니다. 혼용하지 마세요.
HTTP 요청
POST /ai/business-direct/{campaignNo}/payment-request
Authorization: Bearer {access_token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
campaignNo | Integer | 예 | 캠페인 번호 |
Request Body 는 없습니다.
호출 조건
| 조건 | 설명 |
|---|---|
| 캠페인 플로우 | flowType 이 BUSINESS_DIRECT 여야 함 |
| 권한 | 캠페인 소유 기업 계정 (대행사는 담당 고객사 캠페인 접근 가능) |
| 가이드라인 | 초안 이상 작성됨 (guidelineStatus 가 null 이 아님) |
| 결제 상태 | PAID 가 아니어야 함 |
동작
| 호출 시점 결제 상태 | 결과 |
|---|---|
UNPAID | PAYMENT_PENDING 으로 전환 + 슬랙 알림 발송 |
PAYMENT_PENDING | 상태 유지, 슬랙 알림만 재발송 (재요청) — 접두어 [재요청] 이 붙음 |
PAID | 400 BD_003 오류 |
슬랙 발송에 실패해도 상태 전환은 롤백되지 않고 200 을 반환합니다. 결제 요청 사실은 관리자 결제미완 목록에 이미 반영되므로, 알림 실패가 요청 자체를 무효화하지 않습니다.
전환 이후 해당 캠페인은 관리자의 결제미완 캠페인 목록에 자동으로 노출됩니다.
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "결제 요청이 전달되었습니다.",
"data": null
}에러 응답
| 상태 코드 | code | 설명 | 프런트 처리 |
|---|---|---|---|
400 | BD_001 | 기업 주도 플로우 캠페인이 아닙니다. | 버튼이 노출되면 안 되는 상황 — flowType 확인 |
400 | BD_002 | 가이드라인 초안을 먼저 작성해주세요. | 가이드라인 작성 화면으로 유도 |
400 | BD_003 | 이미 결제가 완료된 캠페인입니다. | 화면 새로고침 (상태 동기화 어긋남) |
400 | INVALID_DATA | 결제 정보가 없는 캠페인입니다. | 관리자 문의 안내 |
403 | AUTH_002 | 접근 권한이 없습니다. | 권한 오류 처리 |
404 | INVALID_COLLAB | 존재하지 않는 캠페인입니다. | 목록으로 이동 |
에러 응답 형식은 공통 규격을 따릅니다.
{
"status": 400,
"code": "BD_002",
"message": "가이드라인 초안을 먼저 작성해주세요.",
"data": null
}호출 후 화면 갱신
호출 성공 시 진행표 조회 API 를 다시 불러 paymentStatus 가 PAYMENT_PENDING 으로 바뀐 것을
확인하고 단계 표시를 갱신하세요. 이 API 는 갱신된 캠페인 정보를 반환하지 않습니다.