# Change Log ## 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) - 최초 배포