From 463de6389d81b9b8a43fa3ad7a7223a4e00721a2 Mon Sep 17 00:00:00 2001 From: finalchild Date: Tue, 12 Nov 2024 15:55:57 +0900 Subject: [PATCH 1/2] fix: outdated direct support information --- .../(root)/opi/ko/integration/pg/v1/ksnet/warning.mdx | 1 - src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx | 6 +++--- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/warning.mdx b/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/warning.mdx index 3cd045f08..564e85c45 100644 --- a/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/warning.mdx +++ b/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/warning.mdx @@ -164,7 +164,6 @@ import Hint from "~/components/Hint"; - USD 결제의 경우 순수 해외 카드만 결제 가능합니다. - 페이코, 카카오페이의 경우 카드번호 혹은 카드bin 정보를 제공하지 않습니다. - 주문자 이메일(`buyer_email`)은 선택 입력 항목이지만 에스크로 결제에서 구매확인 이메일 수신을 위해 필수로 입력해야 합니다. - - 간편결제 다이렉트 호출은 현재 지원하지 않습니다. - 발급사가 비씨,국민,하나,삼성,신한,현대,롯데,농협인 경우에 `고객사 무이자 할부`를 설정할 수 있습니다. - 결제 취소 시 부분취소는 9회까지 가능합니다. (카드결제, 가상계좌, 계좌이체) - 취소는 결제일 기준으로 6개월까지만 가능합니다. diff --git a/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx b/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx index 70530f158..afc3fc232 100644 --- a/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx +++ b/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx @@ -78,8 +78,8 @@ import Hint from "~/components/Hint"; - pg 파라미터는 지원 중단 예정입니다. - + pg 파라미터는 지원 중단 예정입니다. + JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요. @@ -391,7 +391,7 @@ const param = { **주의사항** - - 현재 **KG이니시스, KCP, 토스페이먼츠, 나이스페이먼츠, KICC, 다날** 6개 PG사에 대해서만 카드사 결제창 direct 호출이 가능합니다. + - PG마다 다이렉트 호출 지원 여부가 상이합니다. PG별 가이드 문서 및 테스트를 통해 다이렉트 호출이 가능한지 확인해주세요. - 일부 PG사의 경우 승인된 상점아이디에 대해서만 카드사 결제창 direct 노출 기능을 지원합니다. 반드시 포트원을 통해 현재 사용중인 상점아이디가 카드사 결제창 direct 호출이 가능한지 확인해주세요. From aa2a9b4cb3b15bf89e04ec626f76b661d9e8f49a Mon Sep 17 00:00:00 2001 From: finalchild Date: Tue, 12 Nov 2024 16:02:26 +0900 Subject: [PATCH 2/2] chore: edit pgCode, pgMessage docs --- .../opi/ko/integration/start/v2/checkout.mdx | 24 +++++++++++-------- .../sdk/ko/v2-sdk/billing-key-response.mdx | 16 ++++++------- .../v2-sdk/identity-verification-response.mdx | 18 +++++++------- .../(root)/sdk/ko/v2-sdk/payment-response.mdx | 20 ++++++++-------- 4 files changed, 41 insertions(+), 37 deletions(-) diff --git a/src/routes/(root)/opi/ko/integration/start/v2/checkout.mdx b/src/routes/(root)/opi/ko/integration/start/v2/checkout.mdx index beb01e2ce..2b4562dde 100644 --- a/src/routes/(root)/opi/ko/integration/start/v2/checkout.mdx +++ b/src/routes/(root)/opi/ko/integration/start/v2/checkout.mdx @@ -95,11 +95,13 @@ async function requestPayment() { 결과값에 들어 있는 필드는 다음과 같습니다. -|필드명 |설명 |비고 | -|---------|----------|-------| -|paymentId|결제 건 ID|공통 | -|code |오류 코드 |실패 시| -|message |오류 문구 |실패 시| +|필드명 |설명 |비고 | +|---------|-------------------|----------------------------| +|paymentId|결제 건 ID |공통 | +|code |오류 코드 |실패 시 | +|message |오류 문구 |실패 시 | +|pgCode |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시| +|pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시| ### 3-1. redirect 방식의 경우 @@ -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`로 리다이렉트됩니다. diff --git a/src/routes/(root)/sdk/ko/v2-sdk/billing-key-response.mdx b/src/routes/(root)/sdk/ko/v2-sdk/billing-key-response.mdx index 16797ba94..47cc7339c 100644 --- a/src/routes/(root)/sdk/ko/v2-sdk/billing-key-response.mdx +++ b/src/routes/(root)/sdk/ko/v2-sdk/billing-key-response.mdx @@ -22,24 +22,24 @@ versionVariants: ### **`code`** **string** -**에러 코드** +**오류 코드** -- 에러가 있는 경우 에러 코드입니다. +- 실패한 경우 오류 코드입니다. ### **`message`** **string** -**에러 메시지** +**오류 메시지** -- 에러가 있는 경우 에러 메시지입니다. +- 실패한 경우 오류 메시지입니다. ### **`pgCode`** **string** -**PG 에러 코드** +**PG 오류 코드** -- PG에서 에러 코드를 내려 주는 경우 이 에러 코드를 그대로 반환합니다. +- PG에서 오류 코드를 내려 주는 경우 이 오류 코드를 그대로 반환합니다. ### **`pgMessage`** **string** -**PG 에러 메시지** +**PG 오류 메시지** -- PG에서 에러 메시지를 내려 주는 경우 이 에러 메시지를 그대로 반환합니다. +- PG에서 오류 메시지를 내려 주는 경우 이 오류 메시지를 그대로 반환합니다. diff --git a/src/routes/(root)/sdk/ko/v2-sdk/identity-verification-response.mdx b/src/routes/(root)/sdk/ko/v2-sdk/identity-verification-response.mdx index 9204179bd..b03344dd7 100644 --- a/src/routes/(root)/sdk/ko/v2-sdk/identity-verification-response.mdx +++ b/src/routes/(root)/sdk/ko/v2-sdk/identity-verification-response.mdx @@ -22,30 +22,30 @@ versionVariants: ### **`identityVerificationTxId`** **string** -**포트원에서 채번한 본인인증 트랜잭션 ID** +**본인인증 시도 고유 번호** -- 포트원에서 채번하는 본인인증 고유 번호입니다. +- 포트원에서 채번하는 본인인증 시도 고유 번호입니다. ### **`code`** **string** -**에러 코드** +**오류 코드** -- 에러가 있는 경우 에러 코드입니다. +- 실패한 경우 오류 코드입니다. ### **`message`** **string** **에러 메시지** -- 에러가 있는 경우 에러 메시지입니다. +- 실패한 경우 오류 메시지입니다. ### **`pgCode`** **string** -**PG 에러 코드** +**PG 오류 코드** -- PG에서 에러 코드를 내려 주는 경우 이 에러 코드를 그대로 반환합니다. +- PG에서 오류 코드를 내려 주는 경우 이 오류 코드를 그대로 반환합니다. ### **`pgMessage`** **string** -**PG 에러 메시지** +**PG 오류 메시지** -- PG에서 에러 메시지를 내려 주는 경우 이 에러 메시지를 그대로 반환합니다. +- PG에서 오류 메시지를 내려 주는 경우 이 오류 메시지를 그대로 반환합니다. diff --git a/src/routes/(root)/sdk/ko/v2-sdk/payment-response.mdx b/src/routes/(root)/sdk/ko/v2-sdk/payment-response.mdx index 1db330bb6..fb2ddd6d8 100644 --- a/src/routes/(root)/sdk/ko/v2-sdk/payment-response.mdx +++ b/src/routes/(root)/sdk/ko/v2-sdk/payment-response.mdx @@ -22,30 +22,30 @@ versionVariants: ### **`txId`** **string** -**포트원에서 채번한 결제 트랜잭션 ID** +**결제 시도 고유 번호** -- 포트원에서 채번하는 결제 고유 번호입니다. +- 포트원에서 채번하는 결제 시도 고유 번호입니다. ### **`code`** **string** -**에러 코드** +**오류 코드** -- 에러가 있는 경우 에러 코드입니다. +- 실패한 경우 오류 코드입니다. ### **`message`** **string** -**에러 메시지** +**오류 메시지** -- 에러가 있는 경우 에러 메시지입니다. +- 실패한 경우 오류 메시지입니다. ### **`pgCode`** **string** -**PG 에러 코드** +**PG 오류 코드** -- PG에서 에러 코드를 내려 주는 경우 이 에러 코드를 그대로 반환합니다. +- PG에서 오류 코드를 내려 주는 경우 이 오류 코드를 그대로 반환합니다. ### **`pgMessage`** **string** -**PG 에러 메시지** +**PG 오류 메시지** -- PG에서 에러 메시지를 내려 주는 경우 이 에러 메시지를 그대로 반환합니다. +- PG에서 오류 메시지를 내려 주는 경우 이 오류 메시지를 그대로 반환합니다.