결제 매뉴얼커머스 매뉴얼

마이그레이션

기존 다른 솔루션의 구독 계약, 고객, 상품 정보를 부트페이로 한 번에 옮겨오는 API입니다.

CSV 파일을 통해 데이터를 일괄 등록하며, 다음 구독회차부터 자동으로 관리됩니다.

POST
https://api.bootapi.com/v1/migrations
ℹ️
자동 데이터 생성

마이그레이션 시 고객, 상품, 구독 정보가 자동으로 생성됩니다. 미리 등록할 필요가 없습니다.

1
Admin
CSV 파일 준비

CSV 파일에 마이그레이션할 데이터를 작성합니다.

CSV 샘플 파일형식을 확인하고 데이터를 작성하세요

CSV 필수 컬럼

컬럼명
타입
필수
설명
order_number
string
필수
주문번호 (기존 시스템의 주문 식별자)
group
string
필수
"개인" 또는 "그룹"
username
string
필수
고객 이름
phone
string
필수
휴대폰 번호 (01012345678 형식)
email
string
필수
고객 이메일 주소
external_user_id
string
필수
기존 시스템의 고객 고유 식별자
subscription_payment_date
integer
필수
구독 결제일 (1~21 권장)
external_product_id
string
필수
기존 상품 고유 식별자
product_name
string
필수
상품명
product_price
integer
필수
상품 기본 가격
external_order_subscription_id
string
필수
기존 구독 주문 고유 식별자
order_name
string
필수
주문명
price
integer
필수
최종 결제 금액
total_duration
integer
필수
전체 구독 기간 (개월)
duration
integer
필수
현재 회차
quantity
integer
필수
구독 수량
service_start_at
string
필수
서비스 시작일 (YYYY-MM-DD)
2
Server
SDK 설치

서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.

SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
3
Server
마이그레이션 요청

CSV 파일을 업로드하여 마이그레이션을 시작합니다.

요청 필드

필드명
타입
필수
설명
file
file
필수
마이그레이션할 데이터가 포함된 CSV 파일
type
string
필수
마이그레이션 타입 (subscription: 구독 데이터)
4
Server
응답 처리

마이그레이션 결과를 확인합니다.

응답 필드

필드명
타입
설명
migration_id
string
마이그레이션 작업 고유 ID
total_records
integer
CSV 파일의 전체 레코드 수
processed_records
integer
성공적으로 처리된 레코드 수
failed_records
integer
처리 실패한 레코드 수
created
object
생성된 엔티티 수 (users, products, subscriptions)
5
Error
에러 코드
1001
잘못된 파일 형식

CSV 파일만 업로드 가능합니다.

1002
필수 컬럼 누락

CSV 파일에 필수 컬럼이 포함되어야 합니다.

1003
데이터 형식 오류

각 컬럼의 데이터 형식을 확인해주세요.

1004
중복 데이터

동일한 external_user_id 또는 external_product_id가 중복되었습니다.

curl -X POST "https://api.bootapi.com/v1/migrations" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@migration_data.csv" \
  -F "type=subscription"