결제 상태 조회
결제 요청(`POST /checkout/{checkoutId}/payment`)으로 받은 `paymentId`의 현재 상태를 돌려준다. 결제 서비스에서 돌아온 복귀 화면이 결과를 확정하는 경로이고, 구매자가 결제 앱에서 돌아오지 않은 결제도 이 API로 확인한다. 화면 분기는 `result`로 한다 — `COMPLETED`면 `orderId`로 주문 완료 화면을, `PROCESSING`이면 잠시 뒤 다시 조회, `CANCELED`·`FAILED`면 `lastFailure`를 보여 주고 다른 결제 옵션으로 재시도할 수 있다. 만료 시각이 지난 결제 대기는 `expired`(`EXPIRED`)로 보고한다. 개인정보와 결제사 값은 싣지 않는다.
결제 요청(POST /checkout/{checkoutId}/payment)으로 받은 paymentId의 현재 상태를 돌려준다. 결제 서비스에서 돌아온 복귀 화면이 결과를 확정하는 경로이고, 구매자가 결제 앱에서 돌아오지 않은 결제도 이 API로 확인한다. 화면 분기는 result로 한다 — COMPLETED면 orderId로 주문 완료 화면을, PROCESSING이면 잠시 뒤 다시 조회, CANCELED·FAILED면 lastFailure를 보여 주고 다른 결제 옵션으로 재시도할 수 있다. 만료 시각이 지난 결제 대기는 expired(EXPIRED)로 보고한다. 개인정보와 결제사 값은 싣지 않는다.
회원 accessToken
In: header
Path Parameters
Response Body
application/json
curl -X GET "https://example.com/storefront/v1/payments/string"{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "paymentId": "string", "status": "string", "result": "string", "orderId": "string", "lastFailure": { "attemptId": "string", "category": "string", "code": "string", "message": "string", "optionUnavailable": true }, "testPayment": true, "expiresAt": "string" }, "error": null}결제 재시도 (다른 결제 옵션) POST
같은 결제에서 다른 결제 옵션으로 새 결제 시도를 열고 새 결제 서비스 주소(`payUrl`)를 돌려준다. 카드 거절·결제창 취소·결제창 오류 뒤에 다른 결제사나 결제수단으로 바꿀 때 쓴다. 결제 전 시도(결제창을 닫고 돌아오지 않은 경우)는 버리고 새 시도를 연다. `returnUrl`을 생략하면 결제 시작 때의 복귀 주소를 그대로 쓰고, 보내면 그 주소로 바꾼다(검증은 결제 시작과 같다). 승인 중이거나 결과 확인 중이면 409 `PAYMENT_IN_PROGRESS`다.
픽업 장소 목록 조회 GET
다음