개발자센터
원 페이먼트 인프라
파트너 정산 자동화
API & SDK
리소스

2026-03-06 파트너 정산 자동화 업데이트

2026-03-06 파트너 정산 자동화 업데이트 소식을 안내드립니다.

Release Notes Banner

안녕하세요, 포트원 파트너 정산 자동화팀 입니다.

파트너 정산 자동화 제품에 대한 전반적인 사용성 개선과 안정화에 대한 업데이트가 진행됨에 따라 업데이트 사항을 안내해 드립니다.

정산 상세 내역의 상태 라벨 개선

정산 상세 내역에서 상태의 명칭이 불명확한 부분을 개선하였습니다.

기존신규설명
정산 예정정산 예정정산 시작일에 도래하지 않아 아직 금액 및 정산일 확정이 안된 경우
정산 중정산 중정산 시작일을 지나 정산 금액 및 정산일이 확정된 상태
정산 완료정산 확정정산일이 지나 지급 가능한 상태
N/A지급 확정특정 지급건에 집계되어 이체 가능한 상태
이체 중지급 중지급이 예약되어 있거나 지급이 진행중인 상태
이체 완료지급 완료지급 및 정산이 완료된 상태
정산 상세 내역 상태 라벨 개선 화면
정산 상세 내역 상태 라벨 개선 화면

정산 상세 내역 및 정산 내역 삭제 기능 지원

정산 내역 및 정산 상세 내역에 특정 상태인 데이터 삭제가 콘솔 및 API로 제공됩니다.

삭제 가능한 상태

  • 정산 상세 내역(주문/수기 정산건): 정산 예정, 정산 중, 정산 확정
  • 정산 내역: 지급 예정, 지급 보류, 지급 취소, 지급 제외

유의 사항

  • 삭제된 데이터에 대한 복원은 불가능합니다.
  • 정산 내역 건별 삭제 시 연관된 정산 상세 내역(주문/수기정산건)이 삭제 가능하다면 함께 삭제됩니다.
정산 내역/상세 내역 삭제 기능 (1)
정산 내역/상세 내역 삭제 기능 (1)
정산 내역/상세 내역 삭제 기능 (2)
정산 내역/상세 내역 삭제 기능 (2)

정산 내역 지급 예정 상태로 복원 시 오류 해결

기존 지급 보류/지급 실패 상태에서 지급 예정 상태로 변경 시 오류가 발생하였으나 해당 부분이 해결되었습니다.

위 오류는 상태 변경 과정에서 같은 집계 조건의 지급 예정 상태의 내역이 추가 생성된 경우 발생하는 오류로, 현재는 지급 예정 상태의 내역을 중복 적재 가능하게 개선하였습니다.

지급 예정 복원 오류 개선
지급 예정 복원 오류 개선

비활성화 가상 계좌 노출 지원

더즌 계좌 변경 안내에 따라서 신규 계좌 발급이 완료되었습니다. 다만 기존 계좌의 내역 조회를 지속 지원해드리기 위해 비활성 상태로 계좌 노출이 지원됩니다.

안내 사항

  • 비활성 계좌도 이전 입출금 내역에 대해 확인하실 수 있습니다.
  • 비활성 계좌는 출금/지급 시 활용할 수 없으며, 잔액 조회가 불가합니다.
비활성화 가상 계좌 노출
비활성화 가상 계좌 노출

출금 시 입금 계좌 예금주 저장

기존 예치금 출금 시 조회된 입금 계좌 예금주가 이체 내역에 반영되지 않던 부분을 개선하였습니다. 배포 이후로 진행되는 모든 출금 건들에 대해서 입금 대상 계좌에 대한 예금주 정보가 저장됩니다.

이체 속도 개선

현재 이체 프로세스를 개선하여 기존보다 3배 더 많은 이체 건들을 병렬 처리할 수 있게 되었습니다.

이체 속도 개선
이체 속도 개선

정산 내역 ‘지급 제외’ 상태 추가

정산 내역 중 영구적으로 지급을 제외할 데이터를 관리하기 위한 “지급 제외” 상태를 추가합니다.

  • 지급 보류/취소/예정 상태와 별개로 정산 내역에 “지급 제외” 상태가 추가됩니다.
  • “지급 제외” 상태는 지급이 불가능한 상태입니다. (지급 내역 확정 시 자동 제외됩니다.)
  • “지급 제외” 상태는 “지급 보류 / 지급 예정” 상태로 변경할 수 있습니다.
  • “지급 보류 / 취소 / 예정” 상태에서 “지급 제외” 상태로 변경할 수 있습니다.
정산 내역 ‘지급 제외’ 상태
정산 내역 ‘지급 제외’ 상태

세금계산서 기능 개선

  • 거래처 관리 엑셀 다운로드 시 주소/업태/업종 데이터가 추가됩니다.
  • ‘요청’ 상태의 세금계산서를 회수 없이 메일 주소만 변경하여 재전송 가능하도록 개선됩니다.
  • 세금계산서 메뉴에서 상태값 외 다른 항목(예: 발행일, 금액 등)으로도 필터 및 정렬(오름/내림차순) 가능하도록 개선됩니다.
  • 세금계산서 내역 관리에서 체크박스 일괄 ‘발행취소, 삭제, 재전송’ 기능이 가능하도록 개선됩니다.

API 변경 사항 안내

A. 정산 내역 삭제 API 제공

오등록되거나 재등록이 필요한 정산 데이터를 삭제하기 위해서 정산 내역 단위 삭제 API가 제공됩니다.
해당 정산 내역을 삭제하시게 되면 연관된 정산 상세 내역 데이터와 함께 삭제가 진행되므로 유의하여 활용해주시길 바랍니다.

POST /platform/partner-settlements/delete?test=false
Content-Type: application/json

{
  "partnerSettlementIds": []
}
  • 해당 API는 unstable 입니다.

B. 정산 내역 일괄 지급 처리 API 제공

외화 정산 내역의 경우에는 현재 지급 대행 등이 제공되지 않아 지급 건을 수기 보정 요청주시던 부분에 대해서 직접 보정이 가능하도록 API를 제공합니다. 해당 API를 활용하시면 자동적으로 일괄 지급 / 지급 내역 등을 생성하여 지급 완료 상태로 데이터가 보정됩니다.

POST /platform/partner-settlements/complete-payout?test=false
Content-Type: application/json

{
  "bulkPayoutId": "",
  "name": "",
  "partnerSettlementIds": [],
  "completeAt": "2026-02-01"
}
  • 해당 API는 unstable 입니다.

C. 주문 정산 / 주문 취소 정산 / 수기 정산 등록 시 id 직접 지정 가능

중복 등록 방지 및 고객사 자체 아이디 매핑을 위해 주문/주문 취소/수기 정산 등록 시 id 필드를 직접 지정할 수 있습니다. id 필드가 지정되지 않은 경우에는 자동 생성되며 기존과 같이 활용하실 수 있습니다.

POST /platform/transfers/manual
POST /platform/transfers/order
POST /platform/transfers/order-cancel

Content-Type: application/json

{
  "id": "custom-id"
  // ... 기존 API 명세
}

참고: order-cancel 의 경우 transfer_id 와 id 가 동시에 존재하는데, transfer_id 는 기존과 같이 취소 대상 원본 주문 정산 건에 대한 식별자입니다.

D. 정산 상세 다건 조회 API 사용자 정의 속성 검색 지원 및 성능 개선

정산 상세 내역 조회 시 사용자 정의 속성에 대한 지원이 추가됩니다. 접두사 일치로 검색이 지원됩니다.

POST /platform/transfer-summaries
Content-Type: application/json

{
  "filter": {
    "userDefinedProperty": {
      "key": "USER DEFINED KEY",
      "value": "exact match"
    }
  }
  // ...
}

또한 정산 상세 다건 조회 시 파트너 정보 조회 비용을 최적화하여 조회 성능을 개선하였습니다. P50 기준 내부 테스트 결과 60% 이상의 latency 감소가 확인되었습니다.

작성일자: 2026년 3월 3일


작성일자 2026년 3월 6일


일반 문의cs@portone.io
기술지원 문의tech.support@portone.io

포트원 서비스 더 알아보기 →