Main API결제 API
POST /ai/payments/collab/{collabNo}/cancel
캠페인 결제 취소
캠페인 결제 취소
캠페인 결제를 취소하고 환불 처리합니다.
환불 조건
- 크리에이터 모집 시작 전까지만 100% 환불 가능합니다.
- 모집이 시작된 이후에는 환불이 불가능합니다.
- 환불 시 크레딧이 차감되고 캠페인 상태가 변경됩니다.
| 항목 | 값 |
|---|---|
| 메서드 | POST |
| 경로 | /ai/payments/collab/{collabNo}/cancel |
| 인증 | 필요 |
요청
POST /ai/payments/collab/123/cancel HTTP/1.1
Host: api.glowb.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
Content-Type: application/json
{
"cancelReason": "캠페인 기획 변경으로 인한 취소"
}curl -X POST "https://api.glowb.com/ai/payments/collab/123/cancel" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '{
"cancelReason": "캠페인 기획 변경으로 인한 취소"
}'const response = await fetch(`/ai/payments/collab/${collabNo}/cancel`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${accessToken}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
cancelReason: '캠페인 기획 변경으로 인한 취소'
})
});
const result = await response.json();Path Parameters
Prop
Type
Request Body 스키마
Prop
Type
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "결제 취소 성공",
"data": {
"status": "success",
"message": "결제가 취소되었습니다.",
"httpStatusCode": 200
}
}응답 스키마
Prop
Type
에러 응답
| 상태 코드 | 에러 코드 | 설명 |
|---|---|---|
| 400 | CANCEL_FAILED | 결제 취소 실패 |
| 400 | RECRUITMENT_ALREADY_STARTED | 모집이 이미 시작되어 취소 불가 |
| 404 | CAMPAIGN_NOT_FOUND | 캠페인을 찾을 수 없음 |
| 404 | PAYMENT_NOT_FOUND | 결제 정보를 찾을 수 없음 |
| 500 | INTERNAL_SERVER_ERROR | 서버 오류 |
{
"status": 400,
"code": "RECRUITMENT_ALREADY_STARTED",
"message": "크리에이터 모집이 이미 시작되어 환불이 불가능합니다.",
"data": null
}환불 처리 흐름
- 캠페인 상태 확인 (모집 시작 전인지 검증)
- 결제 정보 조회
- CandyPay 환불 API 호출
- 크레딧 차감 처리
- 캠페인 상태 변경
- 환불 이력 저장