결제 승인
결제창이 돌려준 PG 승인 키(`pgToken`)로 결제를 승인하고 주문을 만든다. `attemptId`(결제창이 돌려준 주문번호)를 생략하면 현재 결제 시도를 승인한다. 같은 `paymentId`+`pgToken` 재호출은 처음 결과를 그대로 돌려준다(멱등). `Idempotency-Key` 헤더도 지원한다. 카드 거절(402) 뒤에는 결제가 닫히지 않아 다른 결제 수단으로 다시 시도할 수 있다. 승인 결과를 아직 모르면 409 `PAYMENT_RESULT_UNKNOWN`이며, 서버가 결제사에 확인해 확정한다(주문 내역으로 확인).
결제창이 돌려준 PG 승인 키(pgToken)로 결제를 승인하고 주문을 만든다. attemptId(결제창이 돌려준 주문번호)를 생략하면 현재 결제 시도를 승인한다. 같은 paymentId+pgToken 재호출은 처음 결과를 그대로 돌려준다(멱등). Idempotency-Key 헤더도 지원한다. 카드 거절(402) 뒤에는 결제가 닫히지 않아 다른 결제 수단으로 다시 시도할 수 있다. 승인 결과를 아직 모르면 409 PAYMENT_RESULT_UNKNOWN이며, 서버가 결제사에 확인해 확정한다(주문 내역으로 확인).
회원 accessToken
In: header
Path Parameters
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
PG 승인 키 (토스 paymentKey, 포트원 txId)
1 <= length승인할 결제 시도 id (결제창이 돌려준 주문번호). 생략하면 현재 시도
1 <= lengthResponse Body
application/json
curl -X POST "https://example.com/storefront/v1/payments/string/confirm" \ -H "idempotency-key: string" \ -H "Content-Type: application/json" \ -d '{ "pgToken": "string" }'{ "meta": { "status": 0, "code": "OK", "message": "string", "isSuccess": true }, "data": { "orderId": "string", "status": "PAID", "totalAmount": -9007199254740991, "paidAt": "string" }, "error": null}Get GET
Previous Page
결제 상태 조회 GET
결제 요청(`POST /checkout/{checkoutId}/payment`)으로 받은 `paymentId`의 현재 상태를 돌려준다. 결제 팝업이 결과를 알리지 못하고 닫혔을 때(창이 닫혔거나 결제사 화면을 거치며 연결이 끊긴 경우) 이 API로 결과를 확인한다. `completed`면 `orderId`로 주문 완료 화면을 보여 주고, `processing`이면 잠시 뒤 다시 조회한다. 만료 시각이 지난 결제 대기는 `expired`로 보고한다. 개인정보와 결제사 값은 싣지 않는다.