제휴사 결제창 직접 호출하기
1. 설명(Description)
- 본 문서는 나이스페이 인증결제 서비스 사용 시 나이스페이에서 제공하는 결제창을 생략하고 카드사 및 간편결제사의 인증창을 직접 호출하는 옵션에 대하여 설명합니다.
- 결제창 호출하기 문서를 참고하여 연동한 후, 본 문서에 명시된 파라미터들을 원하는 옵션에 맞게 값을 설정하여 결제창 호출 필수 파라미터(GoodsName, Amt, MID, SignData 등)와 함께 전송해야 합니다.
- 본 문서를 활용하여 직접 호출 옵션 사용 시 나이스페이 결제창이 생략되므로 가맹점 결제창에서 결제 약관 동의를 받도록 필수로 구현해야 합니다. 약관 내용 관련하여 확인이 필요한 경우 영업담당자를 통해 문의하시기 바랍니다.
2. 카드사 인증창 직접 호출 옵션
2.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| SelectCardCode | 2 | O | 카드사 코드 지정 옵션 |
| SelectQuota | 2 | O | 카드 할부개월 수 설정 (00: 일시불, 02: 2개월 할부, 03:3개월 할부, ...) |
| CardShowOpt | - | 카드사별 인증창 호출방식 옵션, 상세 내용은 아래 CardShowOpt 설정 방법 참고 | |
| DirectCardPointFlag | 1 | 카드사 포인트 사용 여부, (0(default): 포인트 미사용, 1: 포인트 사용) | |
| DirectCouponYN | 1 | 신용카드 선할인 쿠폰 자동 적용 여부, (Y: 자동 적용, N(default): 쿠폰 미적용) | |
| CardViewCl | 1 | 신용카드 인증창 호출 방식 옵션 (1: 팝업, 2: 레이어) |
CardShowOpt 설정 방법- 1: 안심클릭, 2: 간편결제, 3: 앱카드 직접호출
- 형식(Format): 카드코드:호출유형
- 예시: 02:3 (국민 앱카드 직접호출)
- 이용가능 카드사목록: 02(국민), 03(하나), 04(삼성), 06(신한), 07(현대), 08(롯데), 12(NH), 17(우리)
3. 삼성페이 직접 호출 옵션
3.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 또는 CELLPHONE |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 또는 CELLPHONE |
| DirectEasyPay | 4 | 카드 간편결제 제휴사 호출 옵션, 삼성페이 카드 결제 시 E021 입력 | |
| DirectEasyHpp | 4 | 휴대폰 간편결제 제휴사 호출 옵션, 삼성페이 휴대폰 결제 시 E021 입력 | |
| NicepayReserved | - | 나이스페이 복합옵션, key=value 형태로 나열해야 하며 상세 내용은 하위 옵션 설명 참고. |
NicepayReserved 하위 옵션
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| SamPayShopInt | 1 | 삼성페이 가맹점 분담 무이자 사용 여부 (0: 미사용, 1: 사용) | |
| SamPayQuotaInt | - | 삼성페이 가맹점 분담 무이자 카드, 할부개월 정보 설정. 아래 SamPayQuotaInt 설정 방법 참고. | |
| SamPayMallType | 2 | 삼성페이 가맹점 유형 (01: 삼성페이 내 쇼핑, 99(defalut): 기타) |
SamPayQuotaInt 설정 방법- SamPayShopInt를
1로 설정 시에만 사용 가능. - , 를 구분자로 하여 할부개월 나열
- : 를 구분자로 하여 카드코드와 할부개월 구분
- ^ 를 구분자로 하여 "카드코드:할부개월" 세트를 구분 및 나열
- 형식(Format): 카드코드:할부개월,할부개월^카드코드:할부개월,할부개월^...
3.2. 사용 예시
- 삼성페이(카드) 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E021" />
- 삼성페이(카드) 직접 호출 옵션 및 삼성페이 가맹점 분담 무이자 사용(BC카드 6-7개월, 국민카드 6-8개월) 설정
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E021" />
<input type="hidden" name="NicepayReserved" value="SamPayShopInt=1|SamPayQuotaInt=01:06,07^02:06,07,08" />
- 삼성페이(휴대폰) 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CELLPHONE" />
<input type="hidden" name="DirectShowOpt" value="CELLPHONE" />
<input type="hidden" name="DirectEasyHpp" value="E021" />
4. 카카오페이 직접 호출 옵션
4.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, E016 입력 |
| EasyPayCardCode | 2 | 간편결제 시 사용할 카드사 코드 설정 옵션 | |
| EasyPayQuota | 2 | 간편결제 시 할부개월 수 설정. 단독 설정 불가하며, 반드시 EasyPayCardCode와 함께 사용해야 함. (일시불: 00, 2개월: 02, 3개월: 03, ...) |
4.2. 사용 예시
- 카카오페이 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E016" />
- 카카오페이 직접 호출 옵션 및 삼성카드-3개월 할부 설정
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E016" />
<input type="hidden" name="EasyPayCardCode" value="04" />
<input type="hidden" name="EasyPayQuota" value="03" />
5. 페이코 직접 호출 옵션
5.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, 페이코 결제 시 E015 입력 |
| EasyPayShopInterest | - | 간편결제 가맹점 분담 무이자 사용 여부. 페이코 사용 시 E015=1 설정 | |
| EasyPayQuotaInterest | - | 간편결제 가맹점 분담 무이자 카드, 할부개월 정보 설정. 카드코드:할부개월 형식, 아래 EasyPayQuotaInterest 설정 방법 참고. | |
| MultiEasyPayQuota | - | 간편결제 다중 할부개월 설정 옵션. 단독으로 설정 가능하며, 다중 할부개월 설정 시 , 를 구분자로 사용. (예시:00,03,04,05 -> 일시불,3-5개월 할부만 가능하도록 함) | |
| PaycoClientId | - | 페이코 자동 로그인 연동 시 사용하는 Client ID | |
| PaycoAccessToken | - | 페이코 자동 로그인 연동 시 사용하는 Access Token |
페이코
EasyPayQuotaInterest 설정 방법- EasyPayShopInterest를
E015=1로 설정 시에만 사용 가능 - , 를 구분자로 하여 할부개월 나열
- : 를 구분자로 하여 카드코드와 할부개월 구분
- ^ 를 구분자로 하여 "카드코드:할부개월" 세트를 구분 및 나열
- 형식(Format): 카드코드:할부개월,할부개월^카드코드:할부개월,할부개월^...
5.2. 사용 예시
- 페이코 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E015" />
6. SK페이 직접 호출 옵션
6.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, SK페이 결제 시 E006 입력 |
| NicepayReserved | - | 나이스페이 복합옵션, key=value 형태로 나열해야 하며 상세 내용은 하위 옵션 설명 참고. |
NicepayReserved 하위 옵션
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| Pay11ShopInt | 1 | SK페이 가맹점 분담 무이자 사용 여부. (0: 미사용, 1: 사용) | |
| Pay11QuotaInt | - | SK페이 가맹점 분담 무이자 카드, 할부개월 정보 설정. 아래 Pay11QuotaInt 설정 방법 참고. |
Pay11QuotaInt 설정 방법- Pay11ShopInt를
1로 설정 시에만 사용 가능. - , 를 구분자로 하여 할부개월 나열
- : 를 구분자로 하여 카드코드와 할부개월 구분
- ^ 를 구분자로 하여 "카드코드:할부개월" 세트를 구분 및 나열
- 형식(Format): 카드코드:할부개월,할부개월^카드코드:할부개월,할부개월^...
6.2. 사용 예시
- SK페이 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E006" />
- SK페이 직접 호출 옵션 및 SK페이 가맹점 분담 무이자 사용(BC카드 4,5개월, 국민카드 6-8개월) 설정
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E006" />
<input type="hidden" name="NicepayReserved" value="Pay11ShopInt=1|Pay11QuotaInt=01:04,05^02:06,07,08" />
7. 네이버페이 직접 호출 옵션
7.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, 네이버페이 결제 시 E020 입력 |
| EasyPayMethod | - | O | 네이버페이 결제수단 지정 옵션. 카드 결제 시 E020=CARD, 포인트 결제 시 E020=POINT 입력 |
| EasyPayCardCode | 2 | 간편결제 시 사용할 카드사 코드 설정 옵션 | |
| EasyPayQuota | 2 | 간편결제 시 할부개월 수 설정. 단독 설정 불가하며, 반드시 EasyPayCardCode와 함께 사용해야 함. (일시불: 00, 2개월: 02, 3개월: 03, ...) | |
| MultiEasyPayQuota | - | 간편결제 다중 할부개월 설정 옵션. 단독으로 설정 가능하며, 다중 할부개월 설정 시 , 를 구분자로 사용. (예시:00,03,04,05 -> 일시불,3-5개월 할부만 가능하도록 함) | |
| NicepayReserved | - | 나이스페이 복합옵션, key=value 형태로 나열해야 하며 상세 내용은 하위 옵션 설명 참고. |
NicepayReserved 하위 옵션
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| DirectRcptType | 1 | 현금영수증 발급 유형 (0(default): 미발행, 1: 소득공제, 2: 지출증빙) | |
| DirectRcptNo | 11 | 현금영수증 발급 번호 (휴대폰번호 10,11자리 또는 사업자번호 10자리) | |
| DirectRcptNoType | 10 | 현금영수증 발급번호 유형 (HPP: 휴대폰, COMP_NO: 사업자번호) |
네이버페이 직접 호출 옵션 사용 시 주의사항
- 네이버페이 결제 시 카드와 포인트를 같이 사용하는 복합결제 형태의 결제가 불가합니다.
- EasyPayQuota 파라미터와 MultiEasyPayQuota 파라미터를 함께 사용하는 경우, EasyPayQuota 파라미터만 적용됩니다. (우선순위: EasyPayQuota > MultiEasyPayQuota)
- 할부개월 다중 옵션 사용 시 토스페이 측 정책으로 일시불이 포함되어 노출되는 점 참고 바랍니다.
- 예시:
MultiEasyPayQuota=03,04설정 시 일시불, 3개월, 4개월 노출
7.2. 사용 예시
- 네이버페이 카드 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E020" />
<input type="hidden" name="EasyPayMethod" value="E020=CARD" />
- 네이버페이 포인트 직접 호출 옵션 및 현금영수증 소득공제 발급 요청
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E020" />
<input type="hidden" name="EasyPayMethod" value="E020=POINT" />
<input type="hidden" name="NicepayReserved" value="DirectRcptType=1|DirectRcptNo=01012345678|DirectRcptNoType=HPP" />
8. 토스페이 직접 호출 옵션
8.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, 토스페이 결제 시 E025 입력 |
| EasyPayMethod | - | 토스페이 결제수단 지정 옵션. 카드 결제 시 E025=CARD, 토스머니 결제 시 E025=MONEY 입력. 미입력 시 토스페이 화면에서 카드 또는 토스머니 선택 | |
| EasyPayCardCode | 2 | 간편결제 시 사용할 카드사 코드 설정 옵션 | |
| EasyPayQuota | 2 | 간편결제 시 할부개월 수 설정. 단독 설정 불가하며, 반드시 EasyPayCardCode와 함께 사용해야 함. (일시불: 00, 2개월: 02, 3개월: 03, ...) | |
| MultiEasyPayQuota | - | 간편결제 다중 할부개월 설정 옵션. 단독으로 설정 가능하며, 다중 할부개월 설정 시 , 를 구분자로 사용. (예시:00,03,04,05 -> 일시불,3-5개월 할부만 가능하도록 함) |
토스페이 직접 호출 옵션 사용 시 주의사항
- 토스페이 결제 시 카드와 토스머니를 같이 사용하는 복합결제 형태의 결제가 불가합니다.
- EasyPayQuota 파라미터와 MultiEasyPayQuota 파라미터를 함께 사용하는 경우, EasyPayQuota 파라미터만 적용됩니다. (우선순위: EasyPayQuota > MultiEasyPayQuota)
- 할부개월 다중 옵션 사용 시 토스페이 측 정책으로 일시불이 포함되어 노출되는 점 참고 바랍니다.
- 예시:
MultiEasyPayQuota=03,04설정 시 일시불, 3개월, 4개월 노출
8.2. 사용 예시
- 토스페이 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E025" />
- 토스페이 카드 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E025" />
<input type="hidden" name="EasyPayMethod" value="E025=CARD" />
9. 로켓페이 직접 호출 옵션
9.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, 로켓페이 결제 시 E028 입력 |
| EasyPayMethod | - | 토스페이 결제수단 지정 옵션. 카드 결제 시 E028=CARD, 쿠팡캐시/머니 결제 시 E028=MONEY 입력. 미입력 시 로켓페이 화면에서 카드 또는 쿠팡캐시/머니 선택 | |
| EasyPayCardCode | 2 | 간편결제 시 사용할 카드사 코드 설정 옵션 | |
| EasyPayQuota | 2 | 간편결제 시 할부개월 수 설정. 단독 설정 불가하며, 반드시 EasyPayCardCode와 함께 사용해야 함. (일시불: 00, 2개월: 02, 3개월: 03, ...) | |
| EasyPayShopInterest | - | 간편결제 가맹점 분담 무이자 사용 여부. 로켓페이 사용 시 E028=1 설정 | |
| EasyPayQuotaInterest | - | 간편결제 가맹점 분담 무이자 카드, 할부개월 정보 설정. 카드코드:할부개월 형식, 아래 EasyPayQuotaInterest 설정 방법 참고. |
로켓페이
EasyPayQuotaInterest 설정 방법- EasyPayShopInterest를
E028=1로 설정 시에만 사용 가능 - , 를 구분자로 하여 할부개월 나열
- : 를 구분자로 하여 카드코드와 할부개월 구분
- ^ 를 구분자로 하여 "카드코드:할부개월" 세트를 구분 및 나열
- 형식(Format): 카드코드:할부개월,할부개월^카드코드:할부개월,할부개월^...
9.2. 사용 예시
- 로켓페이 카드 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E028" />
<input type="hidden" name="EasyPayMethod" value="E028=CARD" />
- 로켓페이 쿠팡캐시/머니 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E028" />
<input type="hidden" name="EasyPayMethod" value="E028=MONEY" />
10. 애플페이 직접 호출 옵션
10.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, 애플페이 결제 시 E022 입력 |
10.2. 사용 예시
- 애플페이 카드 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E022" />
11. 쓱페이(SSGPAY) 직접 호출 옵션
11.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, 쓱페이 결제 시 E007 입력 |
11.2. 사용 예시
- 쓱페이 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E007" />
12. 엘페이(LPAY) 직접 호출 옵션
12.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, CARD 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, CARD 고정 |
| DirectEasyPay | 4 | O | 카드 간편결제 제휴사 호출 옵션, 엘페이 결제 시 E018 입력 |
12.2. 사용 예시
- 엘페이 직접 호출 옵션
<input type="hidden" name="PayMethod" value="CARD" />
<input type="hidden" name="DirectShowOpt" value="CARD" />
<input type="hidden" name="DirectEasyPay" value="E018" />
13. 케이뱅크페이 직접 호출 옵션
13.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, BANK 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, BANK 고정 |
| DirectEasyBank | 4 | O | 계좌 간편결제 제휴사 호출 옵션, 케이뱅크페이 결제 시 E023 입력 |
13.2. 사용 예시
- 케이뱅크페이 직접 호출 옵션
<input type="hidden" name="PayMethod" value="BANK" />
<input type="hidden" name="DirectShowOpt" value="BANK" />
<input type="hidden" name="DirectEasyBank" value="E023" />
14. NICE계좌이체 직접 호출 옵션
14.1. 옵션 파라미터
| 필드명 | 크기(byte) | 필수 | 설명 |
|---|---|---|---|
| PayMethod | 10 | O | 결제 수단, BANK 고정 |
| DirectShowOpt | 100 | O | 직접 호출 결제수단 옵션, BANK 고정 |
| DirectEasyBank | 4 | O | 계좌 간편결제 제휴사 호출 옵션, NICE계좌이체 결제 시 E027 입력 |
14.2. 사용 예시
- NICE계좌이체 직접 호출 옵션
<input type="hidden" name="PayMethod" value="BANK" />
<input type="hidden" name="DirectShowOpt" value="BANK" />
<input type="hidden" name="DirectEasyBank" value="E027" />