SaaS API
Campaign Payment API
캠페인 결제 내역 관련 API
Campaign Payment API
캠페인 결제 내역 조회 API입니다.
Base URL: /ai/campaign-payments
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 예 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
GET | /ai/campaign-payments | 캠페인 결제 내역 조회 | 필요 |
API 상세
캠페인 결제 내역 조회
로그인한 기업의 모든 캠페인 결제 내역을 조회합니다.
HTTP 요청
GET /ai/campaign-payments
Authorization: Bearer {access_token}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "캠페인 결제 내역 조회가 성공하였습니다.",
"data": [
{
"paymentId": 1,
"campaignId": 123,
"campaignName": "여름 뷰티 캠페인",
"amount": 5000000,
"paymentMethod": "CARD",
"status": "COMPLETED",
"paidAt": "2024-01-15T10:30:00"
},
{
"paymentId": 2,
"campaignId": 124,
"campaignName": "패션 브랜드 협업",
"amount": 3000000,
"paymentMethod": "TRANSFER",
"status": "COMPLETED",
"paidAt": "2024-01-20T14:00:00"
}
]
}Response 스키마 (CampaignPaymentResponseDto)
| 필드명 | 타입 | 설명 |
|---|---|---|
paymentId | long | 결제 ID |
campaignId | long | 캠페인 ID |
campaignName | string | 캠페인명 |
amount | long | 결제 금액 |
paymentMethod | string | 결제 수단 |
status | string | 결제 상태 |
paidAt | datetime | 결제 일시 |
결제 상태
| 상태 | 설명 |
|---|---|
PENDING | 결제 대기 |
COMPLETED | 결제 완료 |
FAILED | 결제 실패 |
REFUNDED | 환불됨 |
결제 수단
| 수단 | 설명 |
|---|---|
CARD | 카드 결제 |
TRANSFER | 계좌이체 |
GIFT_CERTIFICATE | 상품권 |
사용 예시
curl -X GET https://api.glowb.io/ai/campaign-payments \
-H "Authorization: Bearer {token}"