sequenceDiagram
    actor Customer as 고객
    participant Merchant as 가맹점 서버
    participant NICEPAY as NICEPAY 서버
    participant CardCo as 카드사

    Customer->>Merchant: 1. 정기결제 서비스 신청
    Merchant->>Customer: 2. 약관 동의 요청<br/>(개인정보 수집/이용)
    Customer->>Merchant: 3. 약관 동의 + 결제정보 입력<br/>(카드번호, 유효기간, 생년월일, 카드PW)

    rect rgb(255, 240, 245)
        Note over Merchant: 🔐 결제정보 암호화
        Merchant->>Merchant: 4. encData 생성<br/>AES128(secretKey 앞16자리) or<br/>AES256(secretKey 32자, IV 16자)
    end

    Merchant->>NICEPAY: 5. 빌키 발급 요청<br/>POST /v1/subscribe/regist<br/>{encData, orderId, encMode}

    NICEPAY->>NICEPAY: 6. encData 복호화
    NICEPAY->>CardCo: 7. 카드 유효성 확인
    CardCo-->>NICEPAY: 8. 유효성 확인 결과

    alt 유효한 카드
        NICEPAY->>NICEPAY: 9. BID 생성<br/>BIKY + 30자 고유 ID
        NICEPAY-->>Merchant: 10. 빌키 발급 성공<br/>{bid, tid, cardCode, cardName}
        Merchant->>Merchant: 11. BID 저장 (DB)<br/>고객ID와 매핑
        Merchant->>Customer: 12. 구독 등록 완료 안내
    else 유효하지 않은 카드
        NICEPAY-->>Merchant: 10. 빌키 발급 실패
        Merchant->>Customer: 12. 등록 실패 안내
    end

sequenceDiagram
	actor Customer as 고객
	participant Scheduler as 스케줄러
	participant Merchant as 가맹점 서버
	participant DB as 가맹점 DB
	participant NICEPAY as NICEPAY 서버
	participant CardCo as 카드사

    Scheduler->>Merchant: 1. 결제일 도래 트리거<br/>(매월 1일, 매주 월요일 등)
    Merchant->>DB: 2. 결제 대상 조회<br/>(BID, 고객정보, 결제금액)
    DB-->>Merchant: 3. 결제 대상 목록

    loop 각 고객별
        Merchant->>NICEPAY: 4. 빌키 승인 요청<br/>POST /v1/subscribe/{bid}/payments<br/>{orderId, amount, goodsName}

        NICEPAY->>CardCo: 5. 결제 승인 요청
        CardCo-->>NICEPAY: 6. 승인 결과

        alt 승인 성공
            NICEPAY-->>Merchant: 7. 승인 성공<br/>{tid, status:paid, approveNo}
            Merchant->>DB: 8. 결제 내역 저장<br/>(TID, 승인번호, 결제일시)
            Merchant->>Customer: 9. 결제 완료 알림<br/>(이메일/SMS)
        else 승인 실패
            NICEPAY-->>Merchant: 7. 승인 실패<br/>{resultCode, resultMsg}
            Merchant->>DB: 8. 실패 내역 기록
            Merchant->>Customer: 9. 결제 실패 안내<br/>결제수단 확인 요청
        end
    end

sequenceDiagram
    actor Customer as 고객
    participant Merchant as 가맹점 서버
    participant DB as 가맹점 DB
    participant NICEPAY as NICEPAY 서버

    Customer->>Merchant: 1. 구독 해지 요청
    Merchant->>DB: 2. 고객의 BID 조회
    DB-->>Merchant: 3. BID 정보

    Merchant->>NICEPAY: 4. 빌키 삭제 요청<br/>POST /v1/subscribe/{bid}/expire<br/>{orderId}

    NICEPAY->>NICEPAY: 5. BID 만료 처리
    NICEPAY-->>Merchant: 6. 삭제 완료<br/>{resultCode:0000, bid}

    Merchant->>DB: 7. BID 삭제/만료 상태 업데이트
    Merchant->>Customer: 8. 구독 해지 완료 안내

    Note over NICEPAY: ⚠️ 삭제된 BID로는<br/>더 이상 승인 불가