결제 상태 조회
결제 요청(`POST /checkout/{checkoutId}/payment`)으로 받은 `paymentId`의 현재 상태를 돌려준다. 결제 팝업이 결과를 알리지 못하고 닫혔을 때(창이 닫혔거나 결제사 화면을 거치며 연결이 끊긴 경우) 이 API로 결과를 확인한다. `completed`면 `orderId`로 주문 완료 화면을 보여 주고, `processing`이면 잠시 뒤 다시 조회한다. 만료 시각이 지난 결제 대기는 `expired`로 보고한다. 개인정보와 결제사 값은 싣지 않는다.
결제 요청(POST /checkout/{checkoutId}/payment)으로 받은 paymentId의 현재 상태를 돌려준다. 결제 팝업이 결과를 알리지 못하고 닫혔을 때(창이 닫혔거나 결제사 화면을 거치며 연결이 끊긴 경우) 이 API로 결과를 확인한다. completed면 orderId로 주문 완료 화면을 보여 주고, processing이면 잠시 뒤 다시 조회한다. 만료 시각이 지난 결제 대기는 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", "orderId": "string", "testPayment": true, "expiresAt": "string" }, "error": null}결제 승인 POST
결제창이 돌려준 PG 승인 키(`pgToken`)로 결제를 승인하고 주문을 만든다. `attemptId`(결제창이 돌려준 주문번호)를 생략하면 현재 결제 시도를 승인한다. 같은 `paymentId`+`pgToken` 재호출은 처음 결과를 그대로 돌려준다(멱등). `Idempotency-Key` 헤더도 지원한다. 카드 거절(402) 뒤에는 결제가 닫히지 않아 다른 결제 수단으로 다시 시도할 수 있다. 승인 결과를 아직 모르면 409 `PAYMENT_RESULT_UNKNOWN`이며, 서버가 결제사에 확인해 확정한다(주문 내역으로 확인).
상품 검색 GET
다음