Change Log #

v0.5.12 (2026-04-22) #

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

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로 변경하여 용어 일관성 확보

결제 의사 생성(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)

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