sayren Docs
Order items

주문상품 변경 목록 조회

마지막 변경 시각 범위(최대 24시간)로 주문상품을 변경 시각 오름차순으로 조회한다. 연동사가 변경분을 주기적으로 가져가는 용도다. 스코프 `order:r`. 테스트 결제(샌드박스 결제) 주문은 `testPayment: true`다. 실제로 돈이 오가지 않았으므로 상품을 발송하지 않도록 주의한다. `testPayment` 쿼리로 테스트 결제만(`true`)·실결제만(`false`) 볼 수 있다. 주문상품의 `testPayment`는 소속 주문의 값이다. method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다(`payment.approvedMethod` — 매출 리포트·스토어프론트·환불 원장과 같은 값).

GET
/v1/order-items

마지막 변경 시각 범위(최대 24시간)로 주문상품을 변경 시각 오름차순으로 조회한다. 연동사가 변경분을 주기적으로 가져가는 용도다. 스코프 order:r.

테스트 결제(샌드박스 결제) 주문은 testPayment: true다. 실제로 돈이 오가지 않았으므로 상품을 발송하지 않도록 주의한다. testPayment 쿼리로 테스트 결제만(true)·실결제만(false) 볼 수 있다. 주문상품의 testPayment는 소속 주문의 값이다.

method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다(payment.approvedMethod — 매출 리포트·스토어프론트·환불 원장과 같은 값).

Authorization

bearer
AuthorizationBearer <token>

userToken(계정 스코프) 또는 storeToken(스토어 스코프)

In: header

Query Parameters

lastChangedFrom*string

마지막 변경 시각 조회 시작 (ISO 8601, 포함). 필수

lastChangedTo?string

마지막 변경 시각 조회 끝 (ISO 8601, 포함). 생략하면 시작부터 24시간. 기간은 최대 24시간

lastChangedType?string

마지막 변경 유형 필터

Value in

  • "ORDER.PAID"
  • "ORDER.CONFIRMED"
  • "ORDER.DISPATCHED"
  • "ORDER.DELIVERED"
  • "ORDER.PURCHASE_DECIDED"
  • "CLAIM.CANCEL_REQUESTED"
  • "CLAIM.RETURN_REQUESTED"
  • "CLAIM.EXCHANGE_REQUESTED"
  • "ORDER.ADDRESS_CHANGE_REQUESTED"
page?string

페이지 번호 (1부터, 기본 1)

size?string

페이지 크기 (기본 100, 최대 300)

testPayment?string

테스트 결제(샌드박스 결제) 필터. true면 테스트 결제만, false면 실결제만, 생략하면 전부예요

Value in

  • "true"
  • "false"

Response Body

application/json

curl -X GET "https://example.com/v1/order-items?lastChangedFrom=string"
{  "meta": {    "status": 0,    "code": "OK",    "message": "string",    "isSuccess": true  },  "data": {    "page": -9007199254740991,    "size": -9007199254740991,    "totalElements": -9007199254740991,    "totalPages": -9007199254740991,    "contents": [      {        "orderItemId": "string",        "orderId": "string",        "status": "PAYMENT_WAITING",        "claimStatus": "CANCEL_REQUESTED",        "productId": "string",        "productName": "string",        "optionId": "string",        "optionName": "string",        "sellerCode": "string",        "quantity": -9007199254740991,        "unitPrice": -9007199254740991,        "discountAmount": -9007199254740991,        "totalPrice": -9007199254740991,        "hold": {          "reason": "string",          "expectedDispatchDate": "string"        },        "autoDecisionDate": "string",        "sellerMemo": "string",        "orderedAt": "string",        "lastChangedAt": "string",        "lastChangedType": "ORDER.PAID",        "testPayment": true      }    ]  },  "error": null}

Register POST

Previous Page

Confirm bulk POST

Next Page