# Change Log

## v0.5.21 (2026-06-11)
- **구매 API - 결제 의사 생성 가이드 현행화**
  - 태국 할부 결제(`INSTALLMENT`) 관련 정적 안내 문구 삭제: 결제 사양 조회(EBP_API_240) API에서 동적 정보를 제공함에 따라 중복된 정적 안내를 삭제하고 최신화

## v0.5.20 (2026-06-04)
- **빌링계정 API - 결제 수단 생성 (v0.2)**
  - `NAVER_PAY` 결제 수단 메타데이터(`metadata`)에 다음 필드 추가:
    - `purchaserName`: 구매자 성명 (보험 및 위험 업종 결제 시 필수)
    - `purchaserBirthday`: 구매자 생년월일 (보험 및 위험 업종 결제 시 필수)

## v0.5.19 (2026-06-07)
- **결제 사양 조회 API 데이터 규격 보완**
  - 결제 사양 조회(EBP_API_240) 응답 필드 추가: 각 결제 수단별 지원 기능을 나타내는 `capabilities` 객체 및 즉시 결제 가능 여부(`supportsDirectPay`), 저장 가능 여부(`supportsSave`) 필드 추가
  - Omise 할부 사양(`specifications`) 필드명 정규화: `min` → `minAmount`, `max` → `maxAmount`, `installmentTerm` → `availableTerms` (하위 호환성 유지)

## v0.5.18 (2026-05-29)
- **SDK 단시간 유효 토큰 발급 API 추가**
  - SDK 단시간 유효 토큰 발급(EBP_API_221) API 명세 문서 및 사용 가이드 신규 추가: 클라이언트 SDK에서 시그니처 없이 안전하게 결제 수단 조회 및 결제 요청을 수행하기 위한 5분 만료 단시간 유효 보안 토큰 사양 및 대체 키 발급 프로세스 정의

## v0.5.17 (2026-05-22)
- **신규 API 데이터 규격 추가**
  - 결제 사양 조회(EBP_API_240) API 신규 추가: 가맹점 및 국가 기준 사용 가능 결제수단 및 PG 부가정보(예: 태국 할부 은행/조건 메타데이터) 사전 조회를 위한 인터페이스 규격 정의
- **SDK 연동 가이드 추가**
  - EBP SDK 사용 가이드 추가: 결제 사양 조회 API를 통한 지원 PG 정보 사전 확인 안내 추가 및 캐시 방지를 위한 타임스탬프(`t`) 파라미터 필수화 적용 안내

## v0.5.16 (2026-05-19)
- **API 데이터 규격 보완**
  - 결제 수단 생성(EBP_API_120) API 요청 필드 변경: 이메일(`email`) 필드를 필수(`Yes`)에서 선택(`Optional`)으로 변경

## v0.5.15 (2026-05-14)
- **Getting Started 가이드 현행화**
  - 서버 접속 및 방화벽 설정 안내 추가: OMS(AWS)-사내망-EBP(AWS) 접속 경로 및 방화벽 설정 가이드 반영
  - 환경별 IP Range 정보 추가: DEV/QA 및 PRD(KIC, AIC, EIC) 대역 정보 명시

## v0.5.14 (2026-04-27)
- **API 데이터 규격 개선**
  - 결제 생성(EBP_API_230) API 응답 구조 현행화: `response.data.pgResponse.data` 구조를 `response.data.pgResult.pgResponse` 규격으로 개선하여 용어 직관성 및 일관성 확보

## v0.5.13 (2026-04-25)
- **API 데이터 규격 보완**
  - 결제 수단 조회(EBP_API_109) API 응답 필드 추가: 생성일시(`createdAt`) 반영
  - 결제 의사 생성(EBP_API_224) API 응답 필드 추가: 결제 수단(`savedPaymentMethods`) 생성일시(`createdAt`) 반영

## v0.5.12 (2026-04-22)
- **Webhook 가이드 현행화**
  - 결제 승인 완료(`PAYMENT_AUTHORIZED`) Webhook 문서 업데이트: 오토캡쳐 시 승인 웹훅 생략 가능성 및 수신 순서 미보장에 관한 기술 유의 사항 추가

## v0.5.11 (2026-04-21)
- **API 데이터 규격 보완**
  - 결제 의사 생성(EBP_API_224) API 요청 필드 추가: `autoCapture` (자동 매입 여부) 반영
  - 결제 생성(EBP_API_230) API 응답 구조 현행화: `status` 필드를 `instructions` 하위로 이동 및 가이드 보완
  - 결제 수단 조회(EBP_API_109) API 응답 필드 추가: `userNo`, `billingAccountNo`, `paymentMethod`, `pgProvider`, `pgChannel` 반영
  - 데이터 규격 명칭 변경: `paymentInstrumentType` 필드 값 중 `SAVED_METHOD`를 `SAVED_PAYMENT_METHOD`로 변경하여 용어 일관성 확보

## v0.5.10 (2026-04-17)
- 결제 의사 생성(EBP_API_224), 결제 생성(EBP_API_230), 결제 수단 생성(EBP_API_120), 결제 수단 등록 완료(EBP_API_121) API 응답 구조 개선
  - 비즈니스 결과 데이터(`data`)와 프로세스 제어 지시 데이터(`instructions`)를 분리하여 가독성 및 연동 편의성 향상
  - `instructions` 객체 내로 `nextStep`, `requiresClientAction`, `clientAction`, `requiresFollowUpApi`, `followUpApi` 등 제어 필드 이동
  - `status` 필드를 `instructions` 내부로 이동하여 클라이언트 상태 제어 역할 명확화
  - `paymentUrl` 필드는 비즈니스 데이터 성격에 따라 `data` 객체 내에 유지
- 결제 생성(EBP_API_230) API 가이드 업데이트
  - 요청 헤더 섹션에서 불필요한 공통 헤더 링크 제거
  - `X-EBP-Context` 헤더 설명 내 참조 필드명 수정 (`paymentContext` → `paymentHeaderContext`)

## v0.5.9 (2026-04-16)
- 결제 수단 생성(EBP_API_120) API 가이드 업데이트
  - 응답 데이터 스펙에 `orderNo`(주문 번호) 필드 추가
- 결제 무효화(`PAYMENT_VOIDED`) Webhook 가이드 업데이트
  - 환불 이벤트 분리에 따른 문서 정교화 및 무효화 전용 필드(`voidedAmount`, `voidedAt`)로 변경
  - 매입 전 전체 취소(Void) 프로세스에 맞게 설명 및 예시 보완
- 결제 환불(`PAYMENT_REFUNDED`) Webhook 가이드 신규 추가
  - 매입 완료 후 전체/부분 취소(Refund) 시 발생하는 이벤트 정의 및 데이터 규격 안내
- 결제 환불 요청(`PAYMENT_REFUND_REQUESTED`) Webhook 가이드 신규 추가
  - 환불 요청 접수 시 발생하는 이벤트 정의 및 데이터 규격 안내
- Webhook 공통 데이터 규격 개선
  - 모든 Webhook 응답 필드명을 `paymentStatusCode`에서 `paymentStatus`로 변경하여 일관성 확보

## v0.5.0 (2026-04-01)
- 최초 배포