From e3b5beb2c8611136ccba0ffe471c1a4b3225b306 Mon Sep 17 00:00:00 2001 From: youjmen Date: Mon, 12 Jan 2026 19:15:08 +0900 Subject: [PATCH 1/4] =?UTF-8?q?feat:=20=EA=B0=A4=EB=9F=AD=EC=8B=9C?= =?UTF-8?q?=EC=95=84=20v2=20=EB=AC=B8=EC=84=9C=20=EC=B6=94=EA=B0=80,=20?= =?UTF-8?q?=EC=A7=80=EC=9B=90=20=EA=B2=B0=EC=A0=9C=20=EC=88=98=EB=8B=A8?= =?UTF-8?q?=EC=97=90=20=EB=A8=B8=EB=8B=88=ED=8A=B8=EB=A6=AC=20=EC=B6=94?= =?UTF-8?q?=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/routes/(root)/opi/ko/_nav.yaml | 1 + .../opi/ko/integration/pg/v1/galaxia.mdx | 1 + .../opi/ko/integration/pg/v2/galaxia.mdx | 689 ++++++++++++++++++ 3 files changed, 691 insertions(+) create mode 100644 src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx diff --git a/src/routes/(root)/opi/ko/_nav.yaml b/src/routes/(root)/opi/ko/_nav.yaml index cb211982b..49e8bf057 100644 --- a/src/routes/(root)/opi/ko/_nav.yaml +++ b/src/routes/(root)/opi/ko/_nav.yaml @@ -32,6 +32,7 @@ - /ko/integration/pg/v2/paypal-v2 - /ko/integration/pg/v2/eximbay-v2 - /ko/integration/pg/v2/payletter-global + - /ko/integration/pg/v2/galaxia - /ko/integration/using-ai-tools - label: 부가 기능 diff --git a/src/routes/(root)/opi/ko/integration/pg/v1/galaxia.mdx b/src/routes/(root)/opi/ko/integration/pg/v1/galaxia.mdx index 4fcf25cac..960a65eba 100644 --- a/src/routes/(root)/opi/ko/integration/pg/v1/galaxia.mdx +++ b/src/routes/(root)/opi/ko/integration/pg/v1/galaxia.mdx @@ -284,6 +284,7 @@ PC의 경우 **callback** 함수로 전달되고 - samsungpay (삼성페이) - applepay (애플페이) - payco (페이코) + - moneytree (머니트리) diff --git a/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx new file mode 100644 index 000000000..9d2c48a8b --- /dev/null +++ b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx @@ -0,0 +1,689 @@ +--- +title: 갤럭시아 +description: 갤럭시아 결제 연동 방법을 안내합니다. +targetVersions: ["v2"] +versionVariants: + v1: /opi/ko/integration/pg/v1/galaxia +--- + +import Details from "~/components/gitbook/Details"; +import Tabs from "~/components/gitbook/Tabs"; +import Parameter from "~/components/parameter/Parameter"; + +## 채널 설정하기 + +- [결제대행사 채널 설정하기](/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다. + +## 가능한 결제 수단 + +- **결제창 일반 결제** + + `payMethod` 파라미터를 결제 수단에 따라 아래와 같이 설정해야 합니다. + + - 카드 : `CARD` + - 계좌이체 : `TRANSFER` + - 가상계좌 : `VIRTUAL_ACCOUNT` + - 휴대폰 소액 결제 : `MOBILE` + - 상품권 : `GIFT_CERTIFICATE` + - 간편결제 : `EASY_PAY` + +- **결제창 빌링키 발급** + + `billingKeyMethod` 파라미터를 결제 수단에 따라 아래와 같이 설정해야 합니다. + + - 카드: `CARD` + +- **결제창 빌링키 발급과 동시에 결제** + + `billingKeyAndPayMethod` 파라미터를 결제 수단에 따라 아래와 같이 설정해야 합니다. + + - 휴대폰: `MOBILE` + +## SDK 결제 요청하기 + +결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다. +`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아 채널 사용을 명시해주세요. + +갤럭시아 기준으로 작성한 예시 코드는 아래와 같습니다. + + + + ```javascript + import * as PortOne from "@portone/browser-sdk/v2"; + function requestPayment() { + PortOne.requestPayment({ + storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요. + channelKey: "channel-key-9987cb87-6458-4888-b94e-68d9a2da896d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요. + paymentId: `payment${crypto.randomUUID()}`, + orderName: "나이키 와플 트레이너 2 SD", + totalAmount: 1000, + currency: "CURRENCY_KRW", + payMethod: "CARD", + customer: { + customerId: "customer-1234", // 고객사가 구매자에게 부여한 고유 ID (필수) + fullName: "포트원", + phoneNumber: "010-0000-1234", + email: "test@portone.io", + }, + bypass: { + galaxia: { + ITEM_CODE: "상품코드", // 필수, 최대 10바이트 + }, + }, + }); + } + ``` + + + +### 주요 파라미터 + + + - storeId: string + + **상점 아이디** + + 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다. + + - paymentId: string + + **고객사 주문 고유 번호** + + 고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다. (최대 64자) + + - orderName: string + + **주문명** + + 주문명으로 고객사에서 자유롭게 입력합니다. 갤럭시아의 경우 필수로 입력해야 합니다. + + - channelKey: string + + **채널 키** + + 포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 시 생성되는 값입니다. 결제 호출 시 채널을 지정할 때 사용됩니다. + + - totalAmount: number + + **결제 금액** + + 결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다. + + - currency: string + + **결제 통화** + + 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 갤럭시아의 경우 `KRW`만 지원됩니다. + + - payMethod: string + + **결제수단 구분코드** + + 결제 호출 시 결제수단을 지정할 때 사용됩니다. + + - 신용카드 : `CARD` + - 실시간 계좌이체 : `TRANSFER` + - 가상계좌 : `VIRTUAL_ACCOUNT` + - 휴대폰 소액결제 : `MOBILE` + - 상품권 : `GIFT_CERTIFICATE` + - 간편 결제 : `EASY_PAY` + + - taxFreeAmount?: number + + **면세 금액** (기본값: 0) + + - vatAmount?: number + + **부가세 금액** + + 미 입력시 과세 금액의 1/11로 자동 계산됩니다. + + - customer: object + + **고객 정보** + + + - customerId: string + + **구매자 고유 ID** + + 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아의 경우 필수 입력이며 최대 20자까지 허용됩니다. + + - fullName?: string + + **구매자 전체 이름** + + - firstName?: string + + **구매자 이름** + + - lastName?: string + + **구매자 성** + + - phoneNumber?: string + + **구매자 연락처** + + 계좌이체 결제 시 필수 입력입니다. + + - email?: string + + **구매자 이메일** + + + - redirectUrl?: string + + **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL** + + 갤럭시아의 경우 **모바일 환경에서 필수 입력**입니다. + + - noticeUrls?: string[] + + **트랜잭션 종료 후 웹훅이 발송 될 고객사 서버 URL** + + 설정시 콘솔에 설정된 웹훅 URL은 override 되며 해당 주소로만 웹훅이 발송됩니다. + + - appScheme?: string + + **IOS 앱에서 결제시 카드/은행 앱에서 인증 후 복귀 될 고객사 커스텀 앱 URL Scheme** + + - 예: `portone://` + - 주의: **IOS 앱 결제시 필수** 입력이며 **앱이 아닌 모바일 웹 결제시에는 입력하지 마세요.** + + - isEscrow?: boolean + + **에스크로 결제 여부** (기본값: false) + + 갤럭시아의 경우, 계좌이체/가상계좌 결제시 에스크로 결제가 허용됩니다. + + - virtualAccount?: object + + **가상계좌 결제 관련 설정** + + + - accountExpiry?: object + + **입금 만료 기한** + + 갤럭시아의 경우 가상계좌 결제시 **필수 입력**입니다. + + + - validHours?: integer + + **유효 시간** + + - dueDate?: string + + **만료 시점** + + 시간은 RFC 3339 date-time 형식으로 입력해야 합니다. + + + + - card?: object + + **카드 결제 관련 설정** + + + - cardCompany?: string + + **카드사 다이렉트 호출 시 카드사 코드** + + [카드사 코드](/opi/ko/support/code-info/card-code) 참조 + + - installment?: object + + **할부 설정** + + + - monthOption?: object + + **할부 개월 수 옵션** + + + - fixedMonth?: number + + **고정 할부 개월 수** + + 일시불일 시 0으로 설정합니다. + + - availableMonthList?: number[] + + **선택 가능한 할부 개월 수 목록** + + 예시: `[0, 2, 3, 4, 5, 6]` - 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능 + + + + + - mobile?: object + + **휴대폰 결제 관련 설정** + + + - carrier?: string + + **휴대폰 통신사 코드** + + `SKT`, `KT`, `LGU`, `HELLO`, `KCT`, `SK7` + + + - giftCertificate?: object + + **상품권 결제 관련 설정** + + + - giftCertificateType?: string + + **상품권 종류** + + - 컬쳐랜드: `CULTURELAND` + - 스마트문상: `SMART_MUNSANG` + - 도서문화상품권: `BOOKNLIFE` + - 해피머니: `HAPPYMONEY` + + + - easyPay?: object + + **간편결제 관련 설정** + + + - easyPayProvider?: string + + **간편결제사 코드** + + - 카카오페이: `KAKAOPAY` + - 네이버페이: `NAVERPAY` + - 토스페이: `TOSSPAY` + - 삼성페이: `SAMSUNGPAY` + - 애플페이: `APPLEPAY` + - 페이코: `PAYCO` + - 머니트리: `MONEYTREE` + + + - bypass: object + + **PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음** + + + - galaxia: object + + **갤럭시아 전용 파라미터** + + + - ITEM_CODE: string + + **구매 상품코드** + + 갤럭시아에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**) + + + + +### 유의사항 + +
+ 갤럭시아 지원 결제 수단 + + + - CARD (신용카드) + - TRANSFER (실시간 계좌이체) + 에스크로 + - VIRTUAL_ACCOUNT (가상계좌) + 에스크로 + - MOBILE (휴대폰소액결제) + - GIFT_CERTIFICATE (상품권) + - CULTURELAND (컬쳐랜드) + - SMART_MUNSANG (스마트문상) + - BOOKNLIFE (도서문화상품권) + - HAPPYMONEY (해피머니) + - EASY_PAY (간편결제) + - KAKAOPAY (카카오페이) + - NAVERPAY (네이버페이) + - TOSSPAY (토스페이) + - SAMSUNGPAY (삼성페이) + - APPLEPAY (애플페이) + - PAYCO (페이코) + +
+ +
+ 가능한 트랜잭션 환경 + + + - PC (iframe) + - 모바일 (리디렉션) + +
+ +## SDK 빌링키 발급 요청하기 + +빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다. +`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아 채널 사용을 명시해주세요. + +갤럭시아 기준으로 작성한 예시 코드는 아래와 같습니다. + + + + ```javascript + import * as PortOne from "@portone/browser-sdk/v2"; + function requestIssueBillingKey() { + PortOne.requestIssueBillingKey({ + storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요. + channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요. + billingKeyMethod: "CARD", // 갤럭시아의 경우 'CARD'만 지원됩니다. + issueId: "test-issueId", + issueName: "빌링키 발급", + displayAmount: 1000, + currency: "KRW", + customer: { + customerId: "customer-1234", // 고객사가 구매자에게 부여한 고유 ID (필수) + fullName: "포트원", + phoneNumber: "010-0000-1234", + email: "test@portone.io", + }, + bypass: { + galaxia: { + ITEM_CODE: "상품코드", // 필수, 최대 10바이트 + }, + }, + }); + } + ``` + + + +### 주요 파라미터 + + + - storeId: string + + **상점 아이디** + + 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다. + + - channelKey: string + + **채널 키** + + 포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 시 생성되는 값입니다. 결제 호출 시 채널을 지정할 때 사용됩니다. + + - billingKeyMethod: string + + **빌링키 발급수단** + + 갤럭시아는 빌링키 발급 수단으로 카드만을 지원하므로 해당 파라미터는 `CARD`로 고정해야 합니다. + + - issueId: string + + **빌링키 발급 건 고유 ID** + + 고객사에서 채번하여 사용해야 합니다. + + - issueName: string + + **빌링키 발급 시 결제창에 표시되는 제목** + + 갤럭시아의 경우 필수로 입력해야 합니다. + + - displayAmount?: number + + **결제창에 표시될 금액** + + 빌링키 발급 시 amount가 0이거나 미입력시 1000원으로 노출됩니다. (결제 발생하지 않음) + + - currency?: string + + **결제 통화** + + 갤럭시아의 경우 `KRW`만 지원됩니다. + + - customer: object + + **고객 정보** + + + - customerId: string + + **구매자 고유 ID** + + 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아의 경우 필수 입력입니다. + + - fullName?: string + + **구매자 전체 이름** + + - firstName?: string + + **구매자 이름** + + - lastName?: string + + **구매자 성** + + - phoneNumber?: string + + **구매자 연락처** + + - email?: string + + **구매자 이메일** + + + - redirectUrl?: string + + **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL** + + 갤럭시아의 경우 **모바일 환경에서 필수 입력**입니다. + + - bypass: object + + **PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음** + + + - galaxia: object + + **갤럭시아 전용 파라미터** + + + - ITEM_CODE: string + + **구매 상품코드** + + 갤럭시아에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**) + + + + +
+ 갤럭시아 지원 빌링키 발급 수단 + + + - CARD (카드) + +
+ +## SDK 빌링키 발급 및 결제 요청하기 + +빌링키 발급과 동시에 결제 요청 시에는 `requestIssueBillingKeyAndPay` 함수를 호출해야 합니다. +`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아 채널 사용을 명시해주세요. + +갤럭시아 기준으로 작성한 예시 코드는 아래와 같습니다. + + + + ```javascript + import * as PortOne from "@portone/browser-sdk/v2"; + function requestIssueBillingKeyAndPay() { + PortOne.requestIssueBillingKeyAndPay({ + storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요. + channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요. + billingKeyAndPayMethod: "MOBILE", // 갤럭시아의 경우 'MOBILE'만 지원됩니다. + paymentId: `payment${crypto.randomUUID()}`, + orderName: "월간 이용권 정기결제", + totalAmount: 1000, // 전달한 금액 만큼 실제로 승인이 됩니다. + currency: "KRW", + customer: { + customerId: "customer-1234", // 고객사가 구매자에게 부여한 고유 ID (필수) + fullName: "포트원", + phoneNumber: "010-0000-1234", + email: "test@portone.io", + }, + bypass: { + galaxia: { + ITEM_CODE: "상품코드", // 필수, 최대 10바이트 + }, + }, + }); + } + ``` + + + +### 주요 파라미터 + + + - storeId: string + + **상점 아이디** + + 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다. + + - channelKey: string + + **채널 키** + + 포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 시 생성되는 값입니다. 결제 호출 시 채널을 지정할 때 사용됩니다. + + - billingKeyAndPayMethod: string + + **빌링키 발급 및 결제수단** + + 갤럭시아의 경우, 빌링키 발급과 동시에 결제 수단은 `MOBILE`만 허용되며 **반드시 `MOBILE`을 필수로 입력해주셔야** 합니다. + + - paymentId: string + + **주문 번호** + + 매번 고유하게 채번되어야 합니다. + + - orderName: string + + **주문명** + + 갤럭시아의 경우 필수로 입력해야 합니다. + + - totalAmount: number + + **결제 금액** + + **string** 이 아닌 점에 유의하세요. 전달한 금액 만큼 실제로 승인이 됩니다. + + - currency?: string + + **결제 통화** + + 갤럭시아의 경우 `KRW`만 지원됩니다. + + - customer: object + + **고객 정보** + + + - customerId: string + + **구매자 고유 ID** + + 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아의 경우 필수 입력이며 최대 20자까지 허용됩니다. + + - fullName?: string + + **구매자 전체 이름** + + - firstName?: string + + **구매자 이름** + + - lastName?: string + + **구매자 성** + + - phoneNumber?: string + + **구매자 연락처** + + - email?: string + + **구매자 이메일** + + + - redirectUrl?: string + + **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL** + + 갤럭시아의 경우 **모바일 환경에서 필수 입력**입니다. + + - mobile?: object + + **휴대폰 결제 관련 설정** + + + - carrier?: string + + **휴대폰 통신사 코드** + + `SKT`, `KT`, `LGU`, `HELLO`, `KCT`, `SK7` + + + - bypass: object + + **PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음** + + + - galaxia: object + + **갤럭시아 전용 파라미터** + + + - ITEM_CODE: string + + **구매 상품코드** + + 갤럭시아에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**) + + + + +
+ 갤럭시아 지원 빌링키 발급과 동시에 결제 수단 + + + - MOBILE (휴대폰소액결제) + +
+ +## 연동 유의사항 + +### 갤럭시아 필수 파라미터 + +갤럭시아 연동 시 아래 파라미터는 필수로 입력해야 합니다. + +- `bypass.galaxia.ITEM_CODE`: 갤럭시아에서 발급받은 상품 코드 (최대 10자) +- `customer.customerId`: 고객사가 구매자에게 부여한 고유 ID (최대 20자) +- `orderName`: 주문명 + +### 모바일 결제 시 필수 파라미터 + +모바일 환경에서 결제 시 `redirectUrl` 파라미터를 필수로 입력해야 합니다. + +### 가상계좌 결제 시 필수 파라미터 + +가상계좌 결제 시 `virtualAccount.accountExpiry` 파라미터를 필수로 입력해야 합니다. + +### 빌링키 발급 제약사항 + +- **결제창 빌링키 발급**: 카드(`CARD`)만 지원 +- **결제창 빌링키 발급과 동시에 결제**: 휴대폰(`MOBILE`)만 지원 + +### 지원 통화 + +갤럭시아는 `KRW`만 지원합니다. From dc7e2e8b2b26176e97e7244ea4420e01ef1a7d6c Mon Sep 17 00:00:00 2001 From: youjmen Date: Mon, 12 Jan 2026 19:21:21 +0900 Subject: [PATCH 2/4] fix: lint --- .../opi/ko/integration/pg/v2/galaxia.mdx | 101 +++++++++--------- 1 file changed, 53 insertions(+), 48 deletions(-) diff --git a/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx index 9d2c48a8b..7498341d5 100644 --- a/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx +++ b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx @@ -1,6 +1,6 @@ --- -title: 갤럭시아 -description: 갤럭시아 결제 연동 방법을 안내합니다. +title: 갤럭시아머니트리 +description: 갤럭시아머니트리 결제 연동 방법을 안내합니다. targetVersions: ["v2"] versionVariants: v1: /opi/ko/integration/pg/v1/galaxia @@ -42,9 +42,9 @@ import Parameter from "~/components/parameter/Parameter"; ## SDK 결제 요청하기 결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다. -`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아 채널 사용을 명시해주세요. +`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아머니트리 채널 사용을 명시해주세요. -갤럭시아 기준으로 작성한 예시 코드는 아래와 같습니다. +갤럭시아머니트리 기준으로 작성한 예시 코드는 아래와 같습니다. @@ -95,7 +95,7 @@ import Parameter from "~/components/parameter/Parameter"; **주문명** - 주문명으로 고객사에서 자유롭게 입력합니다. 갤럭시아의 경우 필수로 입력해야 합니다. + 주문명으로 고객사에서 자유롭게 입력합니다. 갤럭시아머니트리의 경우 필수로 입력해야 합니다. - channelKey: string @@ -113,7 +113,7 @@ import Parameter from "~/components/parameter/Parameter"; **결제 통화** - 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 갤럭시아의 경우 `KRW`만 지원됩니다. + 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 갤럭시아머니트리의 경우 `KRW`만 지원됩니다. - payMethod: string @@ -147,7 +147,7 @@ import Parameter from "~/components/parameter/Parameter"; **구매자 고유 ID** - 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아의 경우 필수 입력이며 최대 20자까지 허용됩니다. + 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아머니트리의 경우 필수 입력이며 최대 20자까지 허용됩니다. - fullName?: string @@ -176,9 +176,9 @@ import Parameter from "~/components/parameter/Parameter"; **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL** - 갤럭시아의 경우 **모바일 환경에서 필수 입력**입니다. + 갤럭시아머니트리의 경우 **모바일 환경에서 필수 입력**입니다. - - noticeUrls?: string[] + - noticeUrls?: string\[] **트랜잭션 종료 후 웹훅이 발송 될 고객사 서버 URL** @@ -195,7 +195,7 @@ import Parameter from "~/components/parameter/Parameter"; **에스크로 결제 여부** (기본값: false) - 갤럭시아의 경우, 계좌이체/가상계좌 결제시 에스크로 결제가 허용됩니다. + 갤럭시아머니트리의 경우, 계좌이체/가상계좌 결제시 에스크로 결제가 허용됩니다. - virtualAccount?: object @@ -206,7 +206,7 @@ import Parameter from "~/components/parameter/Parameter"; **입금 만료 기한** - 갤럭시아의 경우 가상계좌 결제시 **필수 입력**입니다. + 갤럭시아머니트리의 경우 가상계좌 결제시 **필수 입력**입니다. - validHours?: integer @@ -248,7 +248,7 @@ import Parameter from "~/components/parameter/Parameter"; 일시불일 시 0으로 설정합니다. - - availableMonthList?: number[] + - availableMonthList?: number\[] **선택 가능한 할부 개월 수 목록** @@ -309,14 +309,14 @@ import Parameter from "~/components/parameter/Parameter"; - galaxia: object - **갤럭시아 전용 파라미터** + **갤럭시아머니트리 전용 파라미터** - - ITEM_CODE: string + - ITEM\_CODE: string **구매 상품코드** - 갤럭시아에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**) + 갤럭시아머니트리에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**) @@ -324,19 +324,24 @@ import Parameter from "~/components/parameter/Parameter"; ### 유의사항
- 갤럭시아 지원 결제 수단 + 갤럭시아머니트리 지원 결제 수단 - CARD (신용카드) + - TRANSFER (실시간 계좌이체) + 에스크로 - - VIRTUAL_ACCOUNT (가상계좌) + 에스크로 + + - VIRTUAL\_ACCOUNT (가상계좌) + 에스크로 + - MOBILE (휴대폰소액결제) - - GIFT_CERTIFICATE (상품권) + + - GIFT\_CERTIFICATE (상품권) - CULTURELAND (컬쳐랜드) - - SMART_MUNSANG (스마트문상) + - SMART\_MUNSANG (스마트문상) - BOOKNLIFE (도서문화상품권) - HAPPYMONEY (해피머니) - - EASY_PAY (간편결제) + + - EASY\_PAY (간편결제) - KAKAOPAY (카카오페이) - NAVERPAY (네이버페이) - TOSSPAY (토스페이) @@ -358,9 +363,9 @@ import Parameter from "~/components/parameter/Parameter"; ## SDK 빌링키 발급 요청하기 빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다. -`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아 채널 사용을 명시해주세요. +`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아머니트리 채널 사용을 명시해주세요. -갤럭시아 기준으로 작성한 예시 코드는 아래와 같습니다. +갤럭시아머니트리 기준으로 작성한 예시 코드는 아래와 같습니다. @@ -370,7 +375,7 @@ import Parameter from "~/components/parameter/Parameter"; PortOne.requestIssueBillingKey({ storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요. channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요. - billingKeyMethod: "CARD", // 갤럭시아의 경우 'CARD'만 지원됩니다. + billingKeyMethod: "CARD", // 갤럭시아머니트리의 경우 'CARD'만 지원됩니다. issueId: "test-issueId", issueName: "빌링키 발급", displayAmount: 1000, @@ -411,7 +416,7 @@ import Parameter from "~/components/parameter/Parameter"; **빌링키 발급수단** - 갤럭시아는 빌링키 발급 수단으로 카드만을 지원하므로 해당 파라미터는 `CARD`로 고정해야 합니다. + 갤럭시아머니트리는 빌링키 발급 수단으로 카드만을 지원하므로 해당 파라미터는 `CARD`로 고정해야 합니다. - issueId: string @@ -423,7 +428,7 @@ import Parameter from "~/components/parameter/Parameter"; **빌링키 발급 시 결제창에 표시되는 제목** - 갤럭시아의 경우 필수로 입력해야 합니다. + 갤럭시아머니트리의 경우 필수로 입력해야 합니다. - displayAmount?: number @@ -435,7 +440,7 @@ import Parameter from "~/components/parameter/Parameter"; **결제 통화** - 갤럭시아의 경우 `KRW`만 지원됩니다. + 갤럭시아머니트리의 경우 `KRW`만 지원됩니다. - customer: object @@ -446,7 +451,7 @@ import Parameter from "~/components/parameter/Parameter"; **구매자 고유 ID** - 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아의 경우 필수 입력입니다. + 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아머니트리의 경우 필수 입력입니다. - fullName?: string @@ -473,7 +478,7 @@ import Parameter from "~/components/parameter/Parameter"; **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL** - 갤럭시아의 경우 **모바일 환경에서 필수 입력**입니다. + 갤럭시아머니트리의 경우 **모바일 환경에서 필수 입력**입니다. - bypass: object @@ -482,20 +487,20 @@ import Parameter from "~/components/parameter/Parameter"; - galaxia: object - **갤럭시아 전용 파라미터** + **갤럭시아머니트리 전용 파라미터** - - ITEM_CODE: string + - ITEM\_CODE: string **구매 상품코드** - 갤럭시아에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**) + 갤럭시아머니트리에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**)
- 갤럭시아 지원 빌링키 발급 수단 + 갤럭시아머니트리 지원 빌링키 발급 수단 - CARD (카드) @@ -505,9 +510,9 @@ import Parameter from "~/components/parameter/Parameter"; ## SDK 빌링키 발급 및 결제 요청하기 빌링키 발급과 동시에 결제 요청 시에는 `requestIssueBillingKeyAndPay` 함수를 호출해야 합니다. -`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아 채널 사용을 명시해주세요. +`channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 갤럭시아머니트리 채널 사용을 명시해주세요. -갤럭시아 기준으로 작성한 예시 코드는 아래와 같습니다. +갤럭시아머니트리 기준으로 작성한 예시 코드는 아래와 같습니다. @@ -517,7 +522,7 @@ import Parameter from "~/components/parameter/Parameter"; PortOne.requestIssueBillingKeyAndPay({ storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요. channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요. - billingKeyAndPayMethod: "MOBILE", // 갤럭시아의 경우 'MOBILE'만 지원됩니다. + billingKeyAndPayMethod: "MOBILE", // 갤럭시아머니트리의 경우 'MOBILE'만 지원됩니다. paymentId: `payment${crypto.randomUUID()}`, orderName: "월간 이용권 정기결제", totalAmount: 1000, // 전달한 금액 만큼 실제로 승인이 됩니다. @@ -558,7 +563,7 @@ import Parameter from "~/components/parameter/Parameter"; **빌링키 발급 및 결제수단** - 갤럭시아의 경우, 빌링키 발급과 동시에 결제 수단은 `MOBILE`만 허용되며 **반드시 `MOBILE`을 필수로 입력해주셔야** 합니다. + 갤럭시아머니트리의 경우, 빌링키 발급과 동시에 결제 수단은 `MOBILE`만 허용되며 **반드시 `MOBILE`을 필수로 입력해주셔야** 합니다. - paymentId: string @@ -570,7 +575,7 @@ import Parameter from "~/components/parameter/Parameter"; **주문명** - 갤럭시아의 경우 필수로 입력해야 합니다. + 갤럭시아머니트리의 경우 필수로 입력해야 합니다. - totalAmount: number @@ -582,7 +587,7 @@ import Parameter from "~/components/parameter/Parameter"; **결제 통화** - 갤럭시아의 경우 `KRW`만 지원됩니다. + 갤럭시아머니트리의 경우 `KRW`만 지원됩니다. - customer: object @@ -593,7 +598,7 @@ import Parameter from "~/components/parameter/Parameter"; **구매자 고유 ID** - 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아의 경우 필수 입력이며 최대 20자까지 허용됩니다. + 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. 갤럭시아머니트리의 경우 필수 입력이며 최대 20자까지 허용됩니다. - fullName?: string @@ -620,7 +625,7 @@ import Parameter from "~/components/parameter/Parameter"; **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL** - 갤럭시아의 경우 **모바일 환경에서 필수 입력**입니다. + 갤럭시아머니트리의 경우 **모바일 환경에서 필수 입력**입니다. - mobile?: object @@ -641,20 +646,20 @@ import Parameter from "~/components/parameter/Parameter"; - galaxia: object - **갤럭시아 전용 파라미터** + **갤럭시아머니트리 전용 파라미터** - - ITEM_CODE: string + - ITEM\_CODE: string **구매 상품코드** - 갤럭시아에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**) + 갤럭시아머니트리에서 발급받은 상품 코드를 입력합니다. (최대 10자, **필수**)
- 갤럭시아 지원 빌링키 발급과 동시에 결제 수단 + 갤럭시아머니트리 지원 빌링키 발급과 동시에 결제 수단 - MOBILE (휴대폰소액결제) @@ -663,11 +668,11 @@ import Parameter from "~/components/parameter/Parameter"; ## 연동 유의사항 -### 갤럭시아 필수 파라미터 +### 갤럭시아머니트리 필수 파라미터 -갤럭시아 연동 시 아래 파라미터는 필수로 입력해야 합니다. +갤럭시아머니트리 연동 시 아래 파라미터는 필수로 입력해야 합니다. -- `bypass.galaxia.ITEM_CODE`: 갤럭시아에서 발급받은 상품 코드 (최대 10자) +- `bypass.galaxia.ITEM_CODE`: 갤럭시아머니트리에서 발급받은 상품 코드 (최대 10자) - `customer.customerId`: 고객사가 구매자에게 부여한 고유 ID (최대 20자) - `orderName`: 주문명 @@ -686,4 +691,4 @@ import Parameter from "~/components/parameter/Parameter"; ### 지원 통화 -갤럭시아는 `KRW`만 지원합니다. +갤럭시아머니트리는 `KRW`만 지원합니다. From 12d67e2a4dbff35fc05ac4d35cee14f5fc767377 Mon Sep 17 00:00:00 2001 From: youjmen Date: Tue, 13 Jan 2026 00:25:39 +0900 Subject: [PATCH 3/4] fix: remove currency prefix --- src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx index 7498341d5..24459b432 100644 --- a/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx +++ b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx @@ -57,7 +57,7 @@ import Parameter from "~/components/parameter/Parameter"; paymentId: `payment${crypto.randomUUID()}`, orderName: "나이키 와플 트레이너 2 SD", totalAmount: 1000, - currency: "CURRENCY_KRW", + currency: "KRW", payMethod: "CARD", customer: { customerId: "customer-1234", // 고객사가 구매자에게 부여한 고유 ID (필수) From 47dc7d08f9b637ab22dd6bcc5d73168de77f692f Mon Sep 17 00:00:00 2001 From: youjmen Date: Tue, 13 Jan 2026 00:27:31 +0900 Subject: [PATCH 4/4] feat: apply moneytree --- src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx index 24459b432..018893805 100644 --- a/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx +++ b/src/routes/(root)/opi/ko/integration/pg/v2/galaxia.mdx @@ -348,6 +348,7 @@ import Parameter from "~/components/parameter/Parameter"; - SAMSUNGPAY (삼성페이) - APPLEPAY (애플페이) - PAYCO (페이코) + - MONEYTREE (머니트리)