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.

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

다이렉트 지원 여부 및 pgCode, pgMessage 관련 설명 수정 #666

Merged
merged 2 commits into from
Nov 21, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
Original file line number Diff line number Diff line change
Expand Up @@ -164,7 +164,6 @@ import Hint from "~/components/Hint";
- USD 결제의 경우 순수 해외 카드만 결제 가능합니다.
- 페이코, 카카오페이의 경우 카드번호 혹은 카드bin 정보를 제공하지 않습니다.
- 주문자 이메일(`buyer_email`)은 선택 입력 항목이지만 에스크로 결제에서 구매확인 이메일 수신을 위해 필수로 입력해야 합니다.
- 간편결제 다이렉트 호출은 현재 지원하지 않습니다.
- 발급사가 비씨,국민,하나,삼성,신한,현대,롯데,농협인 경우에 `고객사 무이자 할부`를 설정할 수 있습니다.
- 결제 취소 시 부분취소는 9회까지 가능합니다. (카드결제, 가상계좌, 계좌이체)
- 취소는 결제일 기준으로 6개월까지만 가능합니다.
Expand Down
24 changes: 14 additions & 10 deletions src/routes/(root)/opi/ko/integration/start/v2/checkout.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -95,11 +95,13 @@ async function requestPayment() {

결과값에 들어 있는 필드는 다음과 같습니다.

|필드명 |설명 |비고 |
|---------|----------|-------|
|paymentId|결제 건 ID|공통 |
|code |오류 코드 |실패 시|
|message |오류 문구 |실패 시|
|필드명 |설명 |비고 |
|---------|-------------------|----------------------------|
|paymentId|결제 건 ID |공통 |
|code |오류 코드 |실패 시 |
|message |오류 문구 |실패 시 |
|pgCode |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시|
|pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시|

### 3-1. redirect 방식의 경우

Expand All @@ -116,11 +118,13 @@ PortOne.requestPayment({

쿼리 문자열로 전달되는 내용은 다음과 같습니다.

|키 |설명 |비고 |
|---------|----------|-------|
|paymentId|결제 건 ID|공통 |
|code |오류 코드 |실패 시|
|message |오류 문구 |실패 시|
|키 |설명 |비고 |
|---------|-------------------|----------------------------|
|paymentId|결제 건 ID |공통 |
|code |오류 코드 |실패 시 |
|message |오류 문구 |실패 시 |
|pgCode |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시|
|pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시|

예를 들어 paymentId가 `payment-39ecfa97`, redirectUrl이 `https://example.com/payment-redirect`인 경우,
결제 성공 시에 `https://example.com/payment-redirect?paymentId=payment-39ecfa97`로 리다이렉트됩니다.
Expand Down
6 changes: 3 additions & 3 deletions src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -78,8 +78,8 @@ import Hint from "~/components/Hint";
</Details>

<Hint style="warning">
pg 파라미터는 지원 중단 예정입니다.
pg 파라미터는 지원 중단 예정입니다.

JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
</Hint>

Expand Down Expand Up @@ -391,7 +391,7 @@ const param = {
<Hint style="danger">
**주의사항**

- 현재 **KG이니시스, KCP, 토스페이먼츠, 나이스페이먼츠, KICC, 다날** 6개 PG사에 대해서만 카드사 결제창 direct 호출이 가능합니다.
- PG마다 다이렉트 호출 지원 여부가 상이합니다. PG별 가이드 문서 및 테스트를 통해 다이렉트 호출이 가능한지 확인해주세요.
- 일부 PG사의 경우 승인된 상점아이디에 대해서만 카드사 결제창 direct 노출 기능을 지원합니다. 반드시 포트원을 통해 현재 사용중인 상점아이디가 카드사 결제창 direct 호출이 가능한지 확인해주세요.
</Hint>

Expand Down
16 changes: 8 additions & 8 deletions src/routes/(root)/sdk/ko/v2-sdk/billing-key-response.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,24 +22,24 @@ versionVariants:

### **`code`** <mark style="color:green;">**string**</mark>

**에러 코드**
**오류 코드**

- 에러가 있는 경우 에러 코드입니다.
- 실패한 경우 오류 코드입니다.

### **`message`** <mark style="color:green;">**string**</mark>

**에러 메시지**
**오류 메시지**

- 에러가 있는 경우 에러 메시지입니다.
- 실패한 경우 오류 메시지입니다.

### **`pgCode`** <mark style="color:green;">**string**</mark>

**PG 에러 코드**
**PG 오류 코드**

- PG에서 에러 코드를 내려 주는 경우 이 에러 코드를 그대로 반환합니다.
- PG에서 오류 코드를 내려 주는 경우 이 오류 코드를 그대로 반환합니다.

### **`pgMessage`** <mark style="color:green;">**string**</mark>

**PG 에러 메시지**
**PG 오류 메시지**

- PG에서 에러 메시지를 내려 주는 경우 이 에러 메시지를 그대로 반환합니다.
- PG에서 오류 메시지를 내려 주는 경우 이 오류 메시지를 그대로 반환합니다.
Original file line number Diff line number Diff line change
Expand Up @@ -22,30 +22,30 @@ versionVariants:

### **`identityVerificationTxId`** <mark style="color:green;">**string**</mark>

**포트원에서 채번한 본인인증 트랜잭션 ID**
**본인인증 시도 고유 번호**

- 포트원에서 채번하는 본인인증 고유 번호입니다.
- 포트원에서 채번하는 본인인증 시도 고유 번호입니다.

### **`code`** <mark style="color:green;">**string**</mark>

**에러 코드**
**오류 코드**

- 에러가 있는 경우 에러 코드입니다.
- 실패한 경우 오류 코드입니다.

### **`message`** <mark style="color:green;">**string**</mark>

**에러 메시지**

- 에러가 있는 경우 에러 메시지입니다.
- 실패한 경우 오류 메시지입니다.

### **`pgCode`** <mark style="color:green;">**string**</mark>

**PG 에러 코드**
**PG 오류 코드**

- PG에서 에러 코드를 내려 주는 경우 이 에러 코드를 그대로 반환합니다.
- PG에서 오류 코드를 내려 주는 경우 이 오류 코드를 그대로 반환합니다.

### **`pgMessage`** <mark style="color:green;">**string**</mark>

**PG 에러 메시지**
**PG 오류 메시지**

- PG에서 에러 메시지를 내려 주는 경우 이 에러 메시지를 그대로 반환합니다.
- PG에서 오류 메시지를 내려 주는 경우 이 오류 메시지를 그대로 반환합니다.
20 changes: 10 additions & 10 deletions src/routes/(root)/sdk/ko/v2-sdk/payment-response.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,30 +22,30 @@ versionVariants:

### **`txId`** <mark style="color:green;">**string**</mark>

**포트원에서 채번한 결제 트랜잭션 ID**
**결제 시도 고유 번호**

- 포트원에서 채번하는 결제 고유 번호입니다.
- 포트원에서 채번하는 결제 시도 고유 번호입니다.

### **`code`** <mark style="color:green;">**string**</mark>

**에러 코드**
**오류 코드**

- 에러가 있는 경우 에러 코드입니다.
- 실패한 경우 오류 코드입니다.

### **`message`** <mark style="color:green;">**string**</mark>

**에러 메시지**
**오류 메시지**

- 에러가 있는 경우 에러 메시지입니다.
- 실패한 경우 오류 메시지입니다.

### **`pgCode`** <mark style="color:green;">**string**</mark>

**PG 에러 코드**
**PG 오류 코드**

- PG에서 에러 코드를 내려 주는 경우 이 에러 코드를 그대로 반환합니다.
- PG에서 오류 코드를 내려 주는 경우 이 오류 코드를 그대로 반환합니다.

### **`pgMessage`** <mark style="color:green;">**string**</mark>

**PG 에러 메시지**
**PG 오류 메시지**

- PG에서 에러 메시지를 내려 주는 경우 이 에러 메시지를 그대로 반환합니다.
- PG에서 오류 메시지를 내려 주는 경우 이 오류 메시지를 그대로 반환합니다.