요청 승인
고객의 구독 요청을 승인 처리하는 API입니다.
관리자는 수수료 조정, 코멘트 작성 후 승인할 수 있으며, 사용자 확인이 필요한 경우 추가 확정을 요청합니다.
POST
https://api.bootapi.com/v1/order_subscription_requests/:request_history_id/approve
관리자 권한 필요
이 API는 supervisor 권한이 필요합니다. 관리자 토큰으로 요청해주세요.
승인 처리 방식
- 해지 요청 - 해지 수수료 검토 및 조정 후 승인
- 중도 인수 요청 - 인수 금액 검토 및 조정 후 승인
- 이전/승계 요청 - 계약 주체 변경 승인
- 승인 시 관리자 코멘트 기록 가능
- 사용자 확인 필요 시 알림 발송
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
요청 승인
요청을 검토하고 승인 처리합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
request_history_id | string | 필수 | 승인할 요청 고유 ID (URL 파라미터) |
adjusted_fee | number | 조정된 수수료 (기본값: 자동 계산된 수수료) | |
admin_comment | string | 관리자 코멘트 (내부 메모) | |
require_user_confirmation | boolean | 사용자 확인 필요 여부 (기본값: true) |
3
Server
응답 처리
승인 결과와 변경된 상태를 확인합니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
request_history_id | string | 요청 고유 ID |
status | integer | 변경된 상태 (1: 사용자확인대기, 2: 승인완료) |
adjusted_fee | number | 최종 적용된 수수료 |
admin_comment | string | 관리자 코멘트 |
approved_at | datetime | 승인 처리 시각 |
approved_by | string | 승인 처리자 ID |
