```ts title="Javascript SDK"
IMP.request_pay(
{
channelKey: "{콘솔 내 연동 정보의 채널키}",
pay_method: "card",
merchant_uid: "order_no_0001", // 상점에서 생성한 고유 주문번호
name: "주문명:결제테스트",
amount: 1004,
buyer_email: "test@portone.io",
buyer_name: "구매자이름",
buyer_tel: "010-1234-5678",
buyer_addr: "서울특별시 강남구 삼성동",
buyer_postcode: "123-456",
language: "en", // 결제창 언어 선택 파라미터 ko: 한국어, en: 영문
m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
niceMobileV2: true, // 신규 모바일 버전 적용 시 설정
},
function (rsp) {
// callback 로직
//* ...중략... *//
},
);
```
### 주요 파라미터 설명
- channelKey: string
**채널키**
결제를 진행할 채널을 지정합니다.
포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
(최신 JavaScript SDK 버전부터 사용 가능합니다.)
- pg(deprecated)?: string
**PG사 구분코드**
`nice` 로 지정하면 됩니다.
`pg` 파라미터는 지원 중단 예정입니다.
JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
- pay\_method: string
**결제수단 구분코드**
- card(신용카드)
- trans(실시간 계좌이체)
- vbank(가상계좌)
- phone(휴대폰소액결제)
- kakaopay(카카오페이)
- merchant\_uid: string
**주문번호**
매번 고유하게 채번되어야 합니다.
- name: string
**주문명**
- amount: number
**결제금액**
**string** 이 아닌점에 유의하세요
- buyer\_name?: string
**구매자 이름**
- buyer\_email?: string
**구매자 이메일**
- buyer\_tel?: string
**구매자 연락처**
- buyer\_addr?: string
**구매자 주소**
- buyer\_postcode?: string
**구매자 우편번호**
- tax\_free?: number
**면세금액**
- vat\_amount?: number
**부가세**
- vbank\_due?: string
**가상계좌 입금마감일시**
`YYYYMMDD` 또는 `YYYYMMDDHHmm` 형식으로 지정합니다. 미지정 시 기본 30일입니다.
- m\_redirect\_url?: string
**모바일 결제 후 리디렉션 될 URL**
- app\_scheme?: string
**모바일 앱 URL scheme** (모바일 전용)
모바일 앱에서 결제 시 ISP/앱카드 등에서 결제 완료 후 가맹점 앱으로 돌아올 때 사용됩니다.
- notice\_url?: string | string\[]
**웹훅 수신 URL**
포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
- confirm\_url?: string
**Confirm process URL**
- custom\_data?: object
**가맹점 커스텀 데이터**
결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
- niceMobileV2?: boolean
나이스 모바일 신규버전 적용 여부(기본 값: `false`)
- escrow?: boolean
**에스크로 설정여부**
- digital?: boolean
**디지털 컨텐츠 여부**
휴대폰 소액결제 시 디지털 컨텐츠(`true`)인지 실물 상품(`false`)인지 구분합니다.
- language?: string
**결제창 언어**
- `ko`: 한국어 (기본값)
- `en`: 영어
- `zh`: 중국어
- currency?: string
**결제 통화(기본 값: KRW)**
- KRW(한국 원)
- USD(미국 달러)
- period?: object
**서비스 제공기간**
고객이 구매하는 제품에 대한 제공기간을 명시합니다.
- from?: string
**시작일 (YYYYMMDD)**
- to?: string
**종료일 (YYYYMMDD)**
- interval?: string
**정기결제 간격**
`from`/`to` 대신 사용할 수 있습니다.
- `month`: 월간
- `year`: 연간
- appCard?: boolean
**앱카드 전용 모드**
`true` 설정 시 앱카드 결제만 활성화됩니다.
- bypass?: object
**나이스정보통신(구모듈) 전용 파라미터**
- CardShowOpt?: string
**카드사별 호출 방식** (모바일 전용, `niceMobileV2: true` 시에만 동작)
형식: `카드코드:노출유형|카드코드:노출유형`
**API 방식으로 빌링키 발급,결제요청,예약결제를 구현할수 있습니다.**
---
**일회성 결제 요청하기**
REST [**API POST /subscribe/payments/onetime**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fonetime)을 호출하여 일회성 결제를 요청합니다. 요청 시 전달된 카드는 포트원에 등록되지 않습니다.
```sh
curl -H "Content-Type: application/json" \
-X POST -d '{"merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \
https://api.iamport.kr/subscribe/payments/onetime
```
---
**빌링키 발급 요청하기**
REST [**API POST /subscribe/customers/{customer\_uid}**](https://developers.portone.io/api/rest-v1/billingkey?v=v1#post%20%2Fsubscribe%2Fcustomers%2F%7Bcustomer_uid%7D)를 호출하여 빌링키 발급을 요청합니다.
```sh
curl -H "Content-Type: application/json" \
-X POST -d '{"card_number":"1234-1234-1234-1234", "expiry":"2025-12", "birth":"820213", "pwd_2digit":"00"}' \
https://api.iamport.kr/subscribe/customers/your-customer-unique-id
```
---
**빌링키 발급 및 최초 결제 요청하기**
REST [**API POST /subscribe/payments/onetime**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fonetime)을 호출하여 빌링키 발급과 최초 결제를 요청합니다.
- **`customer_uid`** : 빌링키 등록을 위해서 지정해야 합니다.
```sh
curl -H "Content-Type: application/json" \
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \
https://api.iamport.kr/subscribe/payments/onetime
```
---
**빌링키로 결제 요청하기**
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다.
보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
```sh
curl -H "Content-Type: application/json" \
-X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "amount":3000}' \
https://api.iamport.kr/subscribe/payments/again
```
**나이스정보통신은 비인증 결제는 API 방식으로만 지원됩니다.**
비인증 결제를 연동하기 위해서는 카드정보를 획득할수 있는 UI를 구성해 주셔야 하며
해당 가이드는 [**비인증결제 연동하기**](https://developers.portone.io/opi/ko/integration/start/v1/non-auth)에서 확인해주시면 됩니다.