회차 목록

구독 계약에 따라 자동 생성되는 결제 회차 목록을 조회하는 API입니다.

회차는 결제 예정일 1~2일 전에 자동 생성됩니다.

GET

https://api.bootapi.com/v1/order_subscription_bills

회차(Bill) 개념

구독 주기(매주, 매월 등)에 따라 자동 생성
구독 계약의 설정 가격 기준으로 금액 결정
필요시 금액 조정(Adjustment) 가능

ℹ️

회차 상태 코드

-1결제 실패

1결제 완료

2결제 대기중

-2회차 취소됨

5결제 지연

6결제 실패 후 재시도 대기

10관리자 취소

20해지로 인한 취소

1

Server

SDK 설치

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

SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.

2

Server

회차 목록 조회

구독 계약 ID로 해당 계약의 회차 목록을 조회합니다.

요청 필드

필드명

타입

필수

설명

order_subscription_id

string

구독 계약 고유 번호 (없으면 전체 조회)

status

array<number>

회차 상태 필터 (-1: 결제실패, 1: 결제완료, 2: 대기중 등)

keyword

string

검색 키워드 (invoice_id 검색)

page

number

페이지 번호

limit

number

페이지당 데이터 수

3

Server

응답 처리

회차 목록과 전체 개수를 확인합니다.

응답 필드

필드명

타입

설명

list

array

회차 목록 배열

list[].order_subscription_bill_id

string

회차 고유 ID

list[].duration

number

회차 번호

list[].price

number

회차 결제 금액

list[].status

number

회차 상태

list[].service_start_at

string

서비스 시작일

list[].service_end_at

string

서비스 종료일

count

number

전체 회차 수

언어