결제 요청 (결제창 열기)
배송지·결제수단을 확정하고 결제 팝업 진입 URL(`pgParams.popupUrl`)과 첫 결제 시도를 발급한다. PG는 스토어의 결제 설정(사용 중인 PG·우선순위)으로 정해지고 `pgProvider`로 알려 준다. `pgParams`에는 공개 값만 담기며 시크릿은 없다. 스토어프론트는 `popupUrl`만 쓰면 된다. 비회원은 `guest`가 필수다. `testPayment`가 true면 스토어가 테스트 결제(샌드박스) 중이라 실제로 돈이 나가지 않는다 — 결제 화면에 안내를 표시한다. `PAYMENT_NOT_CONFIGURED`·`PAYMENT_PROVIDER_UNAVAILABLE`은 구매자에게 결제 수단 준비 중으로 안내한다.
배송지·결제수단을 확정하고 결제 팝업 진입 URL(pgParams.popupUrl)과 첫 결제 시도를 발급한다. PG는 스토어의 결제 설정(사용 중인 PG·우선순위)으로 정해지고 pgProvider로 알려 준다. pgParams에는 공개 값만 담기며 시크릿은 없다. 스토어프론트는 popupUrl만 쓰면 된다. 비회원은 guest가 필수다. testPayment가 true면 스토어가 테스트 결제(샌드박스) 중이라 실제로 돈이 나가지 않는다 — 결제 화면에 안내를 표시한다. PAYMENT_NOT_CONFIGURED·PAYMENT_PROVIDER_UNAVAILABLE은 구매자에게 결제 수단 준비 중으로 안내한다.
회원 accessToken
In: header
Path Parameters
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Value in
- "CARD"
- "BANK_TRANSFER"
- "VIRTUAL_ACCOUNT"
- "MOBILE"
- "EASY_PAY"
Response Body
application/json
curl -X POST "https://example.com/storefront/v1/checkout/string/payment" \ -H "origin: string" \ -H "Content-Type: application/json" \ -d '{ "shippingAddress": { "receiverName": "string", "phone": "string", "zipCode": "string", "address1": "string" }, "paymentMethod": "CARD" }'{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "paymentId": "string", "pgProvider": "string", "pgParams": { "popupUrl": "string", "attemptId": "string", "provider": "string", "mock": true, "environment": "string", "property1": null, "property2": null }, "expiresAt": "string", "testPayment": true }, "error": null}