거래 목록 | Bootpay 커머스 매뉴얼

구독 거래(order_subscription_transaction)는 회차(Bill) 목록 응답 안에 포함되어 반환돼요. 거래 내역 확인이 필요할 때는 회차 목록 API를 조회해요.

API 엔드포인트

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

요청 파라미터

파라미터	타입	필수	설명
`order_subscription_id`	String	선택	구독 계약 ID 필터
`status`	Array<number>	선택	회차 상태 필터
`keyword`	String	선택	검색 키워드
`page`	Number	선택	페이지 번호
`limit`	Number	선택	페이지당 개수

코드 예제

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

BootpayCommerceApi commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
HashMap<String, Object> params = new HashMap<>();
params.put("order_subscription_id", "687a1b2c3d4e5f6789012345");
params.put("page", 1);
params.put("limit", 10);

HashMap<String, Object> response = commerce.orderSubscriptionBillList(params);
System.out.println(response);java

commerce = BootpayStore::Api.new('{client_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",
      "order_subscription_transaction": {
        "order_subscription_transaction_id": "6965f45c4cb8149d0771250e",
        "order_number": "26011385253324293160",
        "price": 1000,
        "purchase_price": 1000,
        "purchase_tax_free_price": 0,
        "status": "bill_completed",
        "purchased_at": "2026-01-13T07:29:33Z"
      }
    }
  ],
  "count": 24
}json

응답 파라미터

파라미터	타입	설명
list	Array	회차 목록
list[].order_subscription_transaction	Object	회차에 연결된 거래 정보
list[].order_subscription_transaction.order_subscription_transaction_id	String	거래 고유 ID
list[].order_subscription_transaction.order_number	String	주문번호
list[].order_subscription_transaction.price	Number	거래 금액
list[].order_subscription_transaction.purchase_price	Number	실제 결제 금액
list[].order_subscription_transaction.purchase_tax_free_price	Number	실제 결제 면세 금액
list[].order_subscription_transaction.status	String	거래 상태
list[].order_subscription_transaction.purchased_at	String	결제 시각
count	Number	전체 회차 수