```ts title="JavaScript SDK"
IMP.request_pay(
{
channelKey: "{콘솔 내 연동 정보의 채널키}",
pay_method: "card",
merchant_uid: "order_id_1667634130160", // 상점에서 채번하는 고유 주문 번호
name: "나이키 와플 트레이너 2 SD",
pay_method: "card",
escrow: false,
amount: 109000,
tax_free: 3000,
buyer_name: "홍길동",
buyer_email: "buyer@example.com",
buyer_tel: "02-1670-5176",
buyer_addr: "성수이로 20길 16",
buyer_postcode: "04783",
app_scheme: "portone://",
m_redirect_url: "https://helloworld.com/payments/result",
notice_url: "https://helloworld.com/api/v1/payments/notice",
confirm_url: "https://helloworld.com/api/v1/payments/confirm",
currency: "KRW",
digital: false,
period: {
from: "2022-12-01",
to: "2023-01-01",
},
custom_data: { userId: 30930 },
display: { card_quota: [0, 6] },
bypass: {
ksnet: {
sndQpayType: "0",
},
},
},
function (rsp) {
// callback 로직
//* ...중략... *//
},
);
```
**주요 파라미터 설명**
- channelKey: string
**채널키**
결제를 진행할 채널을 지정합니다.
포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
(최신 JavaScript SDK 버전부터 사용 가능합니다.)
- pg(deprecated)?: string
**PG사 구분코드**
`ksnet.{PG 상점 아이디}`
`pg` 파라미터는 지원 중단 예정입니다.
JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
- pay\_method: string
**결제수단 구분코드**
- card (신용카드)
- vbank (가상계좌)
- trans (계좌이체)
- phone (휴대폰소액결제)
- lpay (LPAY)
- ssgpay (SSGPAY)
- kakaopay (카카오페이)
- naverpay (네이버페이)
- payco (페이코)
- merchant\_uid: string
**고객사 채번 주문 고유번호**
고객사에서 매번 고유하게 채번되어야 합니다.
- amount: number
**결제금액**
지정하지 않은 경우 0원입니다.
- tax\_free?: number
**면세금액**
지정하지 않은 경우 0원입니다.
포트원을 통해 KSNET를 사용하는 경우 과세 설정이 `복합과세`이므로 면세금액을 반드시 입력해야 합니다.
- buyer\_name: string
**구매자명**
- buyer\_email?: string
**구매자 이메일**
- buyer\_tel?: string
**구매자 전화번호**
- buyer\_addr?: string
**구매자 주소**
- buyer\_postcode?: string
**구매자 우편번호**
- currency: string
**결제 통화**
결제통화로 KSNET 카드 다이렉트의 경우 `KRW` 만 허용됩니다.
- digital?: boolean
**디지털 상품 유형 여부**
해당 필드는 **휴대폰 결제**에서만 사용되며, 상점이 `디지털 상품유형`으로 설정된 경우 항상 `true`로 전달해야 합니다.
- appCard?: boolean
**카드 결제시, 카드 결제창에 앱카드만 선택 가능하도록 할지 여부 (기본값: **false**)**
- useFreeInterestFromMall?: boolean
**상점 부담 무이자 할부 사용 여부**
고객사가 부담하는 무이자 할부 여부를 설정 할 수 있습니다.
- display?: object
**결제창에 렌더링될 카드 할부 개월수 리스트 설정**
- card\_quota?: number\[]
**할부 개월수 설정**
`[0]` : 일시불
`[2,3,4]` : 2,3,4 개월
- card?: object
**카드 결제시 세부 설정 정보**
- direct?: object
**카드사 다이렉트 호출시 설정 정보**
- code?: string
**카드사 코드**
- storeDetails?: object
**상점 세부 정보**
- businessName?: string
**상점 사업자 명**
- businessRegistrationNumber?: string
**상점 사업자 번호**
- 하이픈(-) 을 제외한, 숫자만 전달하여야합니다.
- bypass?: oneof object
**PG사 결제창 호출 시 PG사 그대로 bypass할 값들의 모음**
- ksnet?: string
**KSNET 전용 파라미터**
- sndQpayType?: string
**카드 결제 시 결제창에 간편 결제 수단 표시 여부**
0 : 간편결제 수단 표시하지 않음 / 1 : 간편결제 수단 표시함
- tcode?: string
**통신사 구분**
통신사에 따라 LG는 `lgt`, KT는 `ktf`, SKT는 `skt`로 입력해야 하며, 통신사 구분이 어려우신 경우
임의의 값을 입력하여 요청해도 무방합니다.
- url?: string
**고객사 url**
- 결제를 요청하는 사이트의 url을 입력하여야 합니다.
- sndKakaopayType?: string
**카카오페이 결제시 허용할 결제수단**
- `CARD`: 카드 결제만 허용
- `MONEY`: 카카오머니 결제만 허용
- 미입력시 모든 결제수단 허용
### 일회성 결제 요청하기
REST [**API POST /subscribe/payments/onetime**](https://developers.portone.io/api/rest-v1/nonAuthPayment#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#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
```
### 빌링키로 결제 요청하기
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다.
보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment#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, "product_type": "digital"}' \
https://api.iamport.kr/subscribe/payments/again
```