Change Log #

v0.5.21 (2026-06-11) #

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

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

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

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

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

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

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

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

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

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