개념 배경
PG·솔루션 선택과 계약 판단은 블로그에서 다뤄요. 이 페이지는 기술 마이그레이션 순서 한정.
- PG 선정, 무엇을 보고 결정하나요?
- PG 계약, 뭘 확인하고 사인해야 하나요?
- 결제 연동키·SDK 공통 준비는 결제 SDK 시작하기 를 봐요.
기존 다른 솔루션의 구독 계약, 고객, 상품 정보를 부트페이로 한 번에 옮겨와요. CSV 파일을 올리면 데이터가 일괄 등록되고, 다음 구독회차부터 자동으로 관리돼요.
마이그레이션은 Bootpay 관리자에서 진행해요. 별도 API 연동 없이 CSV 업로드만으로 끝나요.
진행 방법
마이그레이션 시 고객, 상품, 구독 정보가 자동으로 생성돼요. 미리 등록할 필요가 없어요.
진입 경로
Bootpay 관리자 → 주문관리 > 구독 이관 관리
업로드
- 우측 상단 CSV 업로드 버튼을 눌러요
- 아래 규격에 맞춘 CSV 파일을 선택하거나 드래그해서 올려요
- 이관 이름은 파일명과 날짜로 자동 채워지고, 직접 바꿀 수 있어요 (필수)
- 메모에 이관 배경을 남겨두면 나중에 목록에서 구분하기 좋아요 (선택)
- 업로드하면 CSV 검증이 먼저 실행되고, 통과한 건부터 이관이 시작돼요
결과 확인
| 화면 | 확인할 수 있는 것 |
|---|---|
| 목록 상단 요약 | 전체 이관 건의 상태별 집계 |
| 목록 | 이관 이름, 상태, 전체·성공·실패 건수 |
| 상세 | 행 단위 처리 로그, 실패 사유(원본 행 데이터 포함) |
검증에 실패한 행이 있으면 이관이 중단되고 상세 화면에 실패 사유가 남아요. CSV를 고쳐 다시 올리거나, 상세에서 재시도로 실패 건만 다시 처리할 수 있어요.
검증에서 아래 값이 비어 있으면 해당 행은 실패로 처리돼요.
external_user_id · username · phone · external_order_subscription_id · price(0원 초과)
CSV 파일 준비
CSV 파일에 마이그레이션할 데이터를 작성해요.
CSV 필수 컬럼
| 컬럼명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| order_number | String | Y | 주문번호 (기존 시스템의 주문 식별자) |
| group | String | Y | "개인" 또는 "그룹" |
| username | String | Y | 고객 이름 |
| phone | String | Y | 휴대폰 번호 (01012345678 형식) |
| String | Y | 고객 이메일 주소 | |
| external_user_id | String | Y | 기존 시스템의 고객 고유 식별자 |
| subscription_payment_date | Integer | Y | 구독 결제일 (1~21 권장) |
| external_product_id | String | Y | 기존 상품 고유 식별자 |
| product_name | String | Y | 상품명 |
| product_price | Integer | Y | 상품 기본 가격 |
| external_order_subscription_id | String | Y | 기존 구독 주문 고유 식별자 |
| order_name | String | Y | 주문명 |
| price | Integer | Y | 최종 결제 금액 |
| total_duration | Integer | Y | 전체 구독 기간 (개월) |
| duration | Integer | Y | 현재 회차 |
| quantity | Integer | Y | 구독 수량 |
| service_start_at | String | Y | 서비스 시작일 (YYYY-MM-DD) |
에러 코드
공통 에러
인증·권한 관련 에러는 커머스 오류코드를 참고해요.