| name | payment-integration |
| description | 결제/정산 API 통합 (참조용 — 금융 업무 제외) |
Payment Integration — 결제 참조 가이드
사용 시기
- "결제", "PG", "정산", "매출 조회" 요청 시
주의사항
이 프로젝트에서 금융 업무(결제 처리)는 직접 구현하지 않음.
마켓플레이스 API를 통한 정산 조회/매출 데이터 수집만 해당.
지원 범위
포함
- 마켓플레이스별 정산 데이터 조회
- 매출/수수료/정산금 대시보드
- 정산 내역 다운로드 (XLSX)
제외 (직접 구현하지 않음)
- PG 결제 처리
- 결제 수단 등록
- 환불 처리
- 송금/이체
정산 데이터 모델
settlements
├── marketplace (출처)
├── period_start / period_end (정산 기간)
├── total_sales (총 매출)
├── commission (수수료)
├── shipping_fee (배송비)
├── net_amount (정산 금액)
├── status (대기/완료)
└── details (상세 내역 JSON)
칸반 연동 (필수)
이 스킬 실행 시 반드시 칸반보드에 기록한다.
실행 전:
curl -X POST http://localhost:5555/api/teams/{team_id}/tickets -H "Content-Type: application/json" -d '{"title":"스킬 실행: payment-integration","priority":"medium"}'
curl -X PUT http://localhost:5555/api/tickets/{ticket_id}/claim -H "Content-Type: application/json" -d '{"member_id":"agent-xxx"}'
curl -X PUT http://localhost:5555/api/tickets/{ticket_id}/progress -H "Content-Type: application/json" -d '{"note":"스킬 실행 시작"}'
실행 후:
curl -X POST http://localhost:5555/api/tickets/{ticket_id}/artifacts -H "Content-Type: application/json" -d '{"creator_member_id":"agent-xxx","title":"결과","content":"...","artifact_type":"result"}'
curl -X PUT http://localhost:5555/api/tickets/{ticket_id}/status -H "Content-Type: application/json" -d '{"status":"Review"}'