SaaS API
Campaign Payment Request API
결제미완 캠페인의 영업팀 결제 요청 (기업용)
Campaign Payment Request API
결제미완(PAYMENT_PENDING) 상태인 캠페인에 대해 기업이 영업팀에 결제 처리를 요청합니다.
호출 시 슬랙 캠페인알리미 채널에 영업팀 멘션 메시지가 발송됩니다.
Base URL: /ai/campaign-payment-request
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 예 |
| 인증 방식 | JWT Bearer Token |
| 권한 | 캠페인 소유 기업 본인 |
엔드포인트 목록
| 메서드 | 경로 | 설명 |
|---|---|---|
POST | /ai/campaign-payment-request/{campaignNo} | 영업팀 결제 요청 |
API 상세
영업팀 결제 요청
결제미완(PAYMENT_PENDING) 캠페인에 대해 영업팀에 결제 처리를 요청합니다.
HTTP 요청
POST /ai/campaign-payment-request/{campaignNo}
Authorization: Bearer {access_token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
campaignNo | Long | 예 | 캠페인 번호 |
전제 조건
- 호출자가 해당 캠페인의 소유 기업이어야 함 (Collab.id == 인증 사용자)
- 캠페인이
PAYMENT_PENDING상태여야 함 - 서버에
slack.sales-payment.channel-id설정이 되어 있어야 함
동작
- 캠페인 조회 + 소유권 검증.
- verification 행이 존재하고
paymentStatus == PAYMENT_PENDING인지 검증. - 캠페인 담당자 결정 (N:M, 동등) — 캠페인에 연결된 담당자 전원을 나열한다.
- 캠페인에 연결된 담당자가 없으면 fallback:
BusinessManager.isDefault=true기본 담당자 →Business.managerName / email / tel.
- 캠페인에 연결된 담당자가 없으면 fallback:
- 슬랙 채널(
slack.sales-payment.channel-id)에 영업팀 멘션(slack.sales-payment.mention-user-ids) 포함 메시지 발송. 담당자는 전원 나열된다.
슬랙 메시지 예시
<@U08FBTUGPUG> <@U0A0G8L6GJ3>
결제 미완된 캠페인 "여름 뷰티 캠페인" 에서 결제 요청 문의가 왔습니다.
결제 처리 여부를 반드시 확인하시고
어드민에서 결제처리를 완료해주세요.
기업 정보 :
- 기업: 바이아트
- 담당자: 홍길동
- 이메일: hong@example.com
- 휴대폰: 010-1234-5678
- 담당자: 김담당
- 이메일: kim@example.com
- 휴대폰: 010-2222-3333
어드민 화면 바로가기: https://admin.glowb.io/campaigns응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "영업팀에 결제 요청이 전달되었습니다.",
"data": null
}에러 응답 - 권한 없음 (403)
{
"status": 403,
"code": "AUTH_002",
"message": "접근 권한이 없습니다.",
"data": null
}에러 응답 - 결제미완 상태가 아님 (404)
{
"status": 404,
"code": "INVALID_DATA",
"message": "결제미완 상태인 캠페인이 아닙니다.",
"data": null
}에러 응답 - 슬랙 발송 실패 (500)
{
"status": 500,
"code": "SERVER_ERROR",
"message": "슬랙 발송에 실패했습니다.",
"data": null
}운영 설정
| 환경변수 | 설명 | 예시 |
|---|---|---|
SLACK_SALES_PAYMENT_CHANNEL_ID | 발송 대상 슬랙 채널 ID | C09UB5BBVAQ |
SLACK_SALES_PAYMENT_MENTION_USER_IDS | 멘션할 영업팀 Slack User ID (CSV) | U08FBTUGPUG,U0A0G8L6GJ3 |