Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

스마트로 퀵 가이드 내용 추가 #749

Merged
merged 3 commits into from
Feb 10, 2025
Merged

스마트로 퀵 가이드 내용 추가 #749

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ea3c7d8
feat: smartro quick guide
kiwiyou Feb 7, 2025
cde2155
feat: bypass
kiwiyou Feb 7, 2025
5317b77
fix: move warning
kiwiyou Feb 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
83 changes: 81 additions & 2 deletions src/routes/(root)/opi/ko/quick-guide/payment/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,12 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
</Hint>
</Condition>

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 영문 대소문자, 숫자만 허용되며, 40자 이하로 입력합니다.
</Hint>
</Condition>

- orderName: string

**주문명**
Expand All @@ -135,6 +141,12 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
</Hint>
</Condition>

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 최대 40바이트까지 입력할 수 있습니다.
</Hint>
</Condition>

- totalAmount: number

**결제 금액**
Expand Down Expand Up @@ -299,6 +311,12 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
</Hint>
</Condition>

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 전북카드, 카카오뱅크 카드는 Windows에서만 단독 노출이 가능합니다.
</Hint>
</Condition>

<Condition when={({ pg: { name } }) => name === 'kcp'}>
<Hint style="warning">
KCP의 경우 카드사 단독 노출 시 `bypass.kcp_v2.site_name`을 필수로 지정해야 할 수 있습니다.
Expand Down Expand Up @@ -396,13 +414,25 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
</Hint>
</Condition>

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 신용카드 할부 이용 시 별도 계약이 필요합니다.
</Hint>
</Condition>

<Parameter.Details>
- freeInstallmentPlans?: object\[]

**무이자 할부 설정**

고객사가 부담하는 무이자 할부 설정입니다.

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 상점 부담 무이자 할부 이용 시 별도 계약이 필요합니다.
</Hint>
</Condition>

<Parameter.Details>
- cardCompany: string

Expand Down Expand Up @@ -432,15 +462,15 @@ import { Condition, InteractiveDoc, Section } from "./_preview";

구매자가 할부 개월 수를 선택할 수 있도록 하려면 `availableMonthList`를 사용해주세요.

<Condition when={({ pg: { name }}) => name !== 'kcp'}>
<Condition when={({ pg: { name }}) => !['kcp', 'smartro'].includes(name)}>
- availableMonthList: number\[]

**구매자가 선택할 수 있는 할부 개월 수 목록**
</Condition>
</Parameter.Details>
</Parameter.Details>

<Condition when={({ pg: { name }}) => name !== 'kcp'}>
<Condition when={({ pg: { name }}) => !['kcp', 'smartro'].includes(name)}>
- useCardPoint?: boolean

**카드사 포인트 사용 여부**
Expand Down Expand Up @@ -486,12 +516,26 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
- `PERSONAL` (소득공제용)
- `CORPORATE` (지출증빙용)
- `ANONYMOUS` (미발행(국세청번호 자동발급))

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 `cashReceiptType`과 `bankCode`를 같이 사용해야 합니다.
</Hint>
</Condition>
</Condition>

<Condition when={({ pg: {name }}) => name !== 'kcp'}>
- customerIdentifier?: string

**현금영수증 발행 대상 식별 정보**

소득공제용(`PERSONAL`)의 경우 전화번호를, 지출증빙용(`CORPORATE`)의 경우 사업자번호를 입력하며, 미발행(`ANONYMOUS`)의 경우 무시됩니다.

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 `cashReceiptType`에 `ANONYMOUS` 외의 값이 설정되면 올바른 `customerIdentifier`를 반드시 입력해야 합니다.
</Hint>
</Condition>
</Condition>

<Condition when={({ pg: {name }}) => name !== 'kcp'}>
Expand Down Expand Up @@ -1257,6 +1301,29 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
</Parameter.Details>
</Condition>

<Condition when={({ pg: { name } }) => name === 'smartro'}>
- smartro\_v2?: object

<Parameter.Details>
- GoodsCnt?: number

**결제 상품 품목 개수**

- SkinColor?: string

**결제창 색상**

`RED`, `GREEN`, `BLUE`, `PURPLE`을 선택할 수 있으며, 기본값은 `RED`입니다.

- OpenType?: string

**허용 카드 국가 설정**

- `KR`: 국내 카드만 허용 (기본값)
- `EN`: 해외 카드만 허용
</Parameter.Details>
</Condition>

<Condition when={({ pg: { name }}) => name === "kcp"}>
- kcp\_v2?: object

Expand Down Expand Up @@ -1368,6 +1435,12 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
</Hint>
</Condition>

<Condition when={({ pg: { name, payMethods } }) => name === 'smartro' && payMethods === 'mobile'}>
<Hint style="warning">
스마트로 휴대폰 소액결제 시 `productType`는 필수 입력이며, 상점에 설정된 상품 유형과 입력된 상품 유형이 다른 경우 결제가 실패합니다.
</Hint>
</Condition>

- offerPeriod?: oneof object

**서비스 제공 기간**
Expand All @@ -1387,6 +1460,12 @@ import { Condition, InteractiveDoc, Section } from "./_preview";
- to?: string

**종료 시점**

<Condition when={({ pg: { name } }) => name === 'smartro'}>
<Hint style="warning">
스마트로의 경우 `from`과 `to`를 동시에 입력해야 합니다.
</Hint>
</Condition>
</Parameter.Details>

- interval?: string
Expand Down