빌링계정 API - 결제 비밀번호 등록 #
1. API Overview #
Purpose #
카드 결제 시 사용되는 인증 비밀번호(PIN)를 등록하는 API입니다.
사용자가 입력한 PIN은 반드시 암호화하여 전달해야 하며, EBP는 암호화 방식에 간섭하지 않습니다.
이 API는 민감한 카드 정보를 직접 처리하지 않고, 저장된 결제 수단 데이터와 PIN을 결합해 보안을 강화하는 것을 목표로 합니다.
참고: 결제 비밀번호 변경은 지원하지 않습니다. 비밀번호 분실 시 기존 결제 수단 삭제 후 재등록이 필요합니다.
Details #
| 항목 | 값 |
|---|---|
| API Name | 결제 비밀번호 등록 |
| API Path | /api/v2/payment-methods/pin/registration |
| API ID | EBP_API_131 |
| HTTP Method | POST |
| Region | Global |
2. Request Specification #
2.1 Request Header #
상세한 헤더 정보는 Common Headers 문서를 참고하세요.
2.2 Request Data Schema #
| Field | Details & Description |
|---|---|
| userNo |
🔴 Required 사용자 번호 |
| paymentMethodId |
🔴 Required 결제 수단을 식별하는 고유 ID |
| paymentPin |
🔴 Required 결제용으로 등록할 PIN (암호화 전송) |
2.3 Request Examples #
JSON Example #
{
"userNo": "T0a8w9h7t5h3v5w6w4v6v4d1d4c1",
"paymentMethodId": "202512110245491",
"paymentPin": "44a019096dabfb5c660df1252609528795400f653ba"
}
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 |
| 0 | paymentMethodId |
🔴 Required 결제 수단을 식별하는 고유 ID |
3.2 Response Samples #
Success Response #
{
"resultCode": "0",
"message": "SUCCESS",
"requestId": "06EFX0CRR7JK0KCSSTFEEDRDVG",
"timestamp": "2025-12-30T07:33:13.824093100Z",
"data": {
"paymentMethodId": "b79c2955f3a7462f86885c2d7fae04b5"
}
}