2025년 10월 02일 파트너 정산 자동화 업데이트 소식을 안내드립니다.
안녕하세요 파트너 정산 자동화팀입니다.
2025년 10월 02일 업데이트 사항을 확인해 보세요.
파트너 정산 자동화 제품의 테스트 환경 확장에 따른 API 변경 사항을 안내드립니다.
✔️**[파트너 정산 자동화]테스트 환경 분리 및 API 변경 사전 안내**
이번 업데이트로 운영 환경과 테스트 환경이 완전히 분리되어, 설정·정산 정책·내역서 템플릿 등을 독립적으로 관리하실 수 있습니다
주요 변경 사항
- 신규 쿼리 파라미터: test: Boolean (선택값)
- 적용 대상: 모든 파트너 정산 REST API
- 적용 예정 일자: 2025년 11월 중 (정확한 일자는 추후 별도 안내 예정)
- 기본값: false
- 연동 환경 별 설정 - 라이브: 하위호환성이 보장되어 영향이 없습니다. - 테스트: test=true 쿼리 파라미터 추가 설정이 필요합니다.
- 이번 변경으로 라이브/테스트 환경이 완전히 분리되어 더욱 자유로운 테스트가 가능해집니다.기존 데이터는 테스트 및 라이브 환경에 복제되어 기존 그대로 활용하실 수 있습니다.
개선 사항
1. 정산 정책 및 수식 테스트 환경 분리
기존에는 정산 정책 및 정산 수식을 변경할 때 별도의 테스트 환경이 없어 운영에 영향을 줄 우려가 있었습니다.
이번 개선으로 라이브 환경과 완전히 분리된 테스트 환경을 제공하여, 정산 정책 및 수식을 실제 운영에 영향 없이 안전하게 테스트할 수 있습니다.
2. 파트너 데이터 환경 분리
테스트를 위해 등록한 파트너가 라이브 데이터에 그대로 남아 실제 파트너와 함께 조회되는 불편함이 있었습니다.
테스트용 파트너는 테스트 환경에 별도로 등록하여, 실제 파트너 데이터와 분리하여 관리할 수 있습니다.
3. 국세청 연동 환경 분리
국세청 연동 시 라이브와 테스트 환경에 동시에 연동되어 불필요한 연동 안내 메일을 중복으로 받는 문제가 있었습니다.
환경별로 독립적인 국세청 연동이 가능해져 필요한 환경에서만 선택적으로 연동할 수 있습니다.
세부 변경 사항
1. 기존 요청 본문에서 테스트 환경 구분이 가능한 API
요청 본문(body)의
isForTest 파라미터로 환경을 지정하던 방식은 deprecated 되었습니다.
쿼리 파라미터 test 로 대체 해 주시기 바랍니다. deprecated 필드는 2026년 이후 별도 공지와 함께 지원이 중단될 예정입니다.우선순위는 아래와 같습니다.
- Query Parameter 의미
test(최우선) - Request Body 의
isForTest(Query Parameter 없을 때) - 기본값
false(둘 다 없을 때)
영향 받는 API는 다음과 같습니다.
- 정산 상세 내역 다운로드
GET /platform/transfer-summaries/sheet-file - 정산건 다건 조회
GET /platform/transfer-summaries - 수기 정산건 생성
POST /platform/transfers/manual - 주문 정산건 생성
POST /platform/transfers/order - 주문 취소 정산건 생성
POST /platform/transfers/order-cancel - 정산 내역 다건 조회
GET /platform/partner-settlements - 지급 내역 다건 조회
GET /platform/payouts - 일괄 지급 내역 다건 조회
GET /platform/bulk-payouts - 이체 내역 다건 조회
GET /platform/account-transfers - 일괄 이체 내역 다건 조회
GET /platform/bulk-account-transfers
2. 테스트 환경 지정이 필요한 API
테스트 환경 지정을 위해 쿼리 파라미터
test가 추가되었습니다.해당 파라미터는 선택 값이며 기본값은
false입니다.영향받는 API는 아래 업데이트 보러가기 에서 확인 하실 수 있습니다.