Skip to content

Commit

Permalink
릴리즈노트 이관
Browse files Browse the repository at this point in the history
  • Loading branch information
sso-ashley committed May 28, 2024
1 parent 703b12a commit d481293
Show file tree
Hide file tree
Showing 4 changed files with 101 additions and 11 deletions.
43 changes: 43 additions & 0 deletions src/content/release-notes/platform/2023-11-08.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
releasedAt: 2023-11-08
writtenAt: 2023-11-09
---

import * as prose from "~/components/prose";

조금 더 일관성 있는 변수 체계를 만들기 위해 정산 수식에서 쓸 수 있는 변수의 명칭이 변경되며,
플랫폼중개수수료액 수식이 추가 지원됩니다.

## 주요 업데이트 사항

<prose.h3>
✔️ 수식 변수 명칭이 변경되었습니다.
</prose.h3>

- DISCOUNT\_SHARE\_RATE(할인분담률) , PLATFORM\_FEE\_RATE(플랫폼중개수수료률) , ADD\_FEE\_RATE(추가수수료률)
**FIXED\_RATE**(정률)

- ADD\_FEE\_AMOUNT(추가수수료액) , PLATFORM\_FEE\_AMOUNT(플랫폼중개수수료액) → **FIXED\_AMOUNT**(정액)

<prose.h3>
✔️ 추가 수수료 수식에서 신규 변수를 지원합니다.
</prose.h3>

추가 수수료 수식에서는 플랫폼 중개 수수료 수식을 통해 계산된 PLATFORM\_FEE\_AMOUNT(플랫폼중개수수료액)이
추가로 지원됩니다. 이를 통해 추가 수수료를 부여할 때, 결제 혹은 주문 금액 중에서 중개 수수료를 제외한
금액만 추가 수수료를 부여하실 수 있습니다.

## 수식 별 변수 지원 현황

이번 릴리즈를 통해서 각 수식 별로 사용 가능 변수는 아래와 같습니다.

| 영문 변수 명 | 한글 변수 명 |플랫폼수수료수식|할인분담수식|추가수수료수식|
|:---------------------:|:--------------------:|:--------------:|:----------:|:------------:|
| ORDER\_AMOUNT | 주문금액 | O | X | O |
| PAYMENT\_AMOUNT | 결제금액 | O | X | O |
| DISCOUNT\_AMOUNT | 할인금액 | O | O | O |
| FIXED\_RATE | 정률 | O | O | O |
| FIXED\_AMOUNT | 정액 | O | X | O |
|DISCOUNT\_SHARE\_AMOUNT| 할인분담금 | O | X | O |
| PLATFORM\_FEE\_AMOUNT | 플랫폼중개수수료액 | X | X | O |
| PLATFORM\_FEE\_VAT |플랫폼중개수수료부가세| X | X | O |
36 changes: 36 additions & 0 deletions src/content/release-notes/platform/2023-11-14.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
releasedAt: 2023-11-14
writtenAt: 2023-11-15
---

import * as prose from "~/components/prose";

주문 정산 등록 API가 개선되며, 인증 토큰 발급과 관련하여 변경 사항이 있습니다.

## 주요 업데이트 사항

<prose.h3>
✔️ 주문 정산 등록 API가 개선되었습니다.
</prose.h3>

- **paymentId** 기반으로 파트너당 여러 건의 주문 정산 건을 등록할 수 있게됩니다.
- 추후 정산 아이디(transferId) 기반으로 주문 취소 정산을 등록할 수 있는 API도 개발 예정이며, 곧 안내드리겠습니다.

<prose.h3>
✔️ 주문 정산 삭제 API가 추가되었습니다.
</prose.h3>

- 정산 아이디(transferId)를 기반하여 정산이 완료되지 않은(상태: 정산 예정, 정산 중) 정산 건을 삭제할 수 있습니다.
- `DELETE /platform/transfers/{$id}` 요청 본문 없이 호출하여 사용하실 수 있습니다.

<prose.h3>
✔️ 인증 토큰 발급 시 일부 사항이 변경되었습니다.
</prose.h3>

- graphql 중 `loginViaApiKey` mutation이 `loginViaApiSecret` 로 변경됩니다.

- 따라서 rest api 중 `/login/api-key` api는 **deprecate**되고
[API secret 를 사용한 토큰 발급 api](https://developers.portone.io/api/rest-v2/auth#post%20%2Flogin%2Fapi-secret)
추가됩니다.

- `/login/api-key`의 경우, 하위 호환성 보장을 위해 24년 3월까지 사용이 가능하나, 가급적 변경해주시길 바랍니다.
32 changes: 22 additions & 10 deletions src/content/release-notes/platform/2024-05-20.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,20 +11,32 @@ import Image1 from "./_assets/2024-05-20/screenshot1.png";
## 주요 업데이트 사항

<prose.h3>
✔️ 파트너정산 자동화 서비스 기능이 업데이트되었습니다.
✔️ 상세 내역 다운로드 API가 추가되었습니다.
</prose.h3>

- **\[상세 내역 조회]**

- \[상세 내역 조회] 페이지에서 정산 상세 내역을 CSV 파일로 다운로드할 수 있습니다.
- 파일 다운로드 후 상세 내역을 확인하고 정산 명세서를 손쉽게 정리해보세요.
- \[상세 내역 조회] 페이지에서 정산 상세 내역을 CSV 파일로 다운로드할 수 있습니다.
- 파일 다운로드 후 상세 내역을 확인하고 정산 명세서를 손쉽게 정리해보세요.

<Figure src={Image1} />

- **\[파트너 관리]**
<prose.h3>
✔️ 예금주 조회 API 응답 본문이 변경되었습니다.
</prose.h3>

- 예금주 조회 API 요청 후 정상 인증 완료 시 응답 본문에 `accountVerificationId`가 추가되었습니다.

<prose.h3>
✔️ 파트너 관리 API 요청/응답 본문이 일부 변경되었습니다.
</prose.h3>

- 파트너 생성/다건 생성/수정 API 요청 시 파트너 유형이 비사업자 (원천징수납세자)인 경우,
생년월일을 선택적으로 등록할 수 있습니다.
- 생년월일을 입력할 경우, 8자리로 입력 가능합니다. ex. (YYYYMMDD/YYYY-MM-DD)로 입력 가능

- 파트너 유형이 비사업자 (원천징수납세자)인 경우, 생년월일을 선택적으로 등록할 수 있습니다.
- 생년월일을 입력할 경우, 8자리로 입력 가능합니다.
- 파트너 조회/다건 조회/생성/다건 생성/수정/보관/복원 API 응답 시 파트너 사업자 상태 필드(`businessStatus`)가
추가되었습니다. 사업자등록번호(`businessRegistrationNumber`)가 변경되거나 기입하여 생성한 경우에 사업자
상태가 업데이트 됩니다.

- 파트너를 등록하거나 수정할 때 예금주 계좌조회에 실패하더라도 파트너를 등록할 수 있습니다.
- 계좌조회가 어려운 경우 고객사가 직접 계좌 정보를 입력할 수 있습니다.
- 파트너 생성/수정 API 요청 시 예금주 계좌조회에 실패하더라도 파트너를 등록할 수 있습니다. 계좌조회가
어려운 경우 고객사가 직접 계좌 정보를 입력할 수 있습니다.
- 예금주 조회에서 발급받은 `accountVerificationId`를 사용하여 추가적인 계좌 인증을 생략할 수 있습니다.
1 change: 0 additions & 1 deletion src/layouts/sidebar/LeftSidebarItem.tsx
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
import { useSystemVersion } from "#state/system-version";
import { useComputed } from "@preact/signals";

import { useSystemVersion } from "#state/system-version";
Expand Down

0 comments on commit d481293

Please sign in to comment.