From 2978d70d988a6cd08b8069fbb7d785f0e8f81108 Mon Sep 17 00:00:00 2001 From: Odin <116146713+LimJiGyu@users.noreply.github.com> Date: Mon, 25 Mar 2024 16:00:23 +0900 Subject: [PATCH] =?UTF-8?q?=EA=B2=B0=EC=A0=9C=EC=97=B0=EB=8F=99=20?= =?UTF-8?q?=EB=A6=AC=EB=89=B4=EC=96=BC=20-=20V2=20API=20Secret=20=EC=88=98?= =?UTF-8?q?=EB=8F=99=20=EB=B0=9C=EA=B8=89=20=EB=AC=B8=EC=9D=98=20=EB=B6=80?= =?UTF-8?q?=EB=B6=84=20=EC=A0=9C=EA=B1=B0=20(#375)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/docs/ko/ready/readme.mdx | 53 +- src/content/docs/ko/v2-payment/authpay.mdx | 82 +- .../ko/v2-payment/v2-sdk/payment-request.mdx | 1881 ++++++++--------- src/content/docs/ko/v2-payment/v2.mdx | 79 +- 4 files changed, 1062 insertions(+), 1033 deletions(-) diff --git a/src/content/docs/ko/ready/readme.mdx b/src/content/docs/ko/ready/readme.mdx index 98f1aecb3..fec4ed230 100644 --- a/src/content/docs/ko/ready/readme.mdx +++ b/src/content/docs/ko/ready/readme.mdx @@ -11,6 +11,7 @@ import VersionGate from "~/components/gitbook/VersionGate.astro"; import Hint from "~/components/Hint.astro"; import image07 from "./_assets/apiver_v1.png"; +import apiVerV2 from "./_assets/apiver_v2.png"; import image4 from "./_assets/apply1.png" import image01 from "./_assets/channel1.png"; import image02 from "./_assets/channel2.png"; @@ -42,6 +43,7 @@ import image12 from "./_assets/pg/tosspayments.png"; import image9 from "./_assets/pg/welcome.png"; import image10 from "./_assets/pg/welcome1.png"; import image2 from "./_assets/signup.png"; +import storeid from "./_assets/storeid.png"; import IntegrationPaypalV2 from './_components/integration-guide/paypal-v2.mdx'; import IntegrationTosspayments from './_components/integration-guide/tosspayments.mdx'; @@ -618,11 +620,58 @@ import IntegrationTosspayments from './_components/integration-guide/tosspayment **REST API Key, REST API Secret란?** - - API 호출 시 인증을 위해 필요한 값입니다. [인증 방식](https://developers.portone.io/api/rest-v2)을 참고해 주세요. + - V1 API 호출 시 사용되는 Access Token을 발급할 때 사용되는 값입니다. + - REST API Secret은 재발급이 가능하며, 재발급 즉시 기존의 Secret은 사용이 불가능합니다. - - API Secret은 **결제 거래 건을 컨트롤할 수 있는 민감 정보**로 고객사 서버에서만 사용되어야 하며, 브라우저 등 외부에 노출되어서는 안 됩니다. + REST API Key, REST API Secret **결제 거래 건을 컨트롤할 수 있는 민감 정보**로 외부로 유출되지 않도록 주의가 필요합니다. + + + + + ### 4-1. 스토어 아이디(Store ID) 복사하기 + + 포트원을 이용한 결제 연동 시 필요한 스토어 아이디(Store ID)를 복사할 수 있습니다. + +
+ + - 관리자 콘솔 화면에서 \[결제 연동] → \[연동 관리] 화면에서 스토어 아이디를 복사할 수 있습니다. + + + **스토어 아이디(Store ID)란?** + + - 포트원 가입 시 \[대표 상점]이 생성되며, 자동으로 생성되는 고유값 입니다. + - 추가로 하위 상점을 생성하는 경우 **상점마다 고유하게 부여**됩니다. + - 결제창 연동 시 사용되며, 결제 호출 시 `storeId` 파라미터에 해당 값을 넣어야 합니다. + - **기술 문의 시 해당 값을 공유**해 주시면 빠르게 문제 해결을 도와드릴 수 있습니다. + + + ### 4-2. V2 API Secret 발급하기 + + V2 API를 연동하기 위해서는 V2 API Secret을 별도로 발급한 후 사용이 가능합니다. + +
+ + - 관리자 콘솔 화면에서 \[결제연동] → \[연동 관리] → \[식별코드·API Keys] 메뉴에서 \[V2 API]를 선택합니다. + - `새로운 API Secret 발급`을 클릭합니다. + - Secret 목록에 표시될 `Secret 이름`을 입력하고 `만료 기한`을 선택한 후 `생성`을 클릭합니다. + - 생성된 Secret을 복사합니다. `API Secret을 확인했습니다`를 누른 후엔 Secret 값을 확인할 수 없으니 주의해 주세요. + + + API Secret 발급 직후에만 값을 확인할 수 있습니다. 페이지를 벗어나면 API Secret 확인이 불가하오니 복사한 후 임의의 장소에 저장하여 사용하세요. + 만약, API Secret 값을 잊어버리신 경우 새로 발급받아 사용해야 합니다. + + + + **API Secret이란?** + + - API 호출 시 사용되는 Access Token을 발급할 때 사용되는 값입니다. + - V2 API Secret을 발급받으신 후, 이를 이용해 [API Secret을 이용한 토큰 발급](/api/rest-v2/auth#post%20%2Flogin%2Fapi-secret) API를 호출하시면
**Access Token**을 발급받으실 수 있습니다. + + + + API Secret은 **결제 거래 건을 컨트롤할 수 있는 민감 정보**로 고객사 서버에서만 사용되어야 하며, 브라우저 등 외부에 노출되어서는 안 됩니다. diff --git a/src/content/docs/ko/v2-payment/authpay.mdx b/src/content/docs/ko/v2-payment/authpay.mdx index 4afc4a817..77ee3e341 100644 --- a/src/content/docs/ko/v2-payment/authpay.mdx +++ b/src/content/docs/ko/v2-payment/authpay.mdx @@ -4,11 +4,8 @@ description: PG 결제창을 이용하는 인증 결제를 연동합니다. --- import Details from "~/components/gitbook/Details.astro"; -import Hint from "~/components/Hint.astro"; -import Tabs from "~/components/gitbook/tabs/Tabs.astro"; -import Tab from "~/components/gitbook/tabs/Tab.astro"; - import Youtube from "~/components/gitbook/Youtube.astro"; +import Hint from "~/components/Hint.astro"; import SdkInstallation from "./_components/sdk-installation.mdx" @@ -16,10 +13,8 @@ import SdkInstallation from "./_components/sdk-installation.mdx"

영상으로 보기

- + + ## 1. 포트원 SDK 설치 @@ -50,7 +45,8 @@ const response = await PortOne.requestPayment({ }); ``` -**paymentId**는 결제 건을 구분하는 문자열로, 결제 요청 및 조회에 필요합니다. 같은 paymentId에 대해 여러 번의 결제 시도가 가능하나, 최종적으로 결제에 성공하는 것은 단 한 번만 가능합니다. (중복 결제 방지) +**paymentId**는 결제 건을 구분하는 문자열로, 결제 요청 및 조회에 필요합니다. 같은 paymentId에 대해 여러 번의 결제 시도가 가능하나, +최종적으로 결제에 성공하는 것은 단 한 번만 가능합니다. (중복 결제 방지) **orderName**은 주문 내용을 나타내는 문자열입니다. 특정한 형식이 있지는 않지만, 결제 처리에 필요하므로 필수적으로 전달해 주셔야 합니다. @@ -73,35 +69,34 @@ const response = await PortOne.requestPayment({ if (response.code != null) { // 오류 발생 - return alert(response.message); + alert(response.message); } // /payment/complete 엔드포인트를 구현해야 합니다. 다음 목차에서 설명합니다. -const notified = await fetch( - `${SERVER_BASE_URL}/payment/complete`, - { - method: "POST", - headers: { "Content-Type": "application/json" }, - // paymentId와 주문 정보를 서버에 전달합니다 - body: JSON.stringify({ - paymentId: paymentId, - // 주문 정보... - }), - } -); +const notified = await fetch(`${SERVER_BASE_URL}/payment/complete`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + // paymentId와 주문 정보를 서버에 전달합니다 + body: JSON.stringify({ + paymentId: paymentId, + // 주문 정보... + }), +}); ``` 결과값에 들어 있는 필드는 다음과 같습니다. -| 필드명 | 설명 | 비고 | -| --------- | ---------- | ------- | -| paymentId | 결제 건 ID | 공통 | -| code | 오류 코드 | 실패 시 | -| message | 오류 문구 | 실패 시 | +|필드명 |설명 |비고 | +|---------|----------|-------| +|paymentId|결제 건 ID|공통 | +|code |오류 코드 |실패 시| +|message |오류 문구 |실패 시| ### 3-1. redirect 방식의 경우 -모바일 환경에서의 결제는 대부분 redirect 방식으로 이루어집니다. redirect 방식에서는 브라우저가 결제창으로 리다이렉트되었다가, 결제창에서의 작업이 끝나면 지정한 `redirectUrl`로 다시 리다이렉트됩니다. 이 경우에는 함수 호출 결과를 이용할 수 없고, 결제 성공 여부 등은 [쿼리 문자열](https://en.wikipedia.org/wiki/Query_string)로 전달받게 됩니다. +모바일 환경에서의 결제는 대부분 redirect 방식으로 이루어집니다. redirect 방식에서는 브라우저가 결제창으로 리다이렉트되었다가, 결제창에서의 작업이 끝나면 +지정한 `redirectUrl`로 다시 리다이렉트됩니다. 이 경우에는 함수 호출 결과를 이용할 수 없고, +결제 성공 여부 등은 [쿼리 문자열](https://en.wikipedia.org/wiki/Query_string)로 전달받게 됩니다. ```javascript PortOne.requestPayment({ @@ -112,27 +107,31 @@ PortOne.requestPayment({ 쿼리 문자열로 전달되는 내용은 다음과 같습니다. -| 키 | 설명 | 비고 | -| ---------- | ---------- | ------- | -| payment_id | 결제 건 ID | 공통 | -| code | 오류 코드 | 실패 시 | -| message | 오류 문구 | 실패 시 | +|키 |설명 |비고 | +|-----------|----------|-------| +|payment\_id|결제 건 ID|공통 | +|code |오류 코드 |실패 시| +|message |오류 문구 |실패 시| -예를 들어 paymentId가 `payment-39ecfa97`, redirectUrl이 `https://example.com/payment-redirect`인 경우, 결제 성공 시에 `https://example.com/payment-redirect?payment_id=payment-39ecfa97`로 리다이렉트됩니다. +예를 들어 paymentId가 `payment-39ecfa97`, redirectUrl이 `https://example.com/payment-redirect`인 경우, +결제 성공 시에 `https://example.com/payment-redirect?payment_id=payment-39ecfa97`로 리다이렉트됩니다. ## 4. 결제 완료 처리 (서버) -paymentId를 서버에 전달하면, 서버는 포트원의 [결제 조회 API](/api/rest-v2/payment#get%20%2Fpayments%2F%7BpaymentId%7D)를 호출하여 해당 결제 건의 상태를 확인하고 결제 완료 처리를 하여야 합니다. +paymentId를 서버에 전달하면, 서버는 포트원의 [결제 조회 API](/api/rest-v2/payment#get%20%2Fpayments%2F%7BpaymentId%7D)를 +호출하여 해당 결제 건의 상태를 확인하고 결제 완료 처리를 하여야 합니다. -**결제 검증 필수** - -인증 결제의 흐름상 결제 금액 등 정보가 고객의 브라우저 측에서 처리되므로, 의도한 결제 내용이 맞는지 꼭 확인하여야 위변조를 막을 수 있습니다. + **결제 검증 필수** + 인증 결제의 흐름상 결제 금액 등 정보가 고객의 브라우저 측에서 처리되므로, 의도한 결제 내용이 맞는지 꼭 확인하여야 위변조를 막을 수 있습니다. 예시로, 위에서 사용했던 `/payment/complete` 엔드포인트를 다음과 같이 구현할 수 있습니다. +[PORTONE\_API\_SECRET](/docs/ko/ready/readme?v=v2#4-2-v2-api-secret-%EB%B0%9C%EA%B8%89%ED%95%98%EA%B8%B0) +은 V2 전용 시크릿으로, 포트원 콘솔 내 결제연동 탭에서 발급받을 수 있습니다. + ```javascript title="Express" app.use(bodyParser.json()); @@ -146,10 +145,11 @@ app.post("/payment/complete", async (req, res) => { const paymentResponse = await fetch( `https://api.portone.io/payments/${encodeURIComponent(paymentId)}`, { - headers: { "Authorization": `PortOne ${PORTONE_API_SECRET}` }, + headers: { Authorization: `PortOne ${PORTONE_API_SECRET}` }, }, ); - if (!paymentResponse.ok) throw new Error(`paymentResponse: ${paymentResponse.statusText}`); + if (!paymentResponse.ok) + throw new Error(`paymentResponse: ${paymentResponse.statusText}`); const payment = await paymentResponse.json(); // 2. 고객사 내부 주문 데이터의 가격과 실제 지불된 금액을 비교합니다. @@ -170,11 +170,9 @@ app.post("/payment/complete", async (req, res) => { } else { // 결제 금액이 불일치하여 위/변조 시도가 의심됩니다. } - } catch (e) { // 결제 검증에 실패했습니다. res.status(400).send(e); } }); - ``` diff --git a/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx b/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx index 3ffc16bca..770ec90ef 100644 --- a/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx +++ b/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx @@ -31,8 +31,7 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > - 1000 만큼 원화(KRW) 결제를 하는 경우, scale factor가 0이기 때문에 **1000 \* (10의 0승) = 1000**을 전달해야 합니다. > - 1.50 만큼 달러(USD) 결제를 하는 경우, scale factor가 2이기 때문에 **1.50 \* (10의 2승) = 150**을 전달해야 합니다. -> -> 이렇게 전달 된 값은 실제로 PG사에 결제를 요청할때 currency에 따라 올바른 값으로 변환되기 때문에 반드시 currency값을 필수로 입력해야 합니다. +> - 이렇게 전달 된 값은 실제로 PG사에 결제를 요청할때 currency에 따라 올바른 값으로 변환되기 때문에 반드시 currency값을 필수로 입력해야 합니다. ### **`currency`** **\*** **string** @@ -41,190 +40,188 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > - 원화 결제 시 `KRW`로 입력해주세요. > >
-> -> 결제 통화 확인하기 -> -> - `KRW` (한국 원화) -> - `USD` (미국 달러) -> - `EUR` (유로화) -> - `JPY` (일본 엔화) -> - `CNY` (중국 위안화) -> - `VND` (베트남 동) -> - `THB` (태국 바트) -> - `SGD` (싱가포르 달러) -> - `AUD` (오스트레일리아 달러) -> - `HKD` (홍콩 달러) -> - `AED` (UAE Dirham) -> - `AFN` (Afghani) -> - `ALL` (Lek) -> - `AMD` (Armenian Dram) -> - `ANG` (Netherlands Antillean Guilder) -> - `AOA` (Kwanza) -> - `ARS` (Argentine Peso) -> - `AWG` (Aruban Florin) -> - `AZN` (Azerbaijan Manat) -> - `BAM` (Convertible Mark) -> - `BBD` (Barbados Dollar) -> - `BDT` (Taka) -> - `BGN` (Bulgarian Lev) -> - `BHD` (Bahraini Dinar) -> - `BIF` (Burundi Franc) -> - `BMD` (Bermudian Dollar) -> - `BOB` (Boliviano) -> - `BOV` (Mvdol) -> - `BRL` (Brazilian Real) -> - `BSD` (Bahamian Dollar) -> - `BTN` (Ngultrum) -> - `BWP` (Pula) -> - `BYN` (Belarusian Ruble) -> - `BZD` (Belize Dollar) -> - `CAD` (Canadian Dollar) -> - `CDF` (Congolese Franc) -> - `CHE` (WIR Euro) -> - `CHF` (Swiss Franc) -> - `CHW` (WIR Franc) -> - `CLF` (Unidad de Fomento) -> - `CLP` (Chilean Peso) -> - `COP` (Chilean Peso) -> - `COP` (Colombian Peso) -> - `COU` (Unidad de Valor Real) -> - `CRC` (Costa Rican Colon) -> - `CUC` (Peso Convertible) -> - `CUP` (Cuban Peso) -> - `CVE` (Cabo Verde Escudo) -> - `CZK` (Czech Koruna) -> - `DJF` (Djibouti Franc) -> - `DKK` (Danish Krone) -> - `DOP` (Dominican Peso) -> - `DZD` (Algerian Dinar) -> - `EGP` (Egyptian Pound) -> - `ERN` (Nakfa) -> - `ETB` (Ethiopian Birr) -> - `FJD` (Fiji Dollar) -> - `FKP` (Falkland Islands Pound) -> - `GBP` (Pound Sterling) -> - `GEL` (Lari) -> - `GHS` (Ghana Cedi) -> - `GIP` (Gibraltar Pound) -> - `GMD` (Dalasi) -> - `GNF` (Guinean Franc) -> - `GTQ` (Quetzal) -> - `GYD` (Guyana Dollar) -> - `HNL` (Lempira) -> - `HRK` (Kuna) -> - `HTG` (Gourde) -> - `HUF` (Forint) -> - `IDR` (Rupiah) -> - `ILS` (New Israeli Sheqel) -> - `INR` (Indian Rupee) -> - `IQD` (Indian Rupee) -> - `IRR` (Iranian Rial) -> - `ISK` (Iceland Krona) -> - `JMD` (Jamaican Dollar) -> - `JOD` (Jordanian Dinar) -> - `KES` (Kenyan Shilling) -> - `KGS` (Som) -> - `KHR` (Riel) -> - `KMF` (Comorian Franc) -> - `KPW` (North Korean Won) -> - `KWD` (Kuwaiti Dinar) -> - `KYD` (Cayman Islands Dollar) -> - `KZT` (Tenge) -> - `LAK` (Lao Kip) -> - `LBP` (Lebanese Pound) -> - `LKR` (Sri Lanka Rupee) -> - `LRD` (Loti) -> - `LSL` (Libyan Dinar) -> - `LYD` (Moroccan Dirham) -> - `MAD` (Moldovan Leu) -> - `MDL` (Malagasy Ariary) -> - `MGA` (Denar) -> - `MKD` (Kyat) -> - `MMK` (Tugrik) -> - `MNT` (Pataca) -> - `MOP` (Ouguiya) -> - `MRU` (Mauritius Rupee) -> - `_MVR` (Rufiyaa) -> - `MWK` (Malawi Kwacha) -> - `MXN` (Mexican Peso) -> - `MXV` (Mexican Unidad de Inversion (UDI)) -> - `MYR` (Malaysian Ringgit) -> - `MZN` (Mozambique Metical) -> - `NAD` (Namibia Dollar) -> - `NGN` (Naira) -> - `NIO` (Cordoba Oro) -> - `NOK` (Norwegian Krone) -> - `NPR` (Nepalese Rupee) -> - `NZD` (New Zealand Dollar) -> - `OMR` (Rial Omani) -> - `PAB` (Balboa) -> - `PEN` (Sol) -> - `PGK` (Kina) -> - `PHP` (Philippine Peso) -> - `PKR` (Pakistan Rupee) -> - `PLN` (Zloty) -> - `PYG` (Guarani) -> - `QAR` (Qatari Rial) -> - `RON` (Romanian Leu) -> - `RSD` (Serbian Dinar) -> - `RUB` (Russian Ruble) -> - `RWF` (Rwanda Franc) -> - `SAR` (Saudi Riyal) -> - `SBD` (Solomon Islands Dollar) -> - `SCR` (Seychelles Rupee) -> - `SDG` (Sudanese Pound) -> - `SEK` (Swedish Krona) -> - `SHP` (Saint Helena Pound) -> - `SLE` (Leone) -> - `SLL` (Leone) -> - `SOS` (Somali Shilling) -> - `SRD` (Surinam Dollar) -> - `SSP` (South Sudanese Pound) -> - `STN` (Dobra) -> - `SVC` (El Salvador Colon) -> - `SYP` (Syrian Pound) -> - `SZL` (Lilangeni) -> - `TJS` (Somoni) -> - `TMT` (Turkmenistan New Manat) -> - `TND` (Tunisian Dinar) -> - `TOP` (Pa’anga) -> - `TRY` (Turkish Lira) -> - `TTD` (Trinidad and Tobago Dollar) -> - `TWD` (New Taiwan Dollar) -> - `TZS` (Tanzanian Shilling) -> - `UAH` (Hryvnia) -> - `UGX` (Uganda Shilling) -> - `USN` (US Dollar (Next day)) -> - `UYI` (Uruguay Peso en Unidades Indexadas (UI)) -> - `UYU` (Peso Uruguayo) -> - `UYW` (Unidad Previsional) -> - `UZS` (Uzbekistan Sum) -> - `VED` (Bolívar Soberano) -> - `VES` (Bolívar Soberano) -> - `VUV` (Vatu) -> - `WST` (Tala) -> - `XAF` (CFA Franc BEAC) -> - `XAG` (Silver) -> - `XAU` (Gold) -> - `XBA` (Bond Markets Unit European Composite Unit (EURCO)) -> - `XBB` (Bond Markets Unit European Monetary Unit (E.M.U.-6)) -> - `XBC` (Bond Markets Unit European Unit of Account 9 (E.U.A.-9)) -> - `XBD` (Bond Markets Unit European Unit of Account 17 (E.U.A.-17)) -> - `XCD` (East Caribbean Dollar) -> - `XDR` (SDR (Special Drawing Right)) -> - `XOF` (CFA Franc BCEAO) -> - `XPD` (Palladium) -> - `XPF` (CFP Franc) -> - `XPT` (Platinum) -> - `XSU` (Sucre) -> - `XTS` (Codes specifically reserved for testing purposes) -> - `XUA` (ADB Unit of Account) -> - `XXX` (The codes assigned for transactions where no currency is involved) -> - `YER` (Yemeni Rial) -> - `ZAR` (Rand) -> - `ZMW` (Zambian Kwacha) -> - `ZWL` (Zimbabwe Dollar) -> +> 결제 통화 확인하기 +> +> - `KRW` (한국 원화) +> - `USD` (미국 달러) +> - `EUR` (유로화) +> - `JPY` (일본 엔화) +> - `CNY` (중국 위안화) +> - `VND` (베트남 동) +> - `THB` (태국 바트) +> - `SGD` (싱가포르 달러) +> - `AUD` (오스트레일리아 달러) +> - `HKD` (홍콩 달러) +> - `AED` (UAE Dirham) +> - `AFN` (Afghani) +> - `ALL` (Lek) +> - `AMD` (Armenian Dram) +> - `ANG` (Netherlands Antillean Guilder) +> - `AOA` (Kwanza) +> - `ARS` (Argentine Peso) +> - `AWG` (Aruban Florin) +> - `AZN` (Azerbaijan Manat) +> - `BAM` (Convertible Mark) +> - `BBD` (Barbados Dollar) +> - `BDT` (Taka) +> - `BGN` (Bulgarian Lev) +> - `BHD` (Bahraini Dinar) +> - `BIF` (Burundi Franc) +> - `BMD` (Bermudian Dollar) +> - `BOB` (Boliviano) +> - `BOV` (Mvdol) +> - `BRL` (Brazilian Real) +> - `BSD` (Bahamian Dollar) +> - `BTN` (Ngultrum) +> - `BWP` (Pula) +> - `BYN` (Belarusian Ruble) +> - `BZD` (Belize Dollar) +> - `CAD` (Canadian Dollar) +> - `CDF` (Congolese Franc) +> - `CHE` (WIR Euro) +> - `CHF` (Swiss Franc) +> - `CHW` (WIR Franc) +> - `CLF` (Unidad de Fomento) +> - `CLP` (Chilean Peso) +> - `COP` (Chilean Peso) +> - `COP` (Colombian Peso) +> - `COU` (Unidad de Valor Real) +> - `CRC` (Costa Rican Colon) +> - `CUC` (Peso Convertible) +> - `CUP` (Cuban Peso) +> - `CVE` (Cabo Verde Escudo) +> - `CZK` (Czech Koruna) +> - `DJF` (Djibouti Franc) +> - `DKK` (Danish Krone) +> - `DOP` (Dominican Peso) +> - `DZD` (Algerian Dinar) +> - `EGP` (Egyptian Pound) +> - `ERN` (Nakfa) +> - `ETB` (Ethiopian Birr) +> - `FJD` (Fiji Dollar) +> - `FKP` (Falkland Islands Pound) +> - `GBP` (Pound Sterling) +> - `GEL` (Lari) +> - `GHS` (Ghana Cedi) +> - `GIP` (Gibraltar Pound) +> - `GMD` (Dalasi) +> - `GNF` (Guinean Franc) +> - `GTQ` (Quetzal) +> - `GYD` (Guyana Dollar) +> - `HNL` (Lempira) +> - `HRK` (Kuna) +> - `HTG` (Gourde) +> - `HUF` (Forint) +> - `IDR` (Rupiah) +> - `ILS` (New Israeli Sheqel) +> - `INR` (Indian Rupee) +> - `IQD` (Indian Rupee) +> - `IRR` (Iranian Rial) +> - `ISK` (Iceland Krona) +> - `JMD` (Jamaican Dollar) +> - `JOD` (Jordanian Dinar) +> - `KES` (Kenyan Shilling) +> - `KGS` (Som) +> - `KHR` (Riel) +> - `KMF` (Comorian Franc) +> - `KPW` (North Korean Won) +> - `KWD` (Kuwaiti Dinar) +> - `KYD` (Cayman Islands Dollar) +> - `KZT` (Tenge) +> - `LAK` (Lao Kip) +> - `LBP` (Lebanese Pound) +> - `LKR` (Sri Lanka Rupee) +> - `LRD` (Loti) +> - `LSL` (Libyan Dinar) +> - `LYD` (Moroccan Dirham) +> - `MAD` (Moldovan Leu) +> - `MDL` (Malagasy Ariary) +> - `MGA` (Denar) +> - `MKD` (Kyat) +> - `MMK` (Tugrik) +> - `MNT` (Pataca) +> - `MOP` (Ouguiya) +> - `MRU` (Mauritius Rupee) +> - `_MVR` (Rufiyaa) +> - `MWK` (Malawi Kwacha) +> - `MXN` (Mexican Peso) +> - `MXV` (Mexican Unidad de Inversion (UDI)) +> - `MYR` (Malaysian Ringgit) +> - `MZN` (Mozambique Metical) +> - `NAD` (Namibia Dollar) +> - `NGN` (Naira) +> - `NIO` (Cordoba Oro) +> - `NOK` (Norwegian Krone) +> - `NPR` (Nepalese Rupee) +> - `NZD` (New Zealand Dollar) +> - `OMR` (Rial Omani) +> - `PAB` (Balboa) +> - `PEN` (Sol) +> - `PGK` (Kina) +> - `PHP` (Philippine Peso) +> - `PKR` (Pakistan Rupee) +> - `PLN` (Zloty) +> - `PYG` (Guarani) +> - `QAR` (Qatari Rial) +> - `RON` (Romanian Leu) +> - `RSD` (Serbian Dinar) +> - `RUB` (Russian Ruble) +> - `RWF` (Rwanda Franc) +> - `SAR` (Saudi Riyal) +> - `SBD` (Solomon Islands Dollar) +> - `SCR` (Seychelles Rupee) +> - `SDG` (Sudanese Pound) +> - `SEK` (Swedish Krona) +> - `SHP` (Saint Helena Pound) +> - `SLE` (Leone) +> - `SLL` (Leone) +> - `SOS` (Somali Shilling) +> - `SRD` (Surinam Dollar) +> - `SSP` (South Sudanese Pound) +> - `STN` (Dobra) +> - `SVC` (El Salvador Colon) +> - `SYP` (Syrian Pound) +> - `SZL` (Lilangeni) +> - `TJS` (Somoni) +> - `TMT` (Turkmenistan New Manat) +> - `TND` (Tunisian Dinar) +> - `TOP` (Pa’anga) +> - `TRY` (Turkish Lira) +> - `TTD` (Trinidad and Tobago Dollar) +> - `TWD` (New Taiwan Dollar) +> - `TZS` (Tanzanian Shilling) +> - `UAH` (Hryvnia) +> - `UGX` (Uganda Shilling) +> - `USN` (US Dollar (Next day)) +> - `UYI` (Uruguay Peso en Unidades Indexadas (UI)) +> - `UYU` (Peso Uruguayo) +> - `UYW` (Unidad Previsional) +> - `UZS` (Uzbekistan Sum) +> - `VED` (Bolívar Soberano) +> - `VES` (Bolívar Soberano) +> - `VUV` (Vatu) +> - `WST` (Tala) +> - `XAF` (CFA Franc BEAC) +> - `XAG` (Silver) +> - `XAU` (Gold) +> - `XBA` (Bond Markets Unit European Composite Unit (EURCO)) +> - `XBB` (Bond Markets Unit European Monetary Unit (E.M.U.-6)) +> - `XBC` (Bond Markets Unit European Unit of Account 9 (E.U.A.-9)) +> - `XBD` (Bond Markets Unit European Unit of Account 17 (E.U.A.-17)) +> - `XCD` (East Caribbean Dollar) +> - `XDR` (SDR (Special Drawing Right)) +> - `XOF` (CFA Franc BCEAO) +> - `XPD` (Palladium) +> - `XPF` (CFP Franc) +> - `XPT` (Platinum) +> - `XSU` (Sucre) +> - `XTS` (Codes specifically reserved for testing purposes) +> - `XUA` (ADB Unit of Account) +> - `XXX` (The codes assigned for transactions where no currency is involved) +> - `YER` (Yemeni Rial) +> - `ZAR` (Rand) +> - `ZMW` (Zambian Kwacha) +> - `ZWL` (Zimbabwe Dollar) >
### **`payMethod`** **\*** **string** @@ -236,16 +233,14 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > **각 PG사별 결제 연동 가이드**를 참고하세요 > >
-> -> 결제수단 구분코드 확인하기 -> -> - `CARD` (카드) -> - `VIRTUAL_ACCOUNT` (가상계좌) -> - `TRANSFER` (계좌이체) -> - `MOBILE` (휴대폰 소액결제) -> - `GIFT_CERTIFICATE` (상품권) -> - `EASY_PAY` (간편결제) -> +> 결제수단 구분코드 확인하기 +> +> - `CARD` (카드) +> - `VIRTUAL_ACCOUNT` (가상계좌) +> - `TRANSFER` (계좌이체) +> - `MOBILE` (휴대폰 소액결제) +> - `GIFT_CERTIFICATE` (상품권) +> - `EASY_PAY` (간편결제) >
### **`channelKey`** **string** @@ -265,15 +260,13 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > 가능한 PG사 코드는 아래를 참고해주세요. > >
+> PG사 코드 > -> PG사 코드 -> -> - `TOSSPAYMENTS` -> - `SMARTRO` -> - `NAVERPAY` -> - `KAKAOPAY` -> - `KSNET` -> +> - `TOSSPAYMENTS` +> - `SMARTRO` +> - `NAVERPAY` +> - `KAKAOPAY` +> - `KSNET` >
### **`isTestChannel`** **boolean** @@ -290,8 +283,7 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > - 결제 금액 중 면세금액에 해당하는 금액을 입력합니다. > - 미입력 시 0으로 취급됩니다. -> -> 결제 금액과 동일하게 통화별 scale factor가 적용된 금액으로 전달해주세요. +> - 결제 금액과 동일하게 통화별 scale factor가 적용된 금액으로 전달해주세요. ### **`customer`** **\*** **object** @@ -339,259 +331,257 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > > **국가** > > > > > >
-> > > -> > > 국가 코드 확인하기 -> > > -> > > - AF(Afghanistan) -> > > - AX(Åland Islands) -> > > - AL(Albania) -> > > - DZ(Algeria) -> > > - AS(American Samoa) -> > > - AD(Andorra) -> > > - AO(Angola) -> > > - AI(Anguilla) -> > > - AQ(Antarctica) -> > > - AG(Antigua and Barbuda) -> > > - AR(Argentina) -> > > - AM(Armenia) -> > > - AW(Aruba) -> > > - AU(Australia) -> > > - AT(Austria) -> > > - AZ(Azerbaijan) -> > > - BH(Bahrain) -> > > - BS(Bahamas) -> > > - BD(Bangladesh) -> > > - BB(Barbados) -> > > - BY(Belarus) -> > > - BE(Belgium) -> > > - BZ(Belize) -> > > - BJ(Benin) -> > > - BM(Bermuda) -> > > - BT(Bhutan) -> > > - BO(Bolivia, Plurinational State of) -> > > - BQ(Bonaire, Sint Eustatius and Saba) -> > > - BA(Bosnia and Herzegovina) -> > > - BW(Botswana) -> > > - BV(Bouvet Island) -> > > - BR(Brazil) -> > > - IO(British Indian Ocean Territory) -> > > - BN(Brunei Darussalam) -> > > - BG(Bulgaria) -> > > - BF(Burkina Faso) -> > > - BI(Burundi) -> > > - KH(Cambodia) -> > > - CM(Cameroon) -> > > - CA(Canada) -> > > - CV(Cape Verde) -> > > - KY(Cayman Islands) -> > > - CF(Central African Republic) -> > > - TD(Chad) -> > > - CL(Chile) -> > > - CN(China) -> > > - CX(Christmas Island) -> > > - CC(Cocos (Keeling) Islands) -> > > - CO(Colombia) -> > > - KM(Comoros) -> > > - CG(Congo) -> > > - CD(Congo, the Democratic Republic of the) -> > > - CK(Cook Islands) -> > > - CR(Costa Rica) -> > > - CI(Côte d'Ivoire) -> > > - HR(Croatia) -> > > - CU(Cuba) -> > > - CW(Curaçao) -> > > - CY(Cyprus) -> > > - CZ(Czech Republic) -> > > - DK(Denmark) -> > > - DJ(Djibouti) -> > > - DM(Dominica) -> > > - DO(Dominican Republic) -> > > - EC(Ecuador) -> > > - EG(Egypt) -> > > - SV(El Salvador) -> > > - GQ(Equatorial Guinea) -> > > - ER(Eritrea) -> > > - EE(Estonia) -> > > - ET(Ethiopia) -> > > - FK(Falkland Islands (Malvinas)) -> > > - FO(Faroe Islands) -> > > - FJ(Fiji) -> > > - FI(Finland) -> > > - FR(France) -> > > - GF(French Guiana) -> > > - PF(French Polynesia) -> > > - TF(French Southern Territories) -> > > - GA(Gabon) -> > > - GM(Gambia) -> > > - GE(Georgia) -> > > - DE(Germany) -> > > - GH(Ghana) -> > > - GI(Gibraltar) -> > > - GR(Greece) -> > > - GL(Greenland) -> > > - GD(Grenada) -> > > - GP(Guadeloupe) -> > > - GU(Guam) -> > > - GT(Guatemala) -> > > - GG(Guernsey) -> > > - GN(Guinea) -> > > - GW(Guinea-Bissau) -> > > - GY(Guyana) -> > > - HT(Haiti) -> > > - HM(Heard Island and McDonald Islands) -> > > - VA(Holy See (Vatican City State)) -> > > - HN(Honduras) -> > > - HK(Hong Kong) -> > > - HU(Hungary) -> > > - IS(Iceland) -> > > - IN(India) -> > > - ID(Indonesia) -> > > - IR(Iran, Islamic Republic of) -> > > - IQ(Iraq) -> > > - IE(Ireland) -> > > - IM(Isle of Man) -> > > - IL(Israel) -> > > - IT(Italy) -> > > - JM(Jamaica) -> > > - JP(Japan) -> > > - JE(Jersey) -> > > - JO(Jordan) -> > > - KZ(Kazakhstan) -> > > - KE(Kenya) -> > > - KI(Kiribati) -> > > - KP(Korea, Democratic People's Republic of) -> > > - KR(Korea, Republic of) -> > > - KW(Kuwait) -> > > - KG(Kyrgyzstan) -> > > - LA(Lao People's Democratic Republic) -> > > - LV(Latvia) -> > > - LB(Lebanon) -> > > - LS(Lesotho) -> > > - LR(Liberia) -> > > - LY(Libya) -> > > - LI(Liechtenstein) -> > > - LT(Lithuania) -> > > - LU(Luxembourg) -> > > - MO(Macao) -> > > - MK(Macedonia, the Former Yugoslav Republic of) -> > > - MG(Madagascar) -> > > - MW(Malawi) -> > > - MY(Malaysia) -> > > - MV(Maldives) -> > > - ML(Mali) -> > > - MT(Malta) -> > > - MH(Marshall Islands) -> > > - MQ(Martinique) -> > > - MR(Mauritania) -> > > - MU(Mauritius) -> > > - YT(Mayotte) -> > > - MX(Mexico) -> > > - FM(Micronesia, Federated States of) -> > > - MD(Moldova, Republic of) -> > > - MC(Monaco) -> > > - MN(Mongolia) -> > > - ME(Montenegro) -> > > - MS(Montserrat) -> > > - MA(Morocco) -> > > - MZ(Mozambique) -> > > - MM(Myanmar) -> > > - NA(Namibia) -> > > - NR(Nauru) -> > > - NP(Nepal) -> > > - NL(Netherlands) -> > > - NC(New Caledonia) -> > > - NZ(New Zealand) -> > > - NI(Nicaragua) -> > > - NE(Niger) -> > > - NG(Nigeria) -> > > - NU(Niue) -> > > - NF(Norfolk Island) -> > > - MP(Northern Mariana Islands) -> > > - NO(Norway) -> > > - OM(Oman) -> > > - PK(Pakistan) -> > > - PW(Palau) -> > > - PS(Palestine, State of) -> > > - OA(Panama) -> > > - PG(Papua New Guinea) -> > > - PY(Paraguay) -> > > - PE(Peru) -> > > - PH(Philippines) -> > > - PN(Pitcairn) -> > > - PL(Poland) -> > > - PT(Portugal) -> > > - PR(Puerto Rico) -> > > - QA(Qatar) -> > > - RE(Réunion) -> > > - RO(Romania) -> > > - RU(Russian Federation) -> > > - RW(Rwanda) -> > > - BL(Saint Barthélemy) -> > > - SH(Saint Helena, Ascension and Tristan da Cunha) -> > > - KN(Saint Kitts and Nevis) -> > > - LC(Saint Lucia) -> > > - MF(Saint Martin (French part)) -> > > - PM(Saint Pierre and Miquelon) -> > > - VC(Saint Vincent and the Grenadines) -> > > - WS(Samoa) -> > > - SM(San Marino) -> > > - ST(Sao Tome and Principe) -> > > - SA(Saudi Arabia) -> > > - SN(Senegal) -> > > - RS(Serbia) -> > > - SC(Seychelles) -> > > - SL(Sierra Leone) -> > > - SG(Singapore) -> > > - SX(Sint Maarten (Dutch part)) -> > > - SK(Slovakia) -> > > - SI(Slovenia) -> > > - SB(Solomon Islands) -> > > - SO(Somalia) -> > > - ZA(South Africa) -> > > - GS(South Georgia and the South Sandwich Islands) -> > > - SS(South Sudan) -> > > - ES(Spain) -> > > - LK(Sri Lanka) -> > > - SD(Sudan) -> > > - SR(Suriname) -> > > - SJ(Svalbard and Jan Mayen) -> > > - SZ(Swaziland) -> > > - SE(Sweden) -> > > - CH(Switzerland) -> > > - SY(Syrian Arab Republic) -> > > - TW(Taiwan, Province of China) -> > > - TJ(Tajikistan) -> > > - TZ(Tanzania, United Republic of) -> > > - TH(Thailand) -> > > - TL(Timor-Leste) -> > > - TG(Togo) -> > > - TK(Tokelau) -> > > - TO(Tonga) -> > > - TT(Trinidad and Tobago) -> > > - TN(Tunisia) -> > > - TR(Turkey) -> > > - TM(Turkmenistan) -> > > - TC(Turks and Caicos Islands) -> > > - TV(Tuvalu) -> > > - UG(Uganda) -> > > - UA(Ukraine) -> > > - AE(United Arab Emirates) -> > > - GB(United Kingdom) -> > > - US(United States) -> > > - UM(United States Minor Outlying Islands) -> > > - UY(Uruguay) -> > > - UZ(Uzbekistan) -> > > - VU(Vanuatu) -> > > - VE(Venezuela, Bolivarian Republic of) -> > > - VN(Viet Nam) -> > > - VG(Virgin Islands, British) -> > > - VI(Virgin Islands, U.S.) -> > > - WF(Wallis and Futuna) -> > > - EH(Western Sahara) -> > > - YE(Yemen) -> > > - ZM(Zambia) -> > > - ZW(Zimbabwe) -> > > +> > > 국가 코드 확인하기 +> > > +> > > - AF(Afghanistan) +> > > - AX(Åland Islands) +> > > - AL(Albania) +> > > - DZ(Algeria) +> > > - AS(American Samoa) +> > > - AD(Andorra) +> > > - AO(Angola) +> > > - AI(Anguilla) +> > > - AQ(Antarctica) +> > > - AG(Antigua and Barbuda) +> > > - AR(Argentina) +> > > - AM(Armenia) +> > > - AW(Aruba) +> > > - AU(Australia) +> > > - AT(Austria) +> > > - AZ(Azerbaijan) +> > > - BH(Bahrain) +> > > - BS(Bahamas) +> > > - BD(Bangladesh) +> > > - BB(Barbados) +> > > - BY(Belarus) +> > > - BE(Belgium) +> > > - BZ(Belize) +> > > - BJ(Benin) +> > > - BM(Bermuda) +> > > - BT(Bhutan) +> > > - BO(Bolivia, Plurinational State of) +> > > - BQ(Bonaire, Sint Eustatius and Saba) +> > > - BA(Bosnia and Herzegovina) +> > > - BW(Botswana) +> > > - BV(Bouvet Island) +> > > - BR(Brazil) +> > > - IO(British Indian Ocean Territory) +> > > - BN(Brunei Darussalam) +> > > - BG(Bulgaria) +> > > - BF(Burkina Faso) +> > > - BI(Burundi) +> > > - KH(Cambodia) +> > > - CM(Cameroon) +> > > - CA(Canada) +> > > - CV(Cape Verde) +> > > - KY(Cayman Islands) +> > > - CF(Central African Republic) +> > > - TD(Chad) +> > > - CL(Chile) +> > > - CN(China) +> > > - CX(Christmas Island) +> > > - CC(Cocos (Keeling) Islands) +> > > - CO(Colombia) +> > > - KM(Comoros) +> > > - CG(Congo) +> > > - CD(Congo, the Democratic Republic of the) +> > > - CK(Cook Islands) +> > > - CR(Costa Rica) +> > > - CI(Côte d'Ivoire) +> > > - HR(Croatia) +> > > - CU(Cuba) +> > > - CW(Curaçao) +> > > - CY(Cyprus) +> > > - CZ(Czech Republic) +> > > - DK(Denmark) +> > > - DJ(Djibouti) +> > > - DM(Dominica) +> > > - DO(Dominican Republic) +> > > - EC(Ecuador) +> > > - EG(Egypt) +> > > - SV(El Salvador) +> > > - GQ(Equatorial Guinea) +> > > - ER(Eritrea) +> > > - EE(Estonia) +> > > - ET(Ethiopia) +> > > - FK(Falkland Islands (Malvinas)) +> > > - FO(Faroe Islands) +> > > - FJ(Fiji) +> > > - FI(Finland) +> > > - FR(France) +> > > - GF(French Guiana) +> > > - PF(French Polynesia) +> > > - TF(French Southern Territories) +> > > - GA(Gabon) +> > > - GM(Gambia) +> > > - GE(Georgia) +> > > - DE(Germany) +> > > - GH(Ghana) +> > > - GI(Gibraltar) +> > > - GR(Greece) +> > > - GL(Greenland) +> > > - GD(Grenada) +> > > - GP(Guadeloupe) +> > > - GU(Guam) +> > > - GT(Guatemala) +> > > - GG(Guernsey) +> > > - GN(Guinea) +> > > - GW(Guinea-Bissau) +> > > - GY(Guyana) +> > > - HT(Haiti) +> > > - HM(Heard Island and McDonald Islands) +> > > - VA(Holy See (Vatican City State)) +> > > - HN(Honduras) +> > > - HK(Hong Kong) +> > > - HU(Hungary) +> > > - IS(Iceland) +> > > - IN(India) +> > > - ID(Indonesia) +> > > - IR(Iran, Islamic Republic of) +> > > - IQ(Iraq) +> > > - IE(Ireland) +> > > - IM(Isle of Man) +> > > - IL(Israel) +> > > - IT(Italy) +> > > - JM(Jamaica) +> > > - JP(Japan) +> > > - JE(Jersey) +> > > - JO(Jordan) +> > > - KZ(Kazakhstan) +> > > - KE(Kenya) +> > > - KI(Kiribati) +> > > - KP(Korea, Democratic People's Republic of) +> > > - KR(Korea, Republic of) +> > > - KW(Kuwait) +> > > - KG(Kyrgyzstan) +> > > - LA(Lao People's Democratic Republic) +> > > - LV(Latvia) +> > > - LB(Lebanon) +> > > - LS(Lesotho) +> > > - LR(Liberia) +> > > - LY(Libya) +> > > - LI(Liechtenstein) +> > > - LT(Lithuania) +> > > - LU(Luxembourg) +> > > - MO(Macao) +> > > - MK(Macedonia, the Former Yugoslav Republic of) +> > > - MG(Madagascar) +> > > - MW(Malawi) +> > > - MY(Malaysia) +> > > - MV(Maldives) +> > > - ML(Mali) +> > > - MT(Malta) +> > > - MH(Marshall Islands) +> > > - MQ(Martinique) +> > > - MR(Mauritania) +> > > - MU(Mauritius) +> > > - YT(Mayotte) +> > > - MX(Mexico) +> > > - FM(Micronesia, Federated States of) +> > > - MD(Moldova, Republic of) +> > > - MC(Monaco) +> > > - MN(Mongolia) +> > > - ME(Montenegro) +> > > - MS(Montserrat) +> > > - MA(Morocco) +> > > - MZ(Mozambique) +> > > - MM(Myanmar) +> > > - NA(Namibia) +> > > - NR(Nauru) +> > > - NP(Nepal) +> > > - NL(Netherlands) +> > > - NC(New Caledonia) +> > > - NZ(New Zealand) +> > > - NI(Nicaragua) +> > > - NE(Niger) +> > > - NG(Nigeria) +> > > - NU(Niue) +> > > - NF(Norfolk Island) +> > > - MP(Northern Mariana Islands) +> > > - NO(Norway) +> > > - OM(Oman) +> > > - PK(Pakistan) +> > > - PW(Palau) +> > > - PS(Palestine, State of) +> > > - OA(Panama) +> > > - PG(Papua New Guinea) +> > > - PY(Paraguay) +> > > - PE(Peru) +> > > - PH(Philippines) +> > > - PN(Pitcairn) +> > > - PL(Poland) +> > > - PT(Portugal) +> > > - PR(Puerto Rico) +> > > - QA(Qatar) +> > > - RE(Réunion) +> > > - RO(Romania) +> > > - RU(Russian Federation) +> > > - RW(Rwanda) +> > > - BL(Saint Barthélemy) +> > > - SH(Saint Helena, Ascension and Tristan da Cunha) +> > > - KN(Saint Kitts and Nevis) +> > > - LC(Saint Lucia) +> > > - MF(Saint Martin (French part)) +> > > - PM(Saint Pierre and Miquelon) +> > > - VC(Saint Vincent and the Grenadines) +> > > - WS(Samoa) +> > > - SM(San Marino) +> > > - ST(Sao Tome and Principe) +> > > - SA(Saudi Arabia) +> > > - SN(Senegal) +> > > - RS(Serbia) +> > > - SC(Seychelles) +> > > - SL(Sierra Leone) +> > > - SG(Singapore) +> > > - SX(Sint Maarten (Dutch part)) +> > > - SK(Slovakia) +> > > - SI(Slovenia) +> > > - SB(Solomon Islands) +> > > - SO(Somalia) +> > > - ZA(South Africa) +> > > - GS(South Georgia and the South Sandwich Islands) +> > > - SS(South Sudan) +> > > - ES(Spain) +> > > - LK(Sri Lanka) +> > > - SD(Sudan) +> > > - SR(Suriname) +> > > - SJ(Svalbard and Jan Mayen) +> > > - SZ(Swaziland) +> > > - SE(Sweden) +> > > - CH(Switzerland) +> > > - SY(Syrian Arab Republic) +> > > - TW(Taiwan, Province of China) +> > > - TJ(Tajikistan) +> > > - TZ(Tanzania, United Republic of) +> > > - TH(Thailand) +> > > - TL(Timor-Leste) +> > > - TG(Togo) +> > > - TK(Tokelau) +> > > - TO(Tonga) +> > > - TT(Trinidad and Tobago) +> > > - TN(Tunisia) +> > > - TR(Turkey) +> > > - TM(Turkmenistan) +> > > - TC(Turks and Caicos Islands) +> > > - TV(Tuvalu) +> > > - UG(Uganda) +> > > - UA(Ukraine) +> > > - AE(United Arab Emirates) +> > > - GB(United Kingdom) +> > > - US(United States) +> > > - UM(United States Minor Outlying Islands) +> > > - UY(Uruguay) +> > > - UZ(Uzbekistan) +> > > - VU(Vanuatu) +> > > - VE(Venezuela, Bolivarian Republic of) +> > > - VN(Viet Nam) +> > > - VG(Virgin Islands, British) +> > > - VI(Virgin Islands, U.S.) +> > > - WF(Wallis and Futuna) +> > > - EH(Western Sahara) +> > > - YE(Yemen) +> > > - ZM(Zambia) +> > > - ZW(Zimbabwe) > > >
> > > > > > **`addressLine1`** **\*** **string** @@ -645,7 +635,7 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > - PG사에 따라 가능한 결제창이 다릅니다. > - 전달되지 않았을 때 결정되는 기본 결제창이 다릅니다. > - 미입력 시, 해당 PG사의 기본 결제창 방식을 따릅니다. -> + > > **`pc`** **string** > > > > **PC에서의 결제창 유형** `IFRAME`, `REDIRECTION`, `POPUP` 중 하나를 입력해주세요. @@ -677,9 +667,9 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > 유효한 URL 형식의 문자열을 입력해주세요. > -> [**confirm_process**](../../tip/confirm-process) **사용 시 고객사 endpoint url 설정** +> [**confirm\_process**](../../tip/confirm-process) **사용 시 고객사 endpoint url 설정** > -> - 기술지원 메일로 별도 요청이 필요합니다. (support@portone.io) +> - 기술지원 메일로 별도 요청이 필요합니다. ([support@portone.io](mailto:support@portone.io)) ### **`appScheme`** **string** @@ -718,12 +708,12 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > > > **상품 단위 가격** > -> >결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다. +> > 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다. > -> >- 1000 만큼 원화(KRW) 결제를 하는 경우, scale factor가 0이기 때문에 **1000 \* (10의 0승) = 1000**을 전달해야 합니다. -> >- 1.50 만큼 달러(USD) 결제를 하는 경우, scale factor가 2이기 때문에 **1.50 \* (10의 2승) = 150**을 전달해야 합니다. +> > - 1000 만큼 원화(KRW) 결제를 하는 경우, scale factor가 0이기 때문에 **1000 \* (10의 0승) = 1000**을 전달해야 합니다. +> > - 1.50 만큼 달러(USD) 결제를 하는 경우, scale factor가 2이기 때문에 **1.50 \* (10의 2승) = 150**을 전달해야 합니다. > -> >이렇게 전달 된 값은 실제로 PG사에 결제를 요청할때 currency에 따라 올바른 값으로 변환되기 때문에 반드시 currency값을 필수로 입력해야 합니다. +> > 이렇게 전달 된 값은 실제로 PG사에 결제를 요청할때 currency에 따라 올바른 값으로 변환되기 때문에 반드시 currency값을 필수로 입력해야 합니다. > > > **`quantity`** **\*** **number** > > @@ -744,12 +734,10 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > **결제창 언어** (지원되지 않은 일부 PG사 존재) > >
+> 상세코드 확인하기 > -> 상세코드 확인하기 -> -> - KO_KR (한국어) -> - EN_US (영어) -> +> - KO\_KR (한국어) +> - EN\_US (영어) >
### **`customData`** **object** @@ -766,7 +754,7 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > > > > **`discountCode`** **string** > > > -> > > 토스페이먼츠 \<-\> 고객사 계약에 따라 프로모션 적용이 가능한 코드 +> > > 토스페이먼츠 \<-> 고객사 계약에 따라 프로모션 적용이 가능한 코드 > > > > > > **`useInternationalCardOnly`** **boolean** > > > @@ -808,7 +796,7 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > > > > > 이용완료일 (YYYYMMDD) > > > -> > > **`productItems`** **object[]** +> > > **`productItems`** **object\[]** > > > > > > 상품 정보 > > > @@ -833,10 +821,11 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > > > 결제 상품 유입경로 > > > > > > > >
-> > > > 상세 코드 확인하기 * `"NAVER_BOOK"` * -> > > > `"NAVER_MUSIC"` * `"NAVER_SHOPPING"` * `"NAVER_MAP"` * `"NAVER_PLACE"` -> > > > - `"SEARCH_AD"` * `"NAVER_SEARCH"` * `"BRAND_SEARCH"` * -> > > > `"PARTNER_DIRECT"` * `"ETC"` +> > > > 상세 코드 확인하기 \* `"NAVER_BOOK"` \* +> > > > `"NAVER_MUSIC"` \* `"NAVER_SHOPPING"` \* `"NAVER_MAP"` \* `"NAVER_PLACE"` +> > > > +> > > > - `"SEARCH_AD"` \* `"NAVER_SEARCH"` \* `"BRAND_SEARCH"` \* +> > > > `"PARTNER_DIRECT"` \* `"ETC"` > > > >
> > > > > > > > **`startDate`** **string** @@ -899,11 +888,11 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > > > > > 형식) 카드코드:노출유형|카드코드:노출유형 > > > -> > > - 노출 유형: 1(안심클릭), 2(간편결제), 3(앱 카드 직접 호출) -> > > - 카드 코드: 02(국민), 04(삼성), 06(신한), 07(현대), 08(롯데), 12(NH), 15(우리)만 가능 -> > > > > > 예시) 08:3|02:3 → 롯데카드와 국민카드 선택시 앱 카드 직접 호출 방식으로 렌더링 > > > +> > > - 노출 유형: 1(안심클릭), 2(간편결제), 3(앱 카드 직접 호출) +> > > - 카드 코드: 02(국민), 04(삼성), 06(신한), 07(현대), 08(롯데), 12(NH), 15(우리)만 가능 +> > > > > **`PaycoClientId`** **string** > > > > > > 페이코 계정 자동 로그인 기능 사용하기 위해 페이코에서 고객사에 발급한 ClientId @@ -921,259 +910,257 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > **결제 국가** > >
-> -> 국가 코드 확인하기 -> -> - AF(Afghanistan) -> - AX(Åland Islands) -> - AL(Albania) -> - DZ(Algeria) -> - AS(American Samoa) -> - AD(Andorra) -> - AO(Angola) -> - AI(Anguilla) -> - AQ(Antarctica) -> - AG(Antigua and Barbuda) -> - AR(Argentina) -> - AM(Armenia) -> - AW(Aruba) -> - AU(Australia) -> - AT(Austria) -> - AZ(Azerbaijan) -> - BH(Bahrain) -> - BS(Bahamas) -> - BD(Bangladesh) -> - BB(Barbados) -> - BY(Belarus) -> - BE(Belgium) -> - BZ(Belize) -> - BJ(Benin) -> - BM(Bermuda) -> - BT(Bhutan) -> - BO(Bolivia, Plurinational State of) -> - BQ(Bonaire, Sint Eustatius and Saba) -> - BA(Bosnia and Herzegovina) -> - BW(Botswana) -> - BV(Bouvet Island) -> - BR(Brazil) -> - IO(British Indian Ocean Territory) -> - BN(Brunei Darussalam) -> - BG(Bulgaria) -> - BF(Burkina Faso) -> - BI(Burundi) -> - KH(Cambodia) -> - CM(Cameroon) -> - CA(Canada) -> - CV(Cape Verde) -> - KY(Cayman Islands) -> - CF(Central African Republic) -> - TD(Chad) -> - CL(Chile) -> - CN(China) -> - CX(Christmas Island) -> - CC(Cocos (Keeling) Islands) -> - CO(Colombia) -> - KM(Comoros) -> - CG(Congo) -> - CD(Congo, the Democratic Republic of the) -> - CK(Cook Islands) -> - CR(Costa Rica) -> - CI(Côte d'Ivoire) -> - HR(Croatia) -> - CU(Cuba) -> - CW(Curaçao) -> - CY(Cyprus) -> - CZ(Czech Republic) -> - DK(Denmark) -> - DJ(Djibouti) -> - DM(Dominica) -> - DO(Dominican Republic) -> - EC(Ecuador) -> - EG(Egypt) -> - SV(El Salvador) -> - GQ(Equatorial Guinea) -> - ER(Eritrea) -> - EE(Estonia) -> - ET(Ethiopia) -> - FK(Falkland Islands (Malvinas)) -> - FO(Faroe Islands) -> - FJ(Fiji) -> - FI(Finland) -> - FR(France) -> - GF(French Guiana) -> - PF(French Polynesia) -> - TF(French Southern Territories) -> - GA(Gabon) -> - GM(Gambia) -> - GE(Georgia) -> - DE(Germany) -> - GH(Ghana) -> - GI(Gibraltar) -> - GR(Greece) -> - GL(Greenland) -> - GD(Grenada) -> - GP(Guadeloupe) -> - GU(Guam) -> - GT(Guatemala) -> - GG(Guernsey) -> - GN(Guinea) -> - GW(Guinea-Bissau) -> - GY(Guyana) -> - HT(Haiti) -> - HM(Heard Island and McDonald Islands) -> - VA(Holy See (Vatican City State)) -> - HN(Honduras) -> - HK(Hong Kong) -> - HU(Hungary) -> - IS(Iceland) -> - IN(India) -> - ID(Indonesia) -> - IR(Iran, Islamic Republic of) -> - IQ(Iraq) -> - IE(Ireland) -> - IM(Isle of Man) -> - IL(Israel) -> - IT(Italy) -> - JM(Jamaica) -> - JP(Japan) -> - JE(Jersey) -> - JO(Jordan) -> - KZ(Kazakhstan) -> - KE(Kenya) -> - KI(Kiribati) -> - KP(Korea, Democratic People's Republic of) -> - KR(Korea, Republic of) -> - KW(Kuwait) -> - KG(Kyrgyzstan) -> - LA(Lao People's Democratic Republic) -> - LV(Latvia) -> - LB(Lebanon) -> - LS(Lesotho) -> - LR(Liberia) -> - LY(Libya) -> - LI(Liechtenstein) -> - LT(Lithuania) -> - LU(Luxembourg) -> - MO(Macao) -> - MK(Macedonia, the Former Yugoslav Republic of) -> - MG(Madagascar) -> - MW(Malawi) -> - MY(Malaysia) -> - MV(Maldives) -> - ML(Mali) -> - MT(Malta) -> - MH(Marshall Islands) -> - MQ(Martinique) -> - MR(Mauritania) -> - MU(Mauritius) -> - YT(Mayotte) -> - MX(Mexico) -> - FM(Micronesia, Federated States of) -> - MD(Moldova, Republic of) -> - MC(Monaco) -> - MN(Mongolia) -> - ME(Montenegro) -> - MS(Montserrat) -> - MA(Morocco) -> - MZ(Mozambique) -> - MM(Myanmar) -> - NA(Namibia) -> - NR(Nauru) -> - NP(Nepal) -> - NL(Netherlands) -> - NC(New Caledonia) -> - NZ(New Zealand) -> - NI(Nicaragua) -> - NE(Niger) -> - NG(Nigeria) -> - NU(Niue) -> - NF(Norfolk Island) -> - MP(Northern Mariana Islands) -> - NO(Norway) -> - OM(Oman) -> - PK(Pakistan) -> - PW(Palau) -> - PS(Palestine, State of) -> - OA(Panama) -> - PG(Papua New Guinea) -> - PY(Paraguay) -> - PE(Peru) -> - PH(Philippines) -> - PN(Pitcairn) -> - PL(Poland) -> - PT(Portugal) -> - PR(Puerto Rico) -> - QA(Qatar) -> - RE(Réunion) -> - RO(Romania) -> - RU(Russian Federation) -> - RW(Rwanda) -> - BL(Saint Barthélemy) -> - SH(Saint Helena, Ascension and Tristan da Cunha) -> - KN(Saint Kitts and Nevis) -> - LC(Saint Lucia) -> - MF(Saint Martin (French part)) -> - PM(Saint Pierre and Miquelon) -> - VC(Saint Vincent and the Grenadines) -> - WS(Samoa) -> - SM(San Marino) -> - ST(Sao Tome and Principe) -> - SA(Saudi Arabia) -> - SN(Senegal) -> - RS(Serbia) -> - SC(Seychelles) -> - SL(Sierra Leone) -> - SG(Singapore) -> - SX(Sint Maarten (Dutch part)) -> - SK(Slovakia) -> - SI(Slovenia) -> - SB(Solomon Islands) -> - SO(Somalia) -> - ZA(South Africa) -> - GS(South Georgia and the South Sandwich Islands) -> - SS(South Sudan) -> - ES(Spain) -> - LK(Sri Lanka) -> - SD(Sudan) -> - SR(Suriname) -> - SJ(Svalbard and Jan Mayen) -> - SZ(Swaziland) -> - SE(Sweden) -> - CH(Switzerland) -> - SY(Syrian Arab Republic) -> - TW(Taiwan, Province of China) -> - TJ(Tajikistan) -> - TZ(Tanzania, United Republic of) -> - TH(Thailand) -> - TL(Timor-Leste) -> - TG(Togo) -> - TK(Tokelau) -> - TO(Tonga) -> - TT(Trinidad and Tobago) -> - TN(Tunisia) -> - TR(Turkey) -> - TM(Turkmenistan) -> - TC(Turks and Caicos Islands) -> - TV(Tuvalu) -> - UG(Uganda) -> - UA(Ukraine) -> - AE(United Arab Emirates) -> - GB(United Kingdom) -> - US(United States) -> - UM(United States Minor Outlying Islands) -> - UY(Uruguay) -> - UZ(Uzbekistan) -> - VU(Vanuatu) -> - VE(Venezuela, Bolivarian Republic of) -> - VN(Viet Nam) -> - VG(Virgin Islands, British) -> - VI(Virgin Islands, U.S.) -> - WF(Wallis and Futuna) -> - EH(Western Sahara) -> - YE(Yemen) -> - ZM(Zambia) -> - ZW(Zimbabwe) -> +> 국가 코드 확인하기 +> +> - AF(Afghanistan) +> - AX(Åland Islands) +> - AL(Albania) +> - DZ(Algeria) +> - AS(American Samoa) +> - AD(Andorra) +> - AO(Angola) +> - AI(Anguilla) +> - AQ(Antarctica) +> - AG(Antigua and Barbuda) +> - AR(Argentina) +> - AM(Armenia) +> - AW(Aruba) +> - AU(Australia) +> - AT(Austria) +> - AZ(Azerbaijan) +> - BH(Bahrain) +> - BS(Bahamas) +> - BD(Bangladesh) +> - BB(Barbados) +> - BY(Belarus) +> - BE(Belgium) +> - BZ(Belize) +> - BJ(Benin) +> - BM(Bermuda) +> - BT(Bhutan) +> - BO(Bolivia, Plurinational State of) +> - BQ(Bonaire, Sint Eustatius and Saba) +> - BA(Bosnia and Herzegovina) +> - BW(Botswana) +> - BV(Bouvet Island) +> - BR(Brazil) +> - IO(British Indian Ocean Territory) +> - BN(Brunei Darussalam) +> - BG(Bulgaria) +> - BF(Burkina Faso) +> - BI(Burundi) +> - KH(Cambodia) +> - CM(Cameroon) +> - CA(Canada) +> - CV(Cape Verde) +> - KY(Cayman Islands) +> - CF(Central African Republic) +> - TD(Chad) +> - CL(Chile) +> - CN(China) +> - CX(Christmas Island) +> - CC(Cocos (Keeling) Islands) +> - CO(Colombia) +> - KM(Comoros) +> - CG(Congo) +> - CD(Congo, the Democratic Republic of the) +> - CK(Cook Islands) +> - CR(Costa Rica) +> - CI(Côte d'Ivoire) +> - HR(Croatia) +> - CU(Cuba) +> - CW(Curaçao) +> - CY(Cyprus) +> - CZ(Czech Republic) +> - DK(Denmark) +> - DJ(Djibouti) +> - DM(Dominica) +> - DO(Dominican Republic) +> - EC(Ecuador) +> - EG(Egypt) +> - SV(El Salvador) +> - GQ(Equatorial Guinea) +> - ER(Eritrea) +> - EE(Estonia) +> - ET(Ethiopia) +> - FK(Falkland Islands (Malvinas)) +> - FO(Faroe Islands) +> - FJ(Fiji) +> - FI(Finland) +> - FR(France) +> - GF(French Guiana) +> - PF(French Polynesia) +> - TF(French Southern Territories) +> - GA(Gabon) +> - GM(Gambia) +> - GE(Georgia) +> - DE(Germany) +> - GH(Ghana) +> - GI(Gibraltar) +> - GR(Greece) +> - GL(Greenland) +> - GD(Grenada) +> - GP(Guadeloupe) +> - GU(Guam) +> - GT(Guatemala) +> - GG(Guernsey) +> - GN(Guinea) +> - GW(Guinea-Bissau) +> - GY(Guyana) +> - HT(Haiti) +> - HM(Heard Island and McDonald Islands) +> - VA(Holy See (Vatican City State)) +> - HN(Honduras) +> - HK(Hong Kong) +> - HU(Hungary) +> - IS(Iceland) +> - IN(India) +> - ID(Indonesia) +> - IR(Iran, Islamic Republic of) +> - IQ(Iraq) +> - IE(Ireland) +> - IM(Isle of Man) +> - IL(Israel) +> - IT(Italy) +> - JM(Jamaica) +> - JP(Japan) +> - JE(Jersey) +> - JO(Jordan) +> - KZ(Kazakhstan) +> - KE(Kenya) +> - KI(Kiribati) +> - KP(Korea, Democratic People's Republic of) +> - KR(Korea, Republic of) +> - KW(Kuwait) +> - KG(Kyrgyzstan) +> - LA(Lao People's Democratic Republic) +> - LV(Latvia) +> - LB(Lebanon) +> - LS(Lesotho) +> - LR(Liberia) +> - LY(Libya) +> - LI(Liechtenstein) +> - LT(Lithuania) +> - LU(Luxembourg) +> - MO(Macao) +> - MK(Macedonia, the Former Yugoslav Republic of) +> - MG(Madagascar) +> - MW(Malawi) +> - MY(Malaysia) +> - MV(Maldives) +> - ML(Mali) +> - MT(Malta) +> - MH(Marshall Islands) +> - MQ(Martinique) +> - MR(Mauritania) +> - MU(Mauritius) +> - YT(Mayotte) +> - MX(Mexico) +> - FM(Micronesia, Federated States of) +> - MD(Moldova, Republic of) +> - MC(Monaco) +> - MN(Mongolia) +> - ME(Montenegro) +> - MS(Montserrat) +> - MA(Morocco) +> - MZ(Mozambique) +> - MM(Myanmar) +> - NA(Namibia) +> - NR(Nauru) +> - NP(Nepal) +> - NL(Netherlands) +> - NC(New Caledonia) +> - NZ(New Zealand) +> - NI(Nicaragua) +> - NE(Niger) +> - NG(Nigeria) +> - NU(Niue) +> - NF(Norfolk Island) +> - MP(Northern Mariana Islands) +> - NO(Norway) +> - OM(Oman) +> - PK(Pakistan) +> - PW(Palau) +> - PS(Palestine, State of) +> - OA(Panama) +> - PG(Papua New Guinea) +> - PY(Paraguay) +> - PE(Peru) +> - PH(Philippines) +> - PN(Pitcairn) +> - PL(Poland) +> - PT(Portugal) +> - PR(Puerto Rico) +> - QA(Qatar) +> - RE(Réunion) +> - RO(Romania) +> - RU(Russian Federation) +> - RW(Rwanda) +> - BL(Saint Barthélemy) +> - SH(Saint Helena, Ascension and Tristan da Cunha) +> - KN(Saint Kitts and Nevis) +> - LC(Saint Lucia) +> - MF(Saint Martin (French part)) +> - PM(Saint Pierre and Miquelon) +> - VC(Saint Vincent and the Grenadines) +> - WS(Samoa) +> - SM(San Marino) +> - ST(Sao Tome and Principe) +> - SA(Saudi Arabia) +> - SN(Senegal) +> - RS(Serbia) +> - SC(Seychelles) +> - SL(Sierra Leone) +> - SG(Singapore) +> - SX(Sint Maarten (Dutch part)) +> - SK(Slovakia) +> - SI(Slovenia) +> - SB(Solomon Islands) +> - SO(Somalia) +> - ZA(South Africa) +> - GS(South Georgia and the South Sandwich Islands) +> - SS(South Sudan) +> - ES(Spain) +> - LK(Sri Lanka) +> - SD(Sudan) +> - SR(Suriname) +> - SJ(Svalbard and Jan Mayen) +> - SZ(Swaziland) +> - SE(Sweden) +> - CH(Switzerland) +> - SY(Syrian Arab Republic) +> - TW(Taiwan, Province of China) +> - TJ(Tajikistan) +> - TZ(Tanzania, United Republic of) +> - TH(Thailand) +> - TL(Timor-Leste) +> - TG(Togo) +> - TK(Tokelau) +> - TO(Tonga) +> - TT(Trinidad and Tobago) +> - TN(Tunisia) +> - TR(Turkey) +> - TM(Turkmenistan) +> - TC(Turks and Caicos Islands) +> - TV(Tuvalu) +> - UG(Uganda) +> - UA(Ukraine) +> - AE(United Arab Emirates) +> - GB(United Kingdom) +> - US(United States) +> - UM(United States Minor Outlying Islands) +> - UY(Uruguay) +> - UZ(Uzbekistan) +> - VU(Vanuatu) +> - VE(Venezuela, Bolivarian Republic of) +> - VN(Viet Nam) +> - VG(Virgin Islands, British) +> - VI(Virgin Islands, U.S.) +> - WF(Wallis and Futuna) +> - EH(Western Sahara) +> - YE(Yemen) +> - ZM(Zambia) +> - ZW(Zimbabwe) >
### **`productType`** **string** @@ -1231,32 +1218,30 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **카드사 다이렉트 호출 시 필요한 카드사 식별 값** > > > >
-> > -> > 카드사 식별 값 -> > -> > - KOREA_DEVELOPMENT_BANK(KDB산업은행 카드) -> > - KFCC(새마을금고 카드) -> > - SHINHYUP(신협 카드) -> > - EPOST(우체국 카드) -> > - SAVINGS_BANK_KOREA(저축은행 카드) -> > - KAKAO_BANK(카카오뱅크 카드) -> > - WOORI_CARD(우리카드) -> > - BC_CARD(BC카드) -> > - GWANGJU_CARD(광주카드) -> > - SAMSUNG_CARD(삼성카드) -> > - SHINHAN_CARD(신한카드) -> > - HYUNDAI_CARD(현대카드) -> > - LOTTE_CARD(롯데카드) -> > - SUHYUP_CARD(수협카드) -> > - CITI_CARD(씨티카드) -> > - NH_CARD(NH 농협카드) -> > - JEONBUK_CARD(전북카드) -> > - JEJU_CARD(제주카드) -> > - HANA_CARD(하나카드) -> > - KOOKMIN_CARD(국민카드) -> > - K_BANK(K뱅크 카드) -> > - TOSS_BANK(토스뱅크 카드) -> > +> > 카드사 식별 값 +> > +> > - KOREA\_DEVELOPMENT\_BANK(KDB산업은행 카드) +> > - KFCC(새마을금고 카드) +> > - SHINHYUP(신협 카드) +> > - EPOST(우체국 카드) +> > - SAVINGS\_BANK\_KOREA(저축은행 카드) +> > - KAKAO\_BANK(카카오뱅크 카드) +> > - WOORI\_CARD(우리카드) +> > - BC\_CARD(BC카드) +> > - GWANGJU\_CARD(광주카드) +> > - SAMSUNG\_CARD(삼성카드) +> > - SHINHAN\_CARD(신한카드) +> > - HYUNDAI\_CARD(현대카드) +> > - LOTTE\_CARD(롯데카드) +> > - SUHYUP\_CARD(수협카드) +> > - CITI\_CARD(씨티카드) +> > - NH\_CARD(NH 농협카드) +> > - JEONBUK\_CARD(전북카드) +> > - JEJU\_CARD(제주카드) +> > - HANA\_CARD(하나카드) +> > - KOOKMIN\_CARD(국민카드) +> > - K\_BANK(K뱅크 카드) +> > - TOSS\_BANK(토스뱅크 카드) > >
> > > **`availableCards`** **string\[]** @@ -1328,13 +1313,11 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **결제창에서 발급 가능한 현금영수증 발급 유형(소득공제용, 지출증빙용, 미발행)** > > > >
+> > 현금영수증 발급 유형 > > -> > 현금영수증 발급 유형 -> > -> > - PERSONAL (소득공제용) -> > - CORPORATE (지출증빙용) -> > - ANONYMOUS (미발행(국세청번호 자동발급)) -> > +> > - PERSONAL (소득공제용) +> > - CORPORATE (지출증빙용) +> > - ANONYMOUS (미발행(국세청번호 자동발급)) > >
> > > **`customerIdentifier`** **string** @@ -1358,82 +1341,80 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **가상계좌 은행 다이렉트 호출시 은행 코드** > > > >
-> > -> > 은행 코드 유형 -> > -> > - BANK_OF_KOREA(한국은행) -> > - KOREA_DEVELOPMENT_BANK(산업은행) -> > - INDUSTRIAL_BANK_OF_KOREA(기업은행) -> > - KOOKMIN_BANK(국민은행) -> > - SUHYUP_BANK(수협은행) -> > - EXPORT_IMPORT_BANK_OF_KOREA(수출입은행) -> > - NH_NONGHYUP_BANK(NH농협은행) -> > - LOCAL_NONGHYUP(지역농․축협) -> > - WOORI_BANK(우리은행) -> > - SC_BANK_KOREA(SC제일은행) -> > - CITI_BANK_KOREA(한국씨티은행) -> > - DAEGU_BANK(대구은행) -> > - BUSAN_BANK(부산은행) -> > - GWANGJU_BANK(광주은행) -> > - JEJU_BANK(제주은행) -> > - JEONBUK_BANK(전북은행) -> > - KYONGNAM_BANK(경남은행) -> > - KFCC(새마을금고) -> > - SHINHYUP(신협) -> > - SAVINGS_BANK_KOREA(저축은행) -> > - MORGAN_STANLEY_BANK(모건스탠리은행) -> > - HSBC_BANK(HSBC은행) -> > - DEUTSCHE_BANK(도이치은행) -> > - JP_MORGAN_CHASE_BANK(제이피모간체이스은행) -> > - MIZUHO_BANK(미즈호은행) -> > - MUFG_BANK(엠유에프지은행) -> > - BANK_OF_AMERICA_BANK(BOA은행) -> > - BNP_PARIBAS_BANK(비엔피파리바은행) -> > - ICBC(중국공상은행) -> > - BANK_OF_CHINA(중국은행) -> > - NATIONAL_FORESTRY_COOPERATIVE_FEDERATION(산림조합중앙회) -> > - UNITED_OVERSEAS_BANK(대화은행) -> > - BANK_OF_COMMUNICATIONS(교통은행) -> > - CHINA_CONSTRUCTION_BANK(중국건설은행) -> > - EPOST(우체국) -> > - KODIT(신용보증기금) -> > - KIBO(기술보증기금) -> > - HANA_BANK(하나은행) -> > - SHINHAN_BANK(신한은행) -> > - K_BANK(케이뱅크) -> > - KAKAO_BANK(카카오뱅크) -> > - TOSS_BANK(토스뱅크) -> > - KCIS(한국신용정보원) -> > - DAISHIN_SAVINGS_BANK(대신저축은행) -> > - SBI_SAVINGS_BANK(에스비아이저축은행) -> > - HK_SAVINGS_BANK(에이치케이저축은행) -> > - WELCOME_SAVINGS_BANK(웰컴저축은행) -> > - SHINHAN_SAVINGS_BANK(신한저축은행) -> > - KYOBO_SECURITIES(교보증권) -> > - DAISHIN_SECURITIES(대신증권) -> > - MERITZ_SECURITIES(메리츠증권) -> > - MIRAE_ASSET_SECURITIES(미래에셋증권) -> > - BOOKOOK_SECURITIES(부국증권) -> > - SAMSUNG_SECURITIES(삼성증권) -> > - SHINYOUNG_SECURITIES(신영증권) -> > - SHINHAN_FINANCIAL_INVESTMENT(신한금융투자) -> > - YUANTA_SECURITIES(유안타증권) -> > - EUGENE_INVESTMENT_SECURITIES(유진투자증권) -> > - KAKAO_PAY_SECURITIES(카카오페이증권) -> > - TOSS_SECURITIES(토스증권) -> > - KOREA_FOSS_SECURITIES(한국포스증권) -> > - HANA_FINANCIAL_INVESTMENT(하나금융투자) -> > - HI_INVESTMENT_SECURITIES(하이투자증권) -> > - KOREA_INVESTMENT_SECURITIES(한국투자증권) -> > - HANWHA_INVESTMENT_SECURITIES(한화투자증권) -> > - HYUNDAI_MOTOR_SECURITIES(현대차증권자) -> > - DB_FINANCIAL_INVESTMENT(DB금융투자자) -> > - KB_SECURITIES(증권) -> > - KTB_INVESTMENT_SECURITIES(KTB투자증권) -> > - LIG_INVESTMENT_AND_SECURITIES(LIG투자증권) -> > - NH_INVESTMENT_SECURITIES(NH투자증권) -> > - SK_SECURITIES(SK증권) -> > +> > 은행 코드 유형 +> > +> > - BANK\_OF\_KOREA(한국은행) +> > - KOREA\_DEVELOPMENT\_BANK(산업은행) +> > - INDUSTRIAL\_BANK\_OF\_KOREA(기업은행) +> > - KOOKMIN\_BANK(국민은행) +> > - SUHYUP\_BANK(수협은행) +> > - EXPORT\_IMPORT\_BANK\_OF\_KOREA(수출입은행) +> > - NH\_NONGHYUP\_BANK(NH농협은행) +> > - LOCAL\_NONGHYUP(지역농․축협) +> > - WOORI\_BANK(우리은행) +> > - SC\_BANK\_KOREA(SC제일은행) +> > - CITI\_BANK\_KOREA(한국씨티은행) +> > - DAEGU\_BANK(대구은행) +> > - BUSAN\_BANK(부산은행) +> > - GWANGJU\_BANK(광주은행) +> > - JEJU\_BANK(제주은행) +> > - JEONBUK\_BANK(전북은행) +> > - KYONGNAM\_BANK(경남은행) +> > - KFCC(새마을금고) +> > - SHINHYUP(신협) +> > - SAVINGS\_BANK\_KOREA(저축은행) +> > - MORGAN\_STANLEY\_BANK(모건스탠리은행) +> > - HSBC\_BANK(HSBC은행) +> > - DEUTSCHE\_BANK(도이치은행) +> > - JP\_MORGAN\_CHASE\_BANK(제이피모간체이스은행) +> > - MIZUHO\_BANK(미즈호은행) +> > - MUFG\_BANK(엠유에프지은행) +> > - BANK\_OF\_AMERICA\_BANK(BOA은행) +> > - BNP\_PARIBAS\_BANK(비엔피파리바은행) +> > - ICBC(중국공상은행) +> > - BANK\_OF\_CHINA(중국은행) +> > - NATIONAL\_FORESTRY\_COOPERATIVE\_FEDERATION(산림조합중앙회) +> > - UNITED\_OVERSEAS\_BANK(대화은행) +> > - BANK\_OF\_COMMUNICATIONS(교통은행) +> > - CHINA\_CONSTRUCTION\_BANK(중국건설은행) +> > - EPOST(우체국) +> > - KODIT(신용보증기금) +> > - KIBO(기술보증기금) +> > - HANA\_BANK(하나은행) +> > - SHINHAN\_BANK(신한은행) +> > - K\_BANK(케이뱅크) +> > - KAKAO\_BANK(카카오뱅크) +> > - TOSS\_BANK(토스뱅크) +> > - KCIS(한국신용정보원) +> > - DAISHIN\_SAVINGS\_BANK(대신저축은행) +> > - SBI\_SAVINGS\_BANK(에스비아이저축은행) +> > - HK\_SAVINGS\_BANK(에이치케이저축은행) +> > - WELCOME\_SAVINGS\_BANK(웰컴저축은행) +> > - SHINHAN\_SAVINGS\_BANK(신한저축은행) +> > - KYOBO\_SECURITIES(교보증권) +> > - DAISHIN\_SECURITIES(대신증권) +> > - MERITZ\_SECURITIES(메리츠증권) +> > - MIRAE\_ASSET\_SECURITIES(미래에셋증권) +> > - BOOKOOK\_SECURITIES(부국증권) +> > - SAMSUNG\_SECURITIES(삼성증권) +> > - SHINYOUNG\_SECURITIES(신영증권) +> > - SHINHAN\_FINANCIAL\_INVESTMENT(신한금융투자) +> > - YUANTA\_SECURITIES(유안타증권) +> > - EUGENE\_INVESTMENT\_SECURITIES(유진투자증권) +> > - KAKAO\_PAY\_SECURITIES(카카오페이증권) +> > - TOSS\_SECURITIES(토스증권) +> > - KOREA\_FOSS\_SECURITIES(한국포스증권) +> > - HANA\_FINANCIAL\_INVESTMENT(하나금융투자) +> > - HI\_INVESTMENT\_SECURITIES(하이투자증권) +> > - KOREA\_INVESTMENT\_SECURITIES(한국투자증권) +> > - HANWHA\_INVESTMENT\_SECURITIES(한화투자증권) +> > - HYUNDAI\_MOTOR\_SECURITIES(현대차증권자) +> > - DB\_FINANCIAL\_INVESTMENT(DB금융투자자) +> > - KB\_SECURITIES(증권) +> > - KTB\_INVESTMENT\_SECURITIES(KTB투자증권) +> > - LIG\_INVESTMENT\_AND\_SECURITIES(LIG투자증권) +> > - NH\_INVESTMENT\_SECURITIES(NH투자증권) +> > - SK\_SECURITIES(SK증권) > >
> > > **`accountExpiry`** **object** @@ -1472,13 +1453,11 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **결제창에서 발급 가능한 현금영수증 발급 유형(소득공제용, 지출증빙용, 미발행)** > > > >
+> > 현금영수증 발급 유형 > > -> > 현금영수증 발급 유형 -> > -> > - PERSONAL (소득공제용) -> > - CORPORATE (지출증빙용) -> > - ANONYMOUS (미발행(국세청번호 자동발급)) -> > +> > - PERSONAL (소득공제용) +> > - CORPORATE (지출증빙용) +> > - ANONYMOUS (미발행(국세청번호 자동발급)) > >
> > > **`customerIdentifier`** **string** @@ -1490,82 +1469,80 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **계좌이체 은행 다이렉트 호출시 은행 코드** > > > >
-> > -> > 은행 코드 유형 -> > -> > - BANK_OF_KOREA(한국은행) -> > - KOREA_DEVELOPMENT_BANK(산업은행) -> > - INDUSTRIAL_BANK_OF_KOREA(기업은행) -> > - KOOKMIN_BANK(국민은행) -> > - SUHYUP_BANK(수협은행) -> > - EXPORT_IMPORT_BANK_OF_KOREA(수출입은행) -> > - NH_NONGHYUP_BANK(NH농협은행) -> > - LOCAL_NONGHYUP(지역농․축협) -> > - WOORI_BANK(우리은행) -> > - SC_BANK_KOREA(SC제일은행) -> > - CITI_BANK_KOREA(한국씨티은행) -> > - DAEGU_BANK(대구은행) -> > - BUSAN_BANK(부산은행) -> > - GWANGJU_BANK(광주은행) -> > - JEJU_BANK(제주은행) -> > - JEONBUK_BANK(전북은행) -> > - KYONGNAM_BANK(경남은행) -> > - KFCC(새마을금고) -> > - SHINHYUP(신협) -> > - SAVINGS_BANK_KOREA(저축은행) -> > - MORGAN_STANLEY_BANK(모건스탠리은행) -> > - HSBC_BANK(HSBC은행) -> > - DEUTSCHE_BANK(도이치은행) -> > - JP_MORGAN_CHASE_BANK(제이피모간체이스은행) -> > - MIZUHO_BANK(미즈호은행) -> > - MUFG_BANK(엠유에프지은행) -> > - BANK_OF_AMERICA_BANK(BOA은행) -> > - BNP_PARIBAS_BANK(비엔피파리바은행) -> > - ICBC(중국공상은행) -> > - BANK_OF_CHINA(중국은행) -> > - NATIONAL_FORESTRY_COOPERATIVE_FEDERATION(산림조합중앙회) -> > - UNITED_OVERSEAS_BANK(대화은행) -> > - BANK_OF_COMMUNICATIONS(교통은행) -> > - CHINA_CONSTRUCTION_BANK(중국건설은행) -> > - EPOST(우체국) -> > - KODIT(신용보증기금) -> > - KIBO(기술보증기금) -> > - HANA_BANK(하나은행) -> > - SHINHAN_BANK(신한은행) -> > - K_BANK(케이뱅크) -> > - KAKAO_BANK(카카오뱅크) -> > - TOSS_BANK(토스뱅크) -> > - KCIS(한국신용정보원) -> > - DAISHIN_SAVINGS_BANK(대신저축은행) -> > - SBI_SAVINGS_BANK(에스비아이저축은행) -> > - HK_SAVINGS_BANK(에이치케이저축은행) -> > - WELCOME_SAVINGS_BANK(웰컴저축은행) -> > - SHINHAN_SAVINGS_BANK(신한저축은행) -> > - KYOBO_SECURITIES(교보증권) -> > - DAISHIN_SECURITIES(대신증권) -> > - MERITZ_SECURITIES(메리츠증권) -> > - MIRAE_ASSET_SECURITIES(미래에셋증권) -> > - BOOKOOK_SECURITIES(부국증권) -> > - SAMSUNG_SECURITIES(삼성증권) -> > - SHINYOUNG_SECURITIES(신영증권) -> > - SHINHAN_FINANCIAL_INVESTMENT(신한금융투자) -> > - YUANTA_SECURITIES(유안타증권) -> > - EUGENE_INVESTMENT_SECURITIES(유진투자증권) -> > - KAKAO_PAY_SECURITIES(카카오페이증권) -> > - TOSS_SECURITIES(토스증권) -> > - KOREA_FOSS_SECURITIES(한국포스증권) -> > - HANA_FINANCIAL_INVESTMENT(하나금융투자) -> > - HI_INVESTMENT_SECURITIES(하이투자증권) -> > - KOREA_INVESTMENT_SECURITIES(한국투자증권) -> > - HANWHA_INVESTMENT_SECURITIES(한화투자증권) -> > - HYUNDAI_MOTOR_SECURITIES(현대차증권자) -> > - DB_FINANCIAL_INVESTMENT(DB금융투자자) -> > - KB_SECURITIES(증권) -> > - KTB_INVESTMENT_SECURITIES(KTB투자증권) -> > - LIG_INVESTMENT_AND_SECURITIES(LIG투자증권) -> > - NH_INVESTMENT_SECURITIES(NH투자증권) -> > - SK_SECURITIES(SK증권) -> > +> > 은행 코드 유형 +> > +> > - BANK\_OF\_KOREA(한국은행) +> > - KOREA\_DEVELOPMENT\_BANK(산업은행) +> > - INDUSTRIAL\_BANK\_OF\_KOREA(기업은행) +> > - KOOKMIN\_BANK(국민은행) +> > - SUHYUP\_BANK(수협은행) +> > - EXPORT\_IMPORT\_BANK\_OF\_KOREA(수출입은행) +> > - NH\_NONGHYUP\_BANK(NH농협은행) +> > - LOCAL\_NONGHYUP(지역농․축협) +> > - WOORI\_BANK(우리은행) +> > - SC\_BANK\_KOREA(SC제일은행) +> > - CITI\_BANK\_KOREA(한국씨티은행) +> > - DAEGU\_BANK(대구은행) +> > - BUSAN\_BANK(부산은행) +> > - GWANGJU\_BANK(광주은행) +> > - JEJU\_BANK(제주은행) +> > - JEONBUK\_BANK(전북은행) +> > - KYONGNAM\_BANK(경남은행) +> > - KFCC(새마을금고) +> > - SHINHYUP(신협) +> > - SAVINGS\_BANK\_KOREA(저축은행) +> > - MORGAN\_STANLEY\_BANK(모건스탠리은행) +> > - HSBC\_BANK(HSBC은행) +> > - DEUTSCHE\_BANK(도이치은행) +> > - JP\_MORGAN\_CHASE\_BANK(제이피모간체이스은행) +> > - MIZUHO\_BANK(미즈호은행) +> > - MUFG\_BANK(엠유에프지은행) +> > - BANK\_OF\_AMERICA\_BANK(BOA은행) +> > - BNP\_PARIBAS\_BANK(비엔피파리바은행) +> > - ICBC(중국공상은행) +> > - BANK\_OF\_CHINA(중국은행) +> > - NATIONAL\_FORESTRY\_COOPERATIVE\_FEDERATION(산림조합중앙회) +> > - UNITED\_OVERSEAS\_BANK(대화은행) +> > - BANK\_OF\_COMMUNICATIONS(교통은행) +> > - CHINA\_CONSTRUCTION\_BANK(중국건설은행) +> > - EPOST(우체국) +> > - KODIT(신용보증기금) +> > - KIBO(기술보증기금) +> > - HANA\_BANK(하나은행) +> > - SHINHAN\_BANK(신한은행) +> > - K\_BANK(케이뱅크) +> > - KAKAO\_BANK(카카오뱅크) +> > - TOSS\_BANK(토스뱅크) +> > - KCIS(한국신용정보원) +> > - DAISHIN\_SAVINGS\_BANK(대신저축은행) +> > - SBI\_SAVINGS\_BANK(에스비아이저축은행) +> > - HK\_SAVINGS\_BANK(에이치케이저축은행) +> > - WELCOME\_SAVINGS\_BANK(웰컴저축은행) +> > - SHINHAN\_SAVINGS\_BANK(신한저축은행) +> > - KYOBO\_SECURITIES(교보증권) +> > - DAISHIN\_SECURITIES(대신증권) +> > - MERITZ\_SECURITIES(메리츠증권) +> > - MIRAE\_ASSET\_SECURITIES(미래에셋증권) +> > - BOOKOOK\_SECURITIES(부국증권) +> > - SAMSUNG\_SECURITIES(삼성증권) +> > - SHINYOUNG\_SECURITIES(신영증권) +> > - SHINHAN\_FINANCIAL\_INVESTMENT(신한금융투자) +> > - YUANTA\_SECURITIES(유안타증권) +> > - EUGENE\_INVESTMENT\_SECURITIES(유진투자증권) +> > - KAKAO\_PAY\_SECURITIES(카카오페이증권) +> > - TOSS\_SECURITIES(토스증권) +> > - KOREA\_FOSS\_SECURITIES(한국포스증권) +> > - HANA\_FINANCIAL\_INVESTMENT(하나금융투자) +> > - HI\_INVESTMENT\_SECURITIES(하이투자증권) +> > - KOREA\_INVESTMENT\_SECURITIES(한국투자증권) +> > - HANWHA\_INVESTMENT\_SECURITIES(한화투자증권) +> > - HYUNDAI\_MOTOR\_SECURITIES(현대차증권자) +> > - DB\_FINANCIAL\_INVESTMENT(DB금융투자자) +> > - KB\_SECURITIES(증권) +> > - KTB\_INVESTMENT\_SECURITIES(KTB투자증권) +> > - LIG\_INVESTMENT\_AND\_SECURITIES(LIG투자증권) +> > - NH\_INVESTMENT\_SECURITIES(NH투자증권) +> > - SK\_SECURITIES(SK증권) > >
### **`mobile`** **object** @@ -1581,16 +1558,14 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **휴대폰 소액결제 통신사 바로 호출을 위한 통신사 구분 값** > > > >
-> > -> > 통신사 구분 값 유형 -> > -> > - SKT (SKT) -> > - KT (KT) -> > - LGU (LGU) -> > - HELLO (LG 헬로모바일) -> > - KCT (티플러스) -> > - SK7 (SK 세븐모바일) -> > +> > 통신사 구분 값 유형 +> > +> > - SKT (SKT) +> > - KT (KT) +> > - LGU (LGU) +> > - HELLO (LG 헬로모바일) +> > - KCT (티플러스) +> > - SK7 (SK 세븐모바일) > >
### **`giftCertificate`** **object** @@ -1606,14 +1581,12 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **상품권 결제시, 상품권을 특정할 수 있는 값** > > > >
+> > 상품권 유형 > > -> > 상품권 유형 -> > -> > - BOOKNLIFE (도서문화상품권) -> > - SMART_MUNSANG (스마트문상, (구)게임문화상품권) -> > - CULTURELAND (문화상품권) -> > - HAPPYMONEY (해피머니) -> > +> > - BOOKNLIFE (도서문화상품권) +> > - SMART\_MUNSANG (스마트문상, (구)게임문화상품권) +> > - CULTURELAND (문화상품권) +> > - HAPPYMONEY (해피머니) > >
### **`easyPay`** **object** @@ -1629,21 +1602,19 @@ description: 결제요청 파라미터를 확인할 수 있습니다. > > **간편결제 수단** > > > >
-> > -> > 간편결제 수단 유형 -> > -> > - PAYCO (페이코) -> > - SAMSUNGPAY (삼성페이) -> > - APPLEPAY (애플페이) -> > - SSGPAY (SSGPAY) -> > - KAKAOPAY (KAKAOPAY) -> > - NAVERPAY (NAVERPAY) -> > - CHAI (CHAI) -> > - LPAY (LPAY) -> > - KPAY (KPAY) -> > - TOSSPAY (TOSSPAY) -> > - LGPAY (LGPAY) -> > +> > 간편결제 수단 유형 +> > +> > - PAYCO (페이코) +> > - SAMSUNGPAY (삼성페이) +> > - APPLEPAY (애플페이) +> > - SSGPAY (SSGPAY) +> > - KAKAOPAY (KAKAOPAY) +> > - NAVERPAY (NAVERPAY) +> > - CHAI (CHAI) +> > - LPAY (LPAY) +> > - KPAY (KPAY) +> > - TOSSPAY (TOSSPAY) +> > - LGPAY (LGPAY) > >
> > > **`useFreeInterestFromMall`** **boolean** diff --git a/src/content/docs/ko/v2-payment/v2.mdx b/src/content/docs/ko/v2-payment/v2.mdx index ed4783cc5..46ce04fe1 100644 --- a/src/content/docs/ko/v2-payment/v2.mdx +++ b/src/content/docs/ko/v2-payment/v2.mdx @@ -3,74 +3,86 @@ title: "V2 신모듈 소개" description: 새롭게 출시된 V2 서비스를 소개드립니다. --- -import Hint from "~/components/Hint.astro"; import Figure from "~/components/Figure.astro"; +import Hint from "~/components/Hint.astro"; + import getOpenApiImage from "./_assets/v2/developers_openapi_example.png"; -import getPostmanImportImage from "./_assets/v2/postman_import_example.png"; +import getNpmTypescriptExampleImage from "./_assets/v2/npm_typescript_example.png"; import getPostmanApiStructureImage from "./_assets/v2/postman_api_structure.png"; +import getPostmanImportImage from "./_assets/v2/postman_import_example.png"; import getV2CoproductExampleImage from "./_assets/v2/v2_coproduct_example.png"; -import getNpmTypescriptExampleImage from "./_assets/v2/npm_typescript_example.png"; -## 포트원 신모듈 소개 [V2] +## 포트원 신모듈 소개 \[V2] -포트원 V2는 10년 간의 포트원 운영 경험을 바탕으로 새롭게 설계되었습니다. 개발자 경험의 혁신적인 개선을 통해 포트원을 연동하는 개발자들은 더욱 쉽게 시스템을 이해하고 빠르게 결제 기능을 연동할 수 있습니다. 또한 포트원 V2는 사용자가 직접 느낄 수 있는 개발자 경험의 개선 이외에도, 눈에 보이지 않는 내부적인 부분 또한 많은 개선을 이루었습니다. +포트원 V2는 10년 간의 포트원 운영 경험을 바탕으로 새롭게 설계되었습니다. 개발자 경험의 혁신적인 개선을 통해 포트원을 연동하는 개발자들은 +더욱 쉽게 시스템을 이해하고 빠르게 결제 기능을 연동할 수 있습니다. +또한 포트원 V2는 사용자가 직접 느낄 수 있는 개발자 경험의 개선 이외에도, 눈에 보이지 않는 내부적인 부분 또한 많은 개선을 이루었습니다. ### 혁신적인 개발자 경험: 쉽고 편리한 결제 연동
-포트원 V2는 개발자 경험(Developer Experience)을 혁신적으로 개선하여 쉽고 편리한 결제 연동을 돕습니다. 포트원이 제공하는 차별화된 개발자 경험의 예시는 아래와 같습니다. +포트원 V2는 개발자 경험(Developer Experience)을 혁신적으로 개선하여 쉽고 편리한 결제 연동을 돕습니다. +포트원이 제공하는 차별화된 개발자 경험의 예시는 아래와 같습니다. - **Open API Spec Download** - - 연동용 코드 자동 생성, Custom API Document 활용, Postman Import 등에 사용 가능한 Open API Spec을 다운로드하실 수 있는 기능을 제공합니다. + - 연동용 코드 자동 생성, Custom API Document 활용, Postman Import 등에 + 사용 가능한 Open API Spec을 다운로드하실 수 있는 기능을 제공합니다. -
+

-
+ +
- **직관성 있는 스키마 설계** - - open API spec 파일은 [REST API 문서 페이지](../../../api/rest-v2)에서 **OpenAPI JSON 내려받기** 버튼을 눌러 다운 받으실 수 있습니다. + + - open API spec 파일은 [REST API 문서 페이지](../../../api/rest-v2)에서 **OpenAPI JSON 내려받기** 버튼을 눌러 + 다운 받으실 수 있습니다. + - 타입에 따라 달라지는 스키마 구조를 정확히 표현하여 더욱 예측 가능한 인터페이스로 디자인했습니다. - - 예를 들어 가상계좌로 결제한 결제 건을 조회한다고 가정했을 때, 해당 결제 건은 계좌번호를 항상 포함하고 있을 것입니다. 하지만 기존 시스템을 이용하는 경우, 결제수단별로 응답 스키마가 달라지지 않고 모든 필드를 열거하고 있기 때문에 가상계좌 결제 건임에도 계좌번호는 optional로 제공됩니다. 반면 포트원 V2는 결제수단별로 달라지는 스키마 구조를 정확히 표현하고 있기 때문에, 가상계좌 결제 건일 때는 계좌번호가 required로 제공된다는 것이 타입으로 보장됩니다. + + - 예를 들어 가상계좌로 결제한 결제 건을 조회한다고 가정했을 때, 해당 결제 건은 계좌번호를 항상 포함하고 있을 것입니다. + 하지만 기존 시스템을 이용하는 경우, 결제수단별로 응답 스키마가 달라지지 않고 모든 필드를 열거하고 있기 때문에 + 가상계좌 결제 건임에도 계좌번호는 optional로 제공됩니다. + 반면 포트원 V2는 결제수단별로 달라지는 스키마 구조를 정확히 표현하고 있기 때문에, 가상계좌 결제 건일 때는 + 계좌번호가 required로 제공된다는 것이 타입으로 보장됩니다. + - 이러한 예시를 통해 확인할 수 있듯이, 개발자는 포트원 V2의 직관적인 인터페이스를 통해 결제 시스템을 쉽게 이해하고 불필요한 코드 작성을 최소화할 수 있습니다. -
+
+ - **npm, Typescript 지원** + - V2 SDK는 Typescript로 작성되어 함수의 파라미터 및 응답의 타입을 확인하실 수 있고, npm을 통해 install이 가능합니다. -
+
## 내부 시스템 개선: 풍부한 데이터와 견고한 서버 -포트원 V2는 개발자 경험의 개선을 통해 연동의 편리함을 보장하면서, 장기적으로 고객사의 서비스 운영에 도움이 될 만한 내부 시스템 개선을 진행했습니다. 고객사의 제품 품질 향상과 개선된 비즈니스 의사결정을 도울 수 있는 풍부한 데이터를 제공합니다. 또한 안정적인 운영을 위해 훨씬 더 견고한 시스템을 구축했습니다. +포트원 V2는 개발자 경험의 개선을 통해 연동의 편리함을 보장하면서, 장기적으로 고객사의 서비스 운영에 도움이 될 만한 내부 시스템 개선을 진행했습니다. +고객사의 제품 품질 향상과 개선된 비즈니스 의사결정을 도울 수 있는 풍부한 데이터를 제공합니다. 또한 안정적인 운영을 위해 훨씬 더 견고한 시스템을 구축했습니다. ### 확장성: 무한한 가능성을 열어주는 결제 시스템 -V2는 '항상 준비된 시스템'입니다. 향상된 [오토스케일링](https://ko.wikipedia.org/wiki/%EC%98%A4%ED%86%A0%EC%8A%A4%EC%BC%80%EC%9D%BC%EB%A7%81) 능력을 제공하는 포트원 V2는 블랙프라이데이부터 크리스마스 선착순 이벤트까지, 아무리 많은 결제 트래픽이 몰려도 문제없이 처리할 수 있습니다. V1의 오토스케일링도 훌륭하지만, V2는 더 빠른 반응 속도로 더 많은 트래픽을 감당할 수 있는 '진화된 스케일링 능력'을 갖췄습니다. +V2는 '항상 준비된 시스템'입니다. 향상된 [오토스케일링](https://ko.wikipedia.org/wiki/%EC%98%A4%ED%86%A0%EC%8A%A4%EC%BC%80%EC%9D%BC%EB%A7%81) +능력을 제공하는 포트원 V2는 블랙프라이데이부터 크리스마스 선착순 이벤트까지, 아무리 많은 결제 트래픽이 몰려도 문제없이 처리할 수 있습니다. +V1의 오토스케일링도 훌륭하지만, V2는 더 빠른 반응 속도로 더 많은 트래픽을 감당할 수 있는 '진화된 스케일링 능력'을 갖췄습니다. ### 안정성: 신뢰할 수 있는 서버 -V2의 서버 시스템은 더욱 강해졌습니다. 휴먼 에러의 위험성을 극단적으로 줄이기 위해 모든 서버 시스템은 자동화된 코드로 관리됩니다. 추가로 [Scala]()와 같은 강타입 언어를 사용하여 시스템의 안정성을 더욱 강화했습니다. +V2의 서버 시스템은 더욱 강해졌습니다. 휴먼 에러의 위험성을 극단적으로 줄이기 위해 모든 서버 시스템은 자동화된 코드로 관리됩니다. +추가로 [Scala](https://ko.wikipedia.org/wiki/%EC%8A%A4%EC%B9%BC%EB%9D%BC_\(%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%98%EB%B0%8D_%EC%96%B8%EC%96%B4\))와 +같은 강타입 언어를 사용하여 시스템의 안정성을 더욱 강화했습니다. ### 완벽한 데이터 보존: 우수한 데이터 정합성과 풍부한 정보 제공 -V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https://learn.microsoft.com/ko-kr/azure/architecture/patterns/event-sourcing) 기술을 접목하여 서비스의 모든 결제 처리 내역을 빠짐없이 보존합니다. 이를 통해 비즈니스 의사결정에 필요한 주요 정보를 풍부하게 제공합니다. +V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https://learn.microsoft.com/ko-kr/azure/architecture/patterns/event-sourcing) +기술을 접목하여 서비스의 모든 결제 처리 내역을 빠짐없이 보존합니다. 이를 통해 비즈니스 의사결정에 필요한 주요 정보를 풍부하게 제공합니다. ### 기능 확장: 신속한 업데이트와 혁신 -V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될 스마트라우팅은 V2 인프라를 이용 중인 고객사에게 우선하여 제공됩니다. 최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다. +V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될 스마트라우팅은 V2 인프라를 이용 중인 고객사에게 우선하여 제공됩니다. +최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다. ## 사용 가능한 PG사 @@ -84,7 +96,7 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될 - **네이버페이** - **스마트로** - **나이스페이먼츠** -- **페이팔** +- **페이팔** ### 본인인증 @@ -99,8 +111,7 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될
-V2 API Secret 요청 또는 추가적으로 궁금하신 사항은 아래 이메일로 문의주시기 바랍니다. - -- V2 기술지원 이메일: tech.support@portone.io + 추가적으로 궁금하신 사항은 아래 이메일로 문의주시기 바랍니다. + - V2 기술지원 이메일: [tech.support@portone.io](mailto:tech.support@portone.io)