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

## 1. API Overview

### Purpose

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

### Details

[table:key-value]
| 항목            | 값                           |
| :-------------- | :--------------------------- |
| **API Name**    | 결제 수단 삭제                    |
| **API Path**    | /api/v2/payment-methods/delete |
| **API ID**      | EBP_API_124                  |
| **HTTP Method** | [badge:POST,blue,lg]         |
| **Region** | [badge:Global,green-subtle,lg] |
[/table]

## 2. Request Specification

### 2.1 Request Header

@@include:common-headers-link.md@@

### 2.2 Request Data Schema

| depth | Field   | Details & Description                              |
| ----- |---------|----------------------------------------------------|
| 0     | userNo  | [type-ml:string,500] [req:Yes] [desc:사용자 번호]       |
| 0     | paymentMethodId | [type-ml:string,500] [req:Yes] [desc:저장된 결제 수단 ID] |

### 2.3 Request Examples

#### JSON Example

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

## 3. Response Specification

### 3.1 Response Data Schema

#### Response Data Schema

@@include:standard-response.md@@
| -1     | data | [type:object] [desc: null]            |

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

### 3.2 Response Samples

#### Success Response

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