빌링계정 API - 결제 수단 삭제 #

1. API Overview #

Purpose #

저장된 결제 수단을 안전하게 삭제하는 API입니다.
삭제된 결제 수단은 이후 결제에서 사용할 수 없으며 불필요한 결제 수단을 제거해 보안을 강화합니다.
삭제는 영구적이므로 요청 전에 필요 여부를 확인해야 합니다.

Details #

항목	값
API Name	결제 수단 삭제
API Path	/api/v2/payment-methods/delete
API ID	EBP_API_124
HTTP Method	POST
Region	Global

2. Request Specification #

2.1 Request Header #

상세한 헤더 정보는 Common Headers 문서를 참고하세요.

2.2 Request Data Schema #

depth Field Details & Description

userNo

depth	Field	Details & Description
0	userNo	`string≤ 500` 🔴 Required 사용자 번호
0	paymentMethodId	`string≤ 500` 🔴 Required 저장된 결제 수단 ID

string≤ 500

🔴 Required

사용자 번호

paymentMethodId

string≤ 500

🔴 Required

저장된 결제 수단 ID

2.3 Request Examples #

JSON Example #

{
  "userNo": "KR1234567890",
  "paymentMethodId": "b79c2955f3a7462f86885c2d7fae04b5"
}

3. Response Specification #

3.1 Response Data Schema #

Response Data Schema #

depth	Field	Details & Description
-1	resultCode	`string` 🔴 Required 결과 코드 (성공 "0", 에러 시 "EBP-A-0001" 등)
-1	message	`string` 🔴 Required 결과 메시지 (성공 또는 에러 상세)
-1	requestId	`string` 🔴 Required 추적을 위한 고유 요청 ID
-1	timestamp	`string` 🔴 Required ISO 8601 형식의 응답 타임스탬프 e.g., 2025-12-19T14:24:00+09:00
-1	data	`object` null

이 API는 data 필드에 별도의 데이터를 반환하지 않습니다.

3.2 Response Samples #

Success Response #

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "01EFX0CRR7JK0KCSSTFEEDRDVA",
  "timestamp": "2025-12-30T07:19:28.323457100Z",
  "data": null
}