회차 조회

회차 목록 안에 결제 상태·금액과 거래 정보까지 같이 들어 있어요.

구독 계약에 따라 생성된 회차(Bill) 목록을 조회해요. 회차 데이터에는 결제 상태와 금액, 그리고 거래 정보가 포함돼요.

API 엔드포인트

GEThttps://api.bootapi.com/v1/order_subscription_billsBasic Auth

요청 파라미터

파라미터	타입	필수	설명
`order_subscription_id`	String	선택	구독 계약 고유 번호 (없으면 전체 조회)
`status`	String \| Integer \| Array	선택	회차 상태 필터 (숫자 또는 `bill_ready` 같은 키). 여러 값은 `status[]=bill_ready&status[]=bill_failed` 또는 `status=2,-1`로 보내요
`page`	Number	선택	페이지 번호
`limit`	Number	선택	페이지당 데이터 수 (기본 20, 100 을 넘기면 20 으로 돌아가요)

order_subscription_id가 이 프로젝트에 없는 값이면 구독 조건이 빠지고 프로젝트 전체 회차가 조회돼요. 특정 계약의 회차를 보여주려면 계약 상세로 ID를 확인해요.

코드 예제

curl -X GET "https://api.bootapi.com/v1/order_subscription_bills?order_subscription_id={id}&page=1&limit=10" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json"bash

const { BootpayCommerce } = require('@bootpay/backend-js')

const commerce = new BootpayCommerce({
    client_key: '{client_key}',
    secret_key: '{secret_key}'
})

const response = await commerce.orderSubscriptionBill.list({
    order_subscription_id: '687a1b2c3d4e5f6789012345',
    page: 1,
    limit: 10
})
console.log(response)javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
response = commerce.order_subscription_bill_list({
    'order_subscription_id': '687a1b2c3d4e5f6789012345',
    'page': 1,
    'limit': 10
})
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi('{client_key}', '{secret_key}');
$response = $commerce->orderSubscriptionBillList([
    'order_subscription_id' => '687a1b2c3d4e5f6789012345',
    'page' => 1,
    'limit' => 10
]);
print_r($response);php

import kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;
import kr.co.bootpay.store.model.response.BootpayStoreResponse;
import kr.co.bootpay.store.model.request.orderSubscriptionBill.OrderSubscriptionBillListParams;

TokenPayload tokenPayload = new TokenPayload("{client_key}", "{secret_key}");
BootpayStore commerce = new BootpayStore(tokenPayload).withToken();

OrderSubscriptionBillListParams params = new OrderSubscriptionBillListParams();
params.orderSubscriptionId = "687a1b2c3d4e5f6789012345";
params.page = 1;
params.limit = 10;

BootpayStoreResponse response = commerce.orderSubscriptionBill.list(params);
System.out.println(response);java

require 'bootpay'

commerce = BootpayStore::RestClient.new(client_key: '{client_key}', secret_key: '{secret_key}')
response = commerce.order_subscription_bill_list(
  order_subscription_id: '687a1b2c3d4e5f6789012345',
  page: 1,
  limit: 10
)
puts responseruby

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
response, err := commerce.OrderSubscriptionBillList(map[string]interface{}{
    "order_subscription_id": "687a1b2c3d4e5f6789012345",
    "page": 1,
    "limit": 10,
})
fmt.Println(response)go

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var response = await commerce.OrderSubscriptionBillList(new {
    order_subscription_id = "687a1b2c3d4e5f6789012345",
    page = 1,
    limit = 10
});
Console.WriteLine(response);csharp

응답

{
  "list": [
    {
      "order_subscription_bill_id": "6965f45c4cb8149d0771250d",
      "duration": 1,
      "price": 1000,
      "tax_free_price": 0,
      "status": "bill_completed",
      "reserve_payment_at": "2026-01-12T15:00:00Z",
      "purchased_at": "2026-01-13T07:29:33Z",
      "order_subscription_transaction": {
        "order_subscription_transaction_id": "6965f45c4cb8149d0771250e",
        "purchase_price": 1000,
        "purchase_tax_free_price": 0,
        "status": "bill_completed"
      }
    }
  ],
  "count": 24
}json

응답 파라미터

파라미터	타입	설명
count	Number	전체 회차 수
list	Array	회차 목록
└─ order_subscription_bill_id	String	회차 고유 ID
└─ duration	Integer	회차 번호
└─ price	Number	회차 금액
└─ tax_free_price	Number	면세 금액
└─ status	String	회차 상태
└─ reserve_payment_at	String	결제 예정 시각
└─ purchased_at	String	실제 결제 시각
└─ order_subscription_transaction	Object	연결된 거래 정보

회차 상태 코드 (`list[].status`)

값	키	설명
`2`	`bill_ready`	결제 대기중
`1`	`bill_completed`	결제 완료
`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`	청구 오류

API 엔드포인트

요청 파라미터

코드 예제

응답

응답 파라미터

회차 상태 코드 (list[].status)

회차 상태 코드 (`list[].status`)