컬렉션 목록

배송지와 결제 옵션(`option`: PG·결제수단·간편결제사)으로 결제를 시작하고 결제 서비스 주소(`payUrl`)를 돌려준다. `option`은 주문서의 `paymentOptions` 항목을 그대로 보내거나 직접 쓴다. 스토어프론트는 `payUrl`을 팝업(쿼리 `mode=popup`)이나 전체 페이지로 열고, 결제 서비스가 PG 결제창을 띄워 승인까지 마친다(`@sayren/storefront-sdk/payments`). 결제가 끝나면 구매자는 `returnUrl`로 돌아오고, 결과는 결제 상태 조회로 확정한다. `returnUrl`은 https여야 한다(테스트 결제는 localhost 허용). 상점 결제 도메인(상점 플랫폼 설정 › 결제)을 등록했다면 그 안이어야 한다. PG 시크릿은 물론 결제창 호출 값도 이 응답에 담기지 않는다. 비회원은 `guest`가 필수다. `testPayment`가 true면 상점이 테스트 결제(샌드박스) 중이라 실제로 돈이 나가지 않는다. **보낸 배송지로 배송비를 다시 계산해 결제 금액을 확정한다** — 제주·도서산간 추가 배송비 때문에 주문서 조회 시점의 `amounts`와 다를 수 있다. 확정 금액은 이 응답의 `amounts`이고, 미리 보려면 배송비 미리보기를 쓴다. 계좌이체·가상계좌 옵션은 `cashReceipt`로 현금영수증을 신청할 수 있다. 결제가 승인되면 결제한 PG로 발급하고 환불하면 그만큼 취소한다. 회원은 `pointAmount`로 적립금을 쓴다. 계산은 금액 미리보기와 같고, 결제 시작이 그 금액을 예약한다. 결제가 실패하거나 만료되면 예약을 풀어 잔액으로 돌린다. **적립금이 결제 금액 전체를 덮으면(0원 결제) 결제창 없이 이 요청에서 주문을 만든다** — `option`을 생략할 수 있고, 응답은 `status: "completed"`·`orderId`이며 `payUrl`·`attemptId`·`option`이 null이다. 이 결제는 재시도할 수 없다(409 `ALREADY_PROCESSED`). 헤더 `Idempotency-Key`를 보내면 같은 키의 재요청에 처음 결과를 돌려주고, 같은 키의 동시 요청은 409 `IDEMPOTENCY_KEY_IN_USE`다.