Glowb Dev Docs
Main API관리자 결제 API

POST /admin/payments/{intentKey}/cancel

결제 취소

결제 취소

intentKey로 결제를 취소합니다.

항목
메서드POST
경로/admin/payments/{intentKey}/cancel
인증필요 (관리자 권한)
Content-Typeapplication/json

요청

POST /admin/payments/{intentKey}/cancel
Authorization: Bearer {access_token}
Content-Type: application/json

Path Parameters

파라미터타입필수설명
intentKeystring결제 키

Request Body (선택)

{
  "cancelReason": "관리자 취소"
}

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "결제 취소 성공",
  "data": {
    "intentKey": "intent_xxxxxxxxxxxxx",
    "status": "canceled",
    "message": "결제가 취소되었습니다.",
    "httpStatusCode": 200
  }
}

이미 취소된 결제 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "이미 취소된 결제입니다.",
  "data": {
    "intentKey": "intent_xxxxxxxxxxxxx",
    "status": "already_canceled"
  }
}

에러 응답

상태 코드코드메시지
404NOT_FOUND결제 정보를 찾을 수 없습니다.
500CANCEL_FAILED결제 취소에 실패했습니다.

API 테스트

On this page