Billing Account API - Withdraw Billing Account #
1. API Overview #
Purpose #
This API allows users of the EBP payment service to delete their billing account and withdraw from the service.
Upon account deletion, payment and settlement related data are deleted immediately. However, if remittance request data exists, it will be permanently deleted in the following month after the remittance is completed.
Details #
| Item | Value |
|---|---|
| API Name | Withdraw Billing Account |
| API Path | /api/v2/account/withdrawal |
| API ID | EBP_API_104 |
| HTTP Method | POST |
| Region | Global |
[!INFO] Billing Account Creation
A billing account is automatically created in the system based on the combination of Store ID (X-Store-Id) and User Number (userNo) when a user registers a token or requests a payment for the first time, without any separate sign-up process.
2. Request Specification #
2.1 Request Header #
For detailed header information, please refer to the Common Headers documentation.
2.2 Request Data Schema #
| depth | Field | Details & Description |
|---|---|---|
| 0 | userNo |
User number |
2.3 Request Examples #
JSON Example #
{
"userNo": "KR1234567890"
}
3. Response Specification #
3.1 Response Data Schema #
Response Data Schema #
| depth | Field | Details & Description |
|---|---|---|
| -1 | resultCode |
🔴 Required Result code e.g., "0" for success, "EBP-A-0001" for error |
| -1 | message |
🔴 Required Result message |
| -1 | requestId |
🔴 Required Unique request identifier for tracking |
| -1 | timestamp |
🔴 Required Response timestamp in ISO 8601 format e.g., 2025-12-19T14:24:00+09:00 |
| -1 | data |
null |
This API does not return any data in the
datafield.
3.2 Response Samples #
Success Response #
{
"resultCode": "0",
"message": "SUCCESS",
"requestId": "06EFX0CRR7ME0KCSSTFEEDRDVG",
"timestamp": "2025-12-19T04:12:02+00:00",
"data": null
}