커머스 Enum | Bootpay 커머스 매뉴얼

Commerce API(주문, 링크페이, 구독 등)에서 사용하는 상태 코드값 목록이에요.

이럴 때 필요해요: 주문·구독·링크페이 API 응답에서 상태 코드를 확인할 때

API 요청 필터와 응답은 모두 정수 값을 주고받아요. 아래 표의 키는 값을 설명하기 위한 이름이고, 실제로 보내고 받는 건 값 열이에요. 예를 들어 결제 완료 주문만 조회하려면 status=2로 요청해요.

주문 상태

값	키	설명
`0`	`order_pending`	주문 생성, 결제 대기
`1`	`payment_pending`	결제 진행 중
`2`	`payment_completed`	결제 완료
`3`	`subscription_request_completed`	구독 요청 완료
`4`	`subscription_pending`	구독 대기
`5`	`payment_delayed`	결제 지연
`6`	`payment_confirm_ready`	결제 승인 대기
`8`	`purchase_confirmed`	구매 확정
`10`	`cancellation_completed`	취소 완료
`11`	`return_completed`	반품 완료
`12`	`exchange_completed`	교환 완료
`-1`	`order_expired`	주문 만료
`-2`	`payment_failed`	결제 실패
`-3`	`payment_authorization_failed`	결제 승인 실패
`-4`	`subscription_error`	구독 오류
`-5`	`subscription_server_error`	구독 서버 오류
`-100`	`order_abandoned`	주문 포기

주문 유형

값	키	설명
`1`	`invoice`	링크페이(청구서) 주문
`2`	`shop`	쇼핑몰 주문

주문 요청 유형

값	키	설명
`1`	`item`	일반 상품 주문
`2`	`subscription`	구독 주문
`3`	`subscription_requested`	구독 요청 주문

승인 상태

취소 요청·구독 신청 등 승인 흐름에서 공통으로 써요.

값	키	설명
`0`	`approval_pending`	요청 접수, 승인 대기 중
`1`	`approval_requested`	승인 요청
`2`	`approval_approved_auto`	자동 승인
`3`	`approval_approved_manual`	관리자 수동 승인
`-1`	`approval_failed`	승인 실패
`-2`	`approval_rejected`	거절됨
`-3`	`approval_hold_on`	보류

링크페이 상태

링크페이는 주문 상태를 그대로 써요.

값	키	설명
`0`	`order_pending`	링크 생성 후 결제 대기 중
`2`	`payment_completed`	고객이 결제를 완료
`-1`	`order_expired`	유효기간이 지난 링크
`10`	`cancellation_completed`	결제 취소된 링크페이

결제(영수증) 상태

주문 응답의 receipt_status 값이에요.

값	키	설명
`0`	`receipt_ready`	결제 준비
`1`	`receipt_success`	결제 성공
`2`	`receipt_confirm_ready`	승인 대기
`3`	`receipt_confirm_doing`	승인 진행 중
`4`	`receipt_doing`	결제 진행 중
`5`	`receipt_issued`	발행 완료
`11`	`receipt_billing_key_published`	빌링키 발급
`20`	`receipt_cancelled`	결제 취소
`21`	`receipt_cancel_pending`	취소 대기
`-1`	`receipt_fail`	결제 실패
`-2`	`receipt_confirm_fail`	승인 실패
`-3`	`receipt_vbank_cancelled`	가상계좌 취소
`-4`	`receipt_request_failed`	요청 실패
`-5`	`receipt_confirm_critical_fail`	승인 치명적 실패
`-6`	`receipt_confirm_ready_fail`	승인 대기 실패
`-11`	`receipt_billing_key_revoked`	빌링키 해지
`-20`	`receipt_cancel_failed`	취소 실패
`-21`	`receipt_cancel_critial_failed`	취소 치명적 실패

구독 상태

자세한 라이프사이클은 구독 개요를 참고해요.

값	키	설명
`0`	`contract_requested_completed`	구독 신청 완료, 승인 대기
`1`	`subscribing`	구독 중 (정상 결제 진행)
`15`	`auto_terminated`	자동 해지 (기간 만료 등)
`20`	`manual_terminated`	직접 해지 (사용자 요청)
`25`	`mid_term_transfer_approved`	중도 인수 승인
`26`	`mid_term_transfer_requested`	중도 인수 요청
`-1`	`free_trial`	무료 체험
`-2`	`temporarily_paused`	일시정지
`-3`	`paused_due_to_issue`	이슈로 인한 일시정지
`-10`	`first_payment_error`	첫 결제 오류
`-11`	`admin_terminated`	관리자 구독 거절
`-12`	`rejected`	구독 거절

구독 청구(Bill) 상태

구독 회차별 청구 상태예요.

값	키	설명
`1`	`bill_completed`	결제 완료
`2`	`bill_ready`	청구 준비
`5`	`bill_pending`	결제 보류
`6`	`bill_failure_delayed`	결제 실패 후 지연
`10`	`bill_cancelled`	청구 취소
`11`	`bill_paused`	청구 일시정지
`20`	`bill_terminated`	청구 해지
`-1`	`bill_failed`	결제 실패
`-2`	`bill_recreate_cancelled`	재생성 취소
`-11`	`bill_schedule_cancelled_by_payment_failure`	결제 실패로 스케줄 취소
`-100`	`bill_error`	청구 오류

구독 유형

값	키	설명
`1`	`regular_subscription`	정기 구독
`4`	`delivery_subscription`	정기 배송 구독
`5`	`rental_lease_subscription`	렌탈/리스 구독
`6`	`usage_based_subscription`	사용량 기반 구독

구독 결제 주기

값	키	설명
`11`	`1week`	1주
`12`	`2weeks`	2주
`13`	`3weeks`	3주
`14`	`4weeks`	4주
`16`	`6weeks`	6주
`21`	`1month`	1개월
`22`	`2months`	2개월
`23`	`3months`	3개월
`26`	`6months`	6개월
`31`	`1year`	1년

구독 결제 방식

값	키	설명
`0`	`non_subscription`	비구독
`1`	`pay_per_item`	건별 결제
`2`	`pay_all_at_once`	일괄 결제

구독 금액 조정 타입

값	설명
`1`	회차별 할인 적용
`2`	추가금액 (설치비 등)
`3`	주기 할인 적용
`4`	추가 비용 적용
`5`	매회차 추가비용 (모든 할인 적용 후)
`10`	구독 상품 금액 쿠폰
`11`	배송비 쿠폰

상품 유형

값	키	설명
`0`	`general_products`	일반 상품
`1`	`delivery_products`	배송 상품
`2`	`content_products`	콘텐츠 상품
`3`	`mobile_coupons`	모바일 쿠폰
`4`	`reservation_products`	예약 상품
`5`	`online_courses`	온라인 강좌
`7`	`crowdfunding_donation_products`	크라우드펀딩/기부 상품
`8`	`seminars_workshops`	세미나/워크샵
`100`	`all_products`	전체 상품

상품 검수 상태

상품의 status_review 값이에요.

값	키	설명
`0`	`auto_confirm`	자동 승인
`1`	`waiting`	검수 대기
`2`	`pending`	검수 보류
`3`	`confirm`	검수 승인
`4`	`reject`	검수 반려

과세 유형

값	키	설명
`1`	`taxable`	과세
`2`	`compound_taxation`	복합 과세
`3`	`tax_free`	면세
`4`	`zero_taxation`	영세율

배송 유형

값	키	설명
`1`	`parcel`	택배
`2`	`direct`	직접 배송
`3`	`quick`	퀵 서비스
`4`	`pickup`	매장 수령

회원 유형

membership_type — 고객 목록 조회의 필터 값이에요.

값	키	설명
`1`	`member`	회원
`2`	`guest`	비회원

고객 구분 (corporate_type)

개인/기업 구분은 membership_type이 아니라 corporate_type이에요.

값	키	설명
`1`	`personal`	개인
`2`	`business`	기업
`3`	—	부서

결제 수단 유형

값	키	설명
`1`	`card`	카드
`2`	`automatic_transfer`	자동이체

기간 유형

값	키	설명
`1`	`week`	주
`2`	`month`	월
`3`	`year`	년