Q. API만으로 플랜 변경이 가능한가요?
네, 가능합니다. 다만 스텝페이는 구독 상품 변경 시 금액을 자동으로 계산하거나 정산하지 않습니다.
구독 항목 변경 시 아래 순서로 진행해주세요.
⚠️ "구독항목교체" API는 사용하지 마시고, 반드시 아래 순서로 호출해주세요.
1. 구독 항목 추가 API 호출 (새 플랜)
2. 구독 항목 삭제 API 호출 (기존 플랜)
Q. 즉시 전환(프로레이션)이 가능한가요?
스텝페이는 자동 프로레이션 기능을 제공하지 않습니다.
구독 항목 변경 API를 호출하면 다음 결제 예정일에 새 플랜으로 변경됩니다.
즉시 전환이 필요하신 경우, 귀사 서버에서 차액을 직접 계산하신 후 아래 스텝페이 API를 별도로 호출하셔야 합니다.
• 업그레이드 차액 즉시 결제: POST /api/v1/subscriptions/{subscriptionId}/additional-pay
• 다운그레이드 차액 환불: 주문 취소 API 사용
※ PG사 API가 아닌 스텝페이 API를 사용해야 합니다.
Q. 차액 결제·환불 후 즉시 상품 전환을 위한 별도 API가 있나요?
별도 API는 없습니다.
이번 구독은 이미 결제가 완료된 상태이므로, 차액 결제 또는 환불 처리 후 가맹점 서비스 내에서 새 플랜에 맞는 상품/권한을 직접 제공해주시면 됩니다.
다음 구독 예정일부터는 변경된 새 플랜으로 자동 결제됩니다.
※ 구독 항목 변경(추가/삭제) API와 차액 결제/환불 API는 각각 별도로 호출하셔야 합니다. 한 번에 처리되지 않습니다.
🔄 권장 처리 플로우
1. 고객이 업그레이드/다운그레이드 요청
2. 귀사 서버에서 남은 기간 및 차액 계산
3. 구독 항목 추가 API 호출 (새 플랜)
4. 구독 항목 삭제 API 호출 (기존 플랜)
5. 즉시 전환 필요 시 → 차액에 대해 추가결제 또는 환불 API 별도 호출
6. 귀사 서비스에서 새 플랜에 맞는 상품/권한 즉시 제공
7. 다음 구독 예정일부터는 자동으로 새 플랜으로 결제됨