주문 조회 | Bootpay 커머스 매뉴얼

고객의 결제 이력에 해당하는 주문 내역을 조회해요. 주문 링크, 커머스 직접 결제, 구독 등 모든 주문 유형을 조회할 수 있어요.

API 엔드포인트

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

요청 파라미터

파라미터	타입	필수	설명
`user_id`	String	선택	주문자 ID
`user_group_id`	String	선택	주문자 그룹 ID
`order_subscription_ids`	Array	선택	구독 계약 번호 배열
`subscription_billing_type`	Integer	선택	구독 결제 유형 (0/1/2)
`keyword`	String	선택	검색 키워드 (order_id, order_name, receipt_id)
`cs_type`	String	선택	검색 일 유형 (c_at: 생성일, p_at: 결제일)
`css_at`	String	선택	검색 시작일 (YYYY-MM-DD)
`cse_at`	String	선택	검색 종료일 (YYYY-MM-DD)
`status`	Array	선택	주문 상태 배열
`payment_status`	Array	선택	결제 상태 배열
`page`	Integer	선택	페이지 번호 (기본: 1)
`limit`	Integer	선택	페이지당 데이터 수 (기본: 20)

코드 예제

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

const commerce = new BootpayCommerce({
    client_key: 'your-commerce-client-key',
    secret_key: 'your-commerce-secret-key',
    mode: 'production'
})

const response = await commerce.order.list({
    page: 1,
    limit: 20,
    css_at: '2025-01-01',
    cse_at: '2025-01-31'
})
console.log(response)javascript

from bootpay_backend import BootpayCommerce

commerce = BootpayCommerce(
    client_key='your-commerce-client-key',
    secret_key='your-commerce-secret-key',
    mode='production'
)

response = commerce.order.list(
    page=1,
    limit=20,
    css_at='2025-01-01',
    cse_at='2025-01-31'
)
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi('your-commerce-client-key', 'your-commerce-secret-key');
$response = $commerce->order->list([
    'page' => 1,
    'limit' => 20,
    'css_at' => '2025-01-01',
    'cse_at' => '2025-01-31'
]);
print_r($response);php

import kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;

TokenPayload tp = new TokenPayload("your-commerce-client-key", "your-commerce-secret-key");
BootpayStore commerce = new BootpayStore(tp);
HashMap<String, Object> params = new HashMap<>();
params.put("page", 1);
params.put("limit", 20);
params.put("css_at", "2025-01-01");
params.put("cse_at", "2025-01-31");

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

commerce = BootpayStore::Api.new('your-commerce-client-key', 'your-commerce-secret-key')
response = commerce.order_list(
  page: 1,
  limit: 20,
  css_at: '2025-01-01',
  cse_at: '2025-01-31'
)
puts responseruby

import "github.com/bootpay/backend-go/v2"

commerce := bootpay.NewCommerceApi("your-commerce-client-key", "your-commerce-secret-key")
response, err := commerce.Order.List(bootpay.OrderListParams{
    Page:  1,
    Limit: 20,
    CssAt: "2025-01-01",
    CseAt: "2025-01-31",
})
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
var response = await commerce.Order.List(new {
    page = 1,
    limit = 20,
    css_at = "2025-01-01",
    cse_at = "2025-01-31"
});
Console.WriteLine(response);csharp

응답

성공 응답

{
  "count": 15,
  "list": [
    {
      "order_id": "68707c59b0eacea5cd974efd",
      "order_name": "프리미엄 구독 1회차",
      "price": 29000,
      "status": 2,
      "receipt_status": 1,
      "order_number": "25071182085082524116",
      "purchased_at": "2025-07-11T02:52:09Z",
      "created_at": "2025-07-11T02:52:09Z",
      "username": "홍길동",
      "user_email": "user@example.com"
    }
  ]
}json

에러 응답

{
  "status": 401,
  "code": 1700,
  "message": "Access Token이 잘못되었거나 만료되었습니다.",
  "data": null
}json

응답 필드 설명

필드	타입	설명
`count`	Integer	조회된 총 주문 수
`list`	Array	주문 목록
`list[].order_id`	String	주문 고유 번호
`list[].order_name`	String	주문명
`list[].price`	Integer	결제 금액
`list[].status`	Integer	주문 상태
`list[].receipt_status`	Integer	결제 상태 (0: 미결제, 1: 결제완료)
`list[].order_number`	String	주문 번호
`list[].purchased_at`	String	결제 일시
`list[].username`	String	주문자 이름

주문 상태 코드

값	상태	설명
0	주문 생성	결제 대기
`PROCESS_DUPLICATED`	이미 처리된 요청이에요	결제 진행 중
2	결제 완료	정상 결제
3	취소 요청	취소 대기
4	취소 완료	결제 취소됨