빌링계정 API - 빌링 계정 탈퇴 #
1. API Overview #
Purpose #
EBP 결제 서비스를 이용하는 사용자가 빌링 계정을 삭제하고 서비스에서 탈퇴하기 위한 API입니다.
계정 삭제 시 결제 및 정산 관련 데이터는 즉시 삭제됩니다. 단, 송금 요청전 데이터가 존재하는 경우 해당 송금이 완료된 익월에 최종 삭제됩니다.
Details #
| 항목 | 값 |
|---|---|
| API Name | 빌링 계정 탈퇴 |
| API Path | /api/v2/account/withdrawal |
| API ID | EBP_API_104 |
| HTTP Method | POST |
| Region | Global |
[!INFO] 빌링 계정 생성 시점
빌링 계정은 별도의 가입 절차 없이, 사용자가 최초로 토큰을 등록하거나 결제를 요청할 때 전달된 스토어 ID(X-Store-Id)와 사용자 번호(userNo)를 기준으로 시스템에 자동 생성됩니다.
2. Request Specification #
2.1 Request Header #
상세한 헤더 정보는 Common Headers 문서를 참고하세요.
2.2 Request Data Schema #
| depth | Field | Details & Description |
|---|---|---|
| 0 | userNo |
사용자 번호 |
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 결과 코드 (성공 "0", 에러 시 "EBP-A-0001" 등) |
| -1 | message |
🔴 Required 결과 메시지 (성공 또는 에러 상세) |
| -1 | requestId |
🔴 Required 추적을 위한 고유 요청 ID |
| -1 | timestamp |
🔴 Required ISO 8601 형식의 응답 타임스탬프 e.g., 2025-12-19T14:24:00+09:00 |
| -1 | data |
null |
이 API는
data필드에 별도의 데이터를 반환하지 않습니다.
3.2 Response Samples #
Success Response #
{
"resultCode": "0",
"message": "SUCCESS",
"requestId": "06EFX0CRR7ME0KCSSTFEEDRDVG",
"timestamp": "2025-12-19T04:12:02+00:00",
"data": null
}