# Webhook - Payment Method Registered

## 1. Webhook Overview

### Purpose

[context]
This Webhook event is sent from the EBP system to the store when a user successfully registers a payment method (Card, Direct Debit, etc.).<br>
Through this event, the store can verify the activation status of the payment method in real-time and proceed with subsequent processes to utilize the registered payment method for future payment requests.
[/context]

> **Note**: A registered URL is required to receive Webhooks. (Contact: [ebp-server@lge.com](mailto:ebp-server@lge.com))

### Details

[table:key-value]
| Item | Value |
| :--- | :--- |
| **Webhook Name** | Payment Method Created |
| **Event Type** | `PAYMENT_METHOD_CREATED` |.md/.ㅡㅇ
| **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:Event type] [eg:PAYMENT_METHOD_CREATED]                                          |
| -1    | eventTime       | [type:string] [req:Yes] [desc:Timestamp when the event occurred[tooltip:UTC, ISO-8601]] [eg:2026-01-27T04:40:00Z] |
| -1    | data            | [type:object] [req:Yes] [desc:Detailed payment method registration data]                                          |
| 0     | userNo          | [type-ml:string,500] [req:Yes] [desc:Unique number identifying the user] [eg:TH1741850000100]                     |
| 0     | paymentMethodId | [type:string] [req:Yes] [desc:Registered payment method ID] [eg:3e104ef7b98f4123948a8c248d0da4c5]                 |
| 0     | status          | [type:string] [req:Yes] [desc:Payment method status] [eg:ACTIVE, ACTION_REQUIRED]                                 |
| 0     | paymentMethod   | [type:string] [req:Yes] [desc:Registered payment method type] [eg:CARD, DIRECT_DEBIT]                             |
| 0     | resultCode      | [type:string] [req:Yes] [desc:EBP result code ('0' for success)] [eg:0]                                           |
| 0     | resultMessage   | [type:string] [req:Optional] [desc:Result message (e.g., error reason)] [eg:SUCCESS]                              |
| 0     | pgProvider          | [type:string] [req:Yes] [desc:Payment Gateway provider code] [eg:WORLDPAY, OMISE]                                 |

## 3.2. Payload Example

```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"
  }
}
```