```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: 10,
currency: "CURRENCY_JPY",
payMethod: "CARD",
customer: {
fullName: "matt",
firstNameKana: "マット",
lastNameKana: "デイモン",
phoneNumber: "01012341234",
email: "test@portone.io",
},
storeDetails: {
storeName: "韓国ストア",
storeNameShort: "ストア",
storeNameEn: "Kankoku Store",
storeNameKana: "カンコクストア",
contactName: "contact",
email: "store@portone.io",
phoneNumber: "3712345678",
openingHours: {
open: "00:00",
close: "23:00",
},
},
});
}
```
### 주요 파라미터
- storeId: string
**상점 아이디**
포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
- paymentId: string
**고객사 주문 고유 번호**
고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다. 이미 승인 완료된 `paymentId`로 결제를 시도하는 경우 에러가 발생합니다.
- orderName: string
**주문명**
주문명으로 고객사에서 자유롭게 입력합니다.
- channelKey: string
**채널 키**
포트원 콘솔 내 \[결제연동] > \[채널관리] 화면에서 채널 추가 시 생성되는 값입니다. 결제 호출 시 채널을 지정할 때 사용됩니다.
- totalAmount: number
**결제 금액**
결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
- currency: string
**결제 통화**
결제통화로 엔화 결제만 허용하며 `CURRENCY_JPY`로 입력해야 합니다.
- payMethod: string
**결제수단 구분코드**
결제 호출 시 결제수단을 지정할 때 사용됩니다.
- 신용카드 : `CARD`
- 편의점 결제 : `CONVENIENCE_STORE`
- 간편 결제 : `EASY_PAY`
- card?: object
**카드 결제 시 파라미터**
- installment?: object
**할부 개월 수 설정**
- monthOption?: object
**할부 개월 수 설정**
- fixedMonth?: integer
**고정 할부 개월 수**
0을 입력한 경우 일시불만 표시됩니다.
- availableMonthList?: integer\[]
**렌더링을 허용 할 할부 개월 수 리스트**
목록에 0이 포함되어 있는 경우 일시불도 표시됩니다.
목록에 0만 있는 경우 일시불만 표시됩니다.
- convenienceStore?: object
**편의점 결제 시 파라미터**
- paymentDeadline: object
**지불 기한**
- validHours?: integer
**유효 시간**
- dueDate?: string
**만료 시점**
시간은 ISO8601 형식으로 입력해야 합니다.
- easyPay?: object
**간편 결제 시 파라미터**
- easyPayProvider: string
**간편 결제 수단**
- customer?: object
**고객 정보**
- customerId?: string
**구매자 ID**
CBT 유형이 SBPS인 경우 필수 입력이며 최대 30자로 설정해야합니다.
- fullName?: string
**구매자 전체 이름**
- 이니시스 일본결제의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
- firstName?: string
**구매자 이름**
- 이니시스 일본결제의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
- lastName?: string
**구매자 성**
- 이니시스 일본결제의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
- firstNameKana?: string
**구매자 이름 (후리가나)**
- 편의점 결제의 경우 firstNameKana + lastNameKana를 필수로 입력해야 합니다.
- lastNameKana?: string
**구매자 성 (후리가나)**
- 편의점 결제의 경우 firstNameKana + lastNameKana를 필수로 입력해야 합니다.
- phoneNumber?: string
**구매자 연락처**
- email?: string
**구매자 이메일**
- storeDetails?: object
**상점 정보(가맹점 정보)**
- storeName?: string
**상점명**
CBT 유형이 JPPG인 경우 필수 입력입니다.
- storeNameKana?: string
**상점명 (후리가나)**
CBT 유형이 JPPG인 경우 필수 입력입니다.
가타카나만 허용합니다.
- storeNameEn?: string
**상점명 (영문)**
CBT 유형이 JPPG인 경우 필수 입력입니다.
알파벳만 허용합니다.
- storeNameShort?: string
**상점명 (약어)**
CBT 유형이 JPPG인 경우 필수 입력입니다.
- contactName?: string
**상점 연락처 정보 이름**
CBT 유형이 JPPG인 경우 필수 입력입니다.
- email?: string
**상점 이메일**
CBT 유형이 JPPG인 경우 필수 입력입니다.
- phoneNumber?: string
**상점 연락처**
CBT 유형이 JPPG인 경우 필수 입력입니다.
- openingHours?: object
**상점 영업시간**
CBT 유형이 JPPG인 경우 필수 입력입니다.
- open?: string
**영업 시작 시간**
HH:mm 포맷으로 입력해야하며 00:00\~23:59 범위의 값만 허용합니다.
- close?: string
**영업 종료 시간**
HH:mm 포맷으로 입력해야하며 00:00\~23:59 범위의 값만 허용합니다.
- bypass?: oneof object
**PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
- inicis\_jp?: InicisJp
[definition link](https://developers.portone.io/schema/browser-sdk.yml#/resources/entity/bypass/payment/InicisJp)
### 유의사항
#### 공통