Skip to content

Commit

Permalink
Update smartro-v2.mdx
Browse files Browse the repository at this point in the history
 ParamTree 추가
  • Loading branch information
sso-ashley authored Mar 11, 2024
1 parent 7fa8486 commit b0f3e76
Showing 1 changed file with 50 additions and 0 deletions.
50 changes: 50 additions & 0 deletions src/content/docs/ko/v2-payment/pg/smartro-v2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -829,6 +829,7 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

#### 빌링키 발급 주요 파라미터

<ParamTree>
- `channelKey` <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**채널 키**
Expand All @@ -845,10 +846,14 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**카드 결제 시 파라미터**

<ParamTree>

- `credential` <mark style="color:green;">**string**</mark>

**인증 관련 정보**

<ParamTree>

- `number` <mark style="color:blue;">**object**</mark>

**카드 번호**
Expand All @@ -869,17 +874,30 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**비밀번호 앞 두자리**

</ParamTree>

</ParamTree>

<ParamTree>
- `customer` <mark style="color:blue;">**object**</mark>

**고객 정보**

<ParamTree>

- `customerId` <mark style="color:green;">**string**</mark>

**구매자 고유 ID**

- 스마트로의 경우 빌링키 발급 시 필수로 입력해야 합니다.
- 20자 이하로만 입력 가능합니다.

</ParamTree>

</ParamTree>

</ParamTree>

### API 빌링키 단건 결제 요청하기

발급된 빌링키로 단건 결제를 하기 위해 `POST /payments/${PAYMENT_ID_HERE}/billing-key`를 이용하여 결제를 요청합니다.
Expand Down Expand Up @@ -916,6 +934,8 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

#### 빌링키 단건 결제 주요 파라미터

<ParamTree>

- `paymentId` <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**결제 주문 번호**
Expand All @@ -935,12 +955,16 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**결제 금액**

<ParamTree>

- `total` <mark style="color:red;">**\***</mark> <mark style="color:purple;">**number**</mark>

**총 결제 금액**

결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.

</ParamTree>

- `currency` <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**결제 통화**
Expand All @@ -951,10 +975,14 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**고객 정보**

<ParamTree>

- `name` <mark style="color:blue;">**object**</mark>

**고객 이름**

<ParamTree>

- `full` <mark style="color:green;">**string**</mark>

**한 줄 이름 형식 (ex. 김포트)**
Expand All @@ -963,6 +991,8 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**분리된 이름**

<ParamTree>

- `first` <mark style="color:green;">**string**</mark>

**이름**
Expand All @@ -971,6 +1001,10 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

****

</ParamTree>

</ParamTree>

- `phoneNumber` <mark style="color:green;">**string**</mark>

**구매자 연락처**
Expand All @@ -979,10 +1013,14 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**구매자 이메일**

</ParamTree>

- `productCount` <mark style="color:purple;">**integer**</mark>

**상품 개수**

</ParamTree>

### API 빌링키 예약/반복 결제

예약 결제를 하기위해서는 `POST /payments/${PAYMENT_ID_HERE}/schedule` 를 이용하여 결제를 예약합니다.
Expand Down Expand Up @@ -1017,6 +1055,8 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

#### 빌링키 예약 결제 주요 파라미터

<ParamTree>

- `paymentId` <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**결제 주문 번호**
Expand All @@ -1028,6 +1068,8 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**빌링키 결제 요청 입력정보**

<ParamTree>

- `billingKey` <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**빌링키 결제에 사용할 빌링키**
Expand All @@ -1040,18 +1082,26 @@ import Tabs from "~/components/gitbook/tabs/Tabs.astro";

**결제 금액**

<ParamTree>

- `total` <mark style="color:red;">**\***</mark> <mark style="color:purple;">**number**</mark>

**총 결제 금액**

결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.

</ParamTree>

- `currency` <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**결제 통화**

결제통화로 원화 결제 시 `KRW`로 입력해야 합니다.

</ParamTree>

- `timeToPay` <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**결제 예정 시점**

</ParamTree>

0 comments on commit b0f3e76

Please sign in to comment.