Checkout
Create checkout
AuthorizationBearer <token>
회원 accessToken
In: header
Header Parameters
x-cart-token*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
cartItemIds?array<string>
Items
1 <= itemsdirectItem?
Response Body
curl -X POST "https://example.com/storefront/v1/checkout" \ -H "x-cart-token: string" \ -H "Content-Type: application/json" \ -d '{}'Empty
Categories GET
Previous Page
결제 요청 (결제창 열기) POST
배송지·결제수단을 확정하고 결제 팝업 진입 URL(`pgParams.popupUrl`)과 첫 결제 시도를 발급한다. PG는 스토어의 결제 설정(사용 중인 PG·우선순위)으로 정해지고 `pgProvider`로 알려 준다. `pgParams`에는 공개 값만 담기며 시크릿은 없다. 스토어프론트는 `popupUrl`만 쓰면 된다. 비회원은 `guest`가 필수다. `testPayment`가 true면 스토어가 테스트 결제(샌드박스) 중이라 실제로 돈이 나가지 않는다 — 결제 화면에 안내를 표시한다. `PAYMENT_NOT_CONFIGURED`·`PAYMENT_PROVIDER_UNAVAILABLE`은 구매자에게 결제 수단 준비 중으로 안내한다.