# Webhook - 결제 수단 등록 완료

## 1. Webhook Overview

### Purpose

[context]
사용자가 결제 수단(카드, 직불계좌 등)을 성공적으로 등록하면 EBP 시스템에서 상점으로 결제 수단 등록 완료 정보를 전송하는 Webhook 이벤트입니다.<br>
이 이벤트를 통해 상점은 실시간으로 결제 수단의 활성화 상태를 확인하고, 이후 결제 요청 시 해당 결제 수단을 활용할 수 있도록 후속 처리를 진행할 수 있습니다.
[/context]

> **참고**: Webhook 수신을 위해 URL 등록이 필요합니다. (문의: [ebp-server@lge.com](mailto:ebp-server@lge.com))

### Details

[table:key-value]
| 항목 | 값 |
| :--- | :--- |
| **Webhook Name** | 결제 수단 생성 완료 |
| **Event Type** | `PAYMENT_METHOD_CREATED` |
| **HTTP Method** | [badge:POST,blue,lg] |
| **Region** | [badge:Global,green-subtle,lg] |
[/table]

@@include:webhook-authentication.md@@

## 3. Data Schema

### 3.1. Payload Data Schema

| depth | Field           | Details & Description                                                                     |
|:------|:----------------|:------------------------------------------------------------------------------------------|
| -1    | eventType       | [type:string] [req:Yes] [desc:이벤트 유형] [eg:PAYMENT_METHOD_CREATED]                         |
| -1    | eventTime       | [type:string] [req:Yes] [desc:이벤트 발생 시각[tooltip:UTC, ISO-8601]] [eg:2026-01-27T04:40:00Z] |
| -1    | data            | [type:object] [req:Yes] [desc:결제 수단 등록 상세 데이터]                                            |
| 0     | userNo          | [type-ml:string,500] [req:Yes] [desc:사용자를 식별하는 고유 번호] [eg:TH1741850000100]                |
| 0     | paymentMethodId | [type:string] [req:Yes] [desc:등록된 결제 수단 ID] [eg:3e104ef7b98f4123948a8c248d0da4c5]         |
| 0     | status          | [type:string] [req:Yes] [desc:결제 수단 상태] [eg:ACTIVE, ACTION_REQUIRED]                      |
| 0     | paymentMethod   | [type:string] [req:Yes] [desc:등록된 결제 수단 유형] [eg:CARD, DIRECT_DEBIT]                       |
| 0     | resultCode      | [type:string] [req:Yes] [desc:EBP 결과 코드 ('0': 성공, 이외 실패)] [eg:0]                          |
| 0     | resultMessage   | [type:string] [req:Optional] [desc:결과 메시지 (에러 사유 등)] [eg:SUCCESS]                         |
| 0     | pgProvider      | [type:string] [req:Yes] [desc:결제 PG사 코드] [eg:WORLDPAY, OMISE, CHECKOUT]                   |

## 3. Payload 예시

```json
{
  "eventType": "PAYMENT_METHOD_CREATED",
  "eventTime": "2026-01-27T04:40:00Z",
  "data": {
    "userNo": "TH1741850000100",
    "paymentMethodId": "3e104ef7b98f4123948a8c248d0da4c5",
    "status": "ACTIVE",
    "paymentMethod": "CARD",
    "resultCode": "0",
    "resultMessage": "SUCCESS",
    "pgProvider": "WORLDPAY"
  }
}
```