배송비 미리보기
배송지 우편번호로 배송비를 다시 계산한다. 주문서를 만들 때는 배송지를 모르므로 제주·도서산간 추가 배송비가 빠져 있다 — 구매자가 배송지를 입력하거나 고칠 때 이 엔드포인트로 금액을 갱신하면 결제 직전에 금액이 바뀌는 일을 피할 수 있다. **주문서를 바꾸지 않는 읽기 계산이고 최종 금액은 결제 시작 응답의 `amounts`다.** 배송비는 배송 묶음(같은 출고지 + 같은 배송 정책)마다 한 번 붙고, 지역 추가 배송비는 묶음마다 더한다.
배송지 우편번호로 배송비를 다시 계산한다. 주문서를 만들 때는 배송지를 모르므로 제주·도서산간 추가 배송비가 빠져 있다 — 구매자가 배송지를 입력하거나 고칠 때 이 엔드포인트로 금액을 갱신하면 결제 직전에 금액이 바뀌는 일을 피할 수 있다. 주문서를 바꾸지 않는 읽기 계산이고 최종 금액은 결제 시작 응답의 amounts다. 배송비는 배송 묶음(같은 출고지 + 같은 배송 정책)마다 한 번 붙고, 지역 추가 배송비는 묶음마다 더한다.
회원 accessToken
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
배송지 우편번호 5자리
^[0-9]{5}$Response Body
application/json
curl -X POST "https://example.com/storefront/v1/checkout/string/delivery-quote" \ -H "Content-Type: application/json" \ -d '{ "zipCode": "string" }'{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "amounts": { "productAmount": 0, "deliveryFee": 0, "totalAmount": 0, "couponDiscountAmount": 0, "deliveryDiscountAmount": 0, "pointAmount": 0 }, "delivery": { "baseFee": 0, "remoteSurcharge": 0, "remoteArea": "NONE", "remoteAreaLabel": "string", "bundleCount": 0, "freeByThreshold": true, "zipCode": "string" } }, "error": null}주문서 생성 POST
이전
쿠폰·적립금 금액 미리보기 POST
고른 쿠폰(내 쿠폰의 `issueId` 또는 코드)으로 결제 금액을 미리 계산한다. **주문서를 바꾸지 않고 쿠폰을 예약하지 않는다** — 확정은 결제 시작의 `coupons`다. 쿠폰마다 적용 결과와 적용하지 못한 사유를 돌려준다. 한 주문에 주문 쿠폰 1장, 주문상품 한 줄에 상품 쿠폰 1장까지 함께 쓴다. 정률 할인은 10원 단위로 내린다. `zipCode`를 주면 제주·도서산간 추가 배송비까지 반영한다. 코드 입력은 구매자당 분당 10회까지다. 상점 전체에서 없는 코드 입력이 많으면 비회원의 코드 입력을 잠시 막는다. 회원은 `pointAmount`로 적립금 사용액을 미리 본다. 적용 순서는 즉시할인 → 쿠폰 → 적립금이고, 상점의 사용 규칙(최소 보유액·최소 사용액·사용 단위·최대 사용 비율·배송비 사용 여부)에 맞춰 줄인다. 결제 금액이 100원 아래로 내려가면 적립금을 줄여 100원을 남긴다(`points.adjustReason` `MIN_PAYMENT`). 결제 금액 전체를 덮으면 `totalAmount`가 0이고 결제창 없이 결제한다. 적립금을 예약하지 않는다 — 확정은 결제 시작의 `pointAmount`다.